---
title: "Create a profile with a URL - Cloud"
canonical: "https://support.appfire.com/space/MARKDOWN/72384893/Create%20a%20profile%20with%20a%20URL%20-%20Cloud"
format: markdown
---
> Macro (aura-html)

> ❌ **Removal notice (applicable for Markdown from a URL macro):**
> ❌ 
> ❌ Please note that the URL user and URL user password parameters were removed (see [Deprecation notice: URL user and URL user password parameters](https://bobswift.atlassian.net/wiki/spaces/info/pages/2537850172/Deprecation+notice%3A+URL+user+and+URL+user+password+parameters)). We recommend using [<span style="color: #000000">profiles</span>](https://appfire.atlassian.net/wiki/x/y4JQB#Configuration-Cloud-Profiles)<span style="color: #000000"> </span>to access external data.

# <span style="color: #000000">Description</span>

<span style="color: #000000">This article illustrates how to create a profile in the </span>*<span style="color: #000000">Markdown from a URL</span>*<span style="color: #000000"> macro using a URL. </span>

> ℹ️ ## <span style="color: #000000">Before you begin:</span>
> ℹ️ 
> ℹ️ - <span style="color: #000000">Before you enter the URL for a repository, ensure that it </span><span style="color: #000000">is a raw URL</span>.  
> ℹ️ <span style="color: #000000">A raw URL is defined as the part of the URL following the domain information and </span><span style="color: #000000">includes the query string, if present. </span><span style="color: #000000">For example, in the URL string </span>*<span style="color: #000000">http://www.contoso.com/articles/recent.aspx</span>*<span style="color: #000000">, the raw URL is </span>*<span style="color: #000000">/articles/recent.aspx</span>*<span style="color: #000000">. </span>
> ℹ️ - <span style="color: #000000">Know what is a complete URL. </span>
> ℹ️   - <span style="color: #000000">A typical path for the raw file on GitLab looks like:</span>  
> ℹ️ *<span style="color: #000000">/projects/:id/repository/files/:file_path/raw</span>*
> ℹ️   - <span style="color: #000000">Since the host address begins with:</span>  
> ℹ️ <span style="color: #000000">*https://gitlab.com/api/v4*</span>
> ℹ️   - The <span style="color: #000000">complete URL, in this example, looks like: </span>  
> ℹ️ <span style="color: #000000">*https://gitlab.com/api/v4/projects/:id/repository/files/:file_path/raw?ref=master*</span>
> ℹ️ - <span style="color: #000000">For illustrative purposes, a public</span> <span style="color: #000000">Bitbucket public repository is used</span>. <span style="color: #000000">Use URLs to add to profiles and in macros as per your requirement and your instance.</span><span style="color: #333333"> </span><span style="color: #000000">The process for adding a profile and using it in macros remains the same for other repositories and external sources. </span>

<span style="color: #000000">There are three ways to work with URLs where you can use:</span>

- <span style="color: #000000">An </span>[<span style="color: #000000">absolute URL</span>](#CreateaprofilewithaURL-Cloud-MD_Cld_HowTo_CompleteURL)<span style="color: #000000"> in a profile</span>
- <span style="color: #000000">A </span>[<span style="color: #000000">partial URL</span>](#CreateaprofilewithaURL-Cloud-MD_Cld_HowTo_FixedURL)<span style="color: #000000"> in a profile</span>
- <span style="color: #000000">An </span>[<span style="color: #000000">absolute URL directly</span>](#CreateaprofilewithaURL-Cloud-MD_Cld_HowTo_AbsoluteURL)<span style="color: #000000"> instead of via a profile </span>

# > Macro (anchor)

<span style="color: #000000">Using an absolute URL in a profile</span>

<span style="color: #000000">You can create a profile by providing the complete URL for the Markdown content.</span>

1. <span style="color: #000000">Navigate</span><span style="color: #000000"> to </span>**<span style="color: #000000">CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > </span>****<span style="color: #000000">Markdown Configuration > Profiles</span>**<span style="color: #000000">.</span>
2. <span style="color: #000000">Click </span>**<span style="color: #000000">Add Profile.</span>**
3. <span style="color: #000000">Enter a unique name for the profile in the </span>*<span style="color: #000000">Profile name</span>*<span style="color: #000000"> text box.</span>
4. <span style="color: #000000">Select </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> from the options in </span>*<span style="color: #000000">Profile type</span>*<span style="color: #000000">. </span>
5. <span style="color: #000000">Enter the complete path of the required Markdown file (for example:</span> <span style="color: #000000">*https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md*</span><span style="color: #000000">)</span> <span style="color: #000000">in the </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> text box. </span>
6. <span style="color: #000000">Click </span>**<span style="color: #000000">Save profile</span>**<span style="color: #000000"> to create the profile.</span>  
> Macro (inline-media-image)

<span style="color: #000000">To use this profile in a Confluence page:</span>

1. <span style="color: #000000">Select the required </span>*<span style="color: #000000">Markdown from a URL</span>*<span style="color: #000000"> macro and edit it.</span>
2. <span style="color: #000000">Select</span>**<span style="color: #000000"> </span>**<span style="color: #000000">the profile with the absolute path of the Markdown file from the </span>*<span style="color: #000000">Profile</span>*<span style="color: #000000"> list and then, click </span>**<span style="color: #000000">Save</span>**<span style="color: #000000">.</span>

![image](media://dda5f158-fc02-4b2a-bd4b-8378f3dcdc12)

# > Macro (anchor)

<span style="color: #000000">Using a partial URL in a profile</span>

<span style="color: #000000">You can create a profile by providing a partial URL for the Markdown content and entering relative path to the Markdown file in the </span>*<span style="color: #000000">Markdown from a URL</span>*<span style="color: #000000"> macro.</span>

1. <span style="color: #000000">Navigate to </span>**<span style="color: #000000">CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > </span>****<span style="color: #000000">Markdown Configuration > Profiles</span>**<span style="color: #000000">.</span>
2. <span style="color: #000000">Click </span>**<span style="color: #000000">Add Profile.</span>**
3. <span style="color: #000000">Enter a unique name for the profile in the </span>*<span style="color: #000000">Profile name</span>*<span style="color: #000000"> text box.</span>
4. <span style="color: #000000">Select </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> from the options in </span>*<span style="color: #000000">Profile type</span>*<span style="color: #000000">. </span>
5. <span style="color: #000000">Enter the base URL (for example:</span> <span style="color: #000000">*https://bitbucket.org*</span><span style="color: #000000">)</span> <span style="color: #000000">in the </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> text box.</span>
6. <span style="color: #000000">Click </span>**<span style="color: #000000">Save profile </span>**to create the profile.

![image](media://1d3f8393-3242-4375-a333-1b00ce80a8f6)

<span style="color: #000000">To use this profile in a Confluence page:</span>

1. <span style="color: #000000">Select the required </span>*<span style="color: #000000">Markdown from a URL</span>*<span style="color: #000000"> macro and edit it.</span>
2. <span style="color: #000000">Select</span>**<span style="color: #000000"> </span>**<span style="color: #000000">the profile with the base URL of the required Markdown file from the </span>*<span style="color: #000000">Profile</span>*<span style="color: #000000"> list in the editor.</span>
3. <span style="color: #000000">Enter the relative path to the</span> <span style="color: #000000">Markdown file (for example: </span>*<span style="color: #000000">/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md</span>*<span style="color: #000000">) in the </span>*<span style="color: #000000">URL to markdown file</span>*<span style="color: #000000"> parameter.</span>
4. <span style="color: #000000">Click</span> <span style="color: #000000">**Save**</span><span style="color: #000000">.</span>

![image](media://07930f22-4f13-42e8-b962-ce4b0f382c1f)

> ℹ️ <span style="color: #000000">This method allows multiple users to access a profile across pages and instances of the </span>*<span style="color: #000000">markdown-url</span>*<span style="color: #000000"> macro.</span>

# > Macro (anchor)

<span style="color: #000000">Using an absolute URL directly</span>

<span style="color: #000000">You can skip creating a profile and enter the absolute URL in the </span>*<span style="color: #000000">URL to markdown file</span>*<span style="color: #000000"> parameter.</span>

1. <span style="color: #000000">In a Confluence page, s</span><span style="color: #000000">earch for the </span>*<span style="color: #000000">Markdown from a URL</span>*<span style="color: #000000"> macro and edit it.</span>
2. <span style="color: #000000">Enter the complete path of the required Markdown file (for example:</span> <span style="color: #000000">*https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md*</span>) <span style="color: #000000">in the the </span>*<span style="color: #000000">URL to markdown</span>*<span style="color: #000000"> </span>*<span style="color: #000000">file</span>*<span style="color: #000000"> parameter.</span>
3. <span style="color: #000000">Click </span>**<span style="color: #000000">Save.</span>**

![image](media://6caeecc5-d883-4ab4-b380-a5306b52e3ec)