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

> ❌ **Removal notice:**
> ❌ 
> ❌ Please note that the URL user and URL user password parameters were removed in 5.8.5 (see [Deprecation notice: URL user and URL user password parameters](https://appfire.atlassian.net/wiki/spaces/info/pages/86083883)). We recommend using [profiles](https://appfire.atlassian.net/wiki/x/l4E1B#Configuration-html_57_config_profiles) to access external data.

<span style="color: #000000">This article illustrates how to </span><span style="color: #000000">create a profile using a URL to be used with any of the </span><span style="color: #000000">*HTML for Confluence*</span><span style="color: #000000"> macros</span><span style="color: #000000">.</span>

> ℹ️ <span style="color: #000000">*Before you begin:*</span>
> ℹ️ 
> ℹ️ - <span style="color: #000000">Before you enter the URL for a repository, ensure that it 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 includes the query string, if present. For example, in the URL string </span>`http://www.contoso.com/articles/recent.aspx`<span style="color: #000000">, the raw URL is </span>`/articles/recent.aspx`<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 Bitbucket looks like:</span>  
> ℹ️ <span style="color: #000000">*/projects/:id/repository/files/:file_path/raw*</span>
> ℹ️   - <span style="color: #000000">The host address (base URL) begins with:</span>  
> ℹ️ <span style="color: #000000">*https://bitbucket.workspace.com*</span>
> ℹ️   - <span style="color: #000000">The complete URL, in this example,</span> looks like:   
> ℹ️ <span style="color: #000000">*https://bitbucket.workspace.com/projects/:id/repository/files/:file_path/raw?ref=master*</span>
> ℹ️ - <span style="color: #000000">For illustrative purposes, we have used a public</span> <span style="color: #000000">Bitbucket repository. Use URLs to add to profiles and in macros as per your requirement and your instance.</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 two ways to work with URLs where you can use:</span>

- <span style="color: #000000">An</span><span style="color: #000000"> </span><span style="color: #000000">[absolute URL](#CreateaprofilewithaURL-html_57_HowTo_CompleteURL)</span><span style="color: #000000"> in a profile</span>
- <span style="color: #000000">A </span><span style="color: #000000">[partial URL](#CreateaprofilewithaURL-html_57_HowTo_FixedURL)</span><span style="color: #000000"> in a profile</span>

> ℹ️ <span style="color: #000000">For this example, let's use the </span><span style="color: #000000">*Html-bobswift*</span><span style="color: #000000"> macro to illustrate profile creation and usage. The screenshots illustrate where the relevant parameters are to be given. Specify information in the profile window and macro editor as per your requirement in your instance.</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 in the macro editor.</span>

1. <span style="color: #000000">Select </span>> Macro (inline-media-image)

<span style="color: #000000"> ></span><span style="color: #000000">** Manage apps**</span><span style="color: #000000">, either search for </span><span style="color: #000000">*HTML for Confluence*</span><span style="color: #000000"> or scroll to </span><span style="color: #000000">*Bob Swift Configuration,*</span><span style="color: #000000"> and click </span><span style="color: #000000">*HTML*</span><span style="color: #000000"> to view app configuration.</span>

> ✅ *Try this for older Confluence versions!*
> ✅ 
> ✅ Navigate to **CONFLUENCE ADMINISTRATION **>** Settings **>** ATLASSIAN MARKETPLACE **> **HTML** >** Profiles**.

2. <span style="color: #000000">Click </span>**Add Profile.**
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</span> <span style="color: #000000">an absolute URL</span> <span style="color: #000000">of the location to be accessed 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>

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

1. <span style="color: #000000">Add the </span><span style="color: #000000">*Html-bobswift*</span><span style="color: #000000"> macro or edit an existing macro on the page.</span>
2. <span style="color: #000000">Select the newly created profile 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>

## > 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 to access the remote location and </span><span style="color: #000000">entering the relative path</span><span style="color: #000000"> to the relevant file in the macro editor.</span>

1. <span style="color: #000000">Select </span>> Macro (inline-media-image)

<span style="color: #000000">** > Manage apps**</span><span style="color: #000000">, either search for </span><span style="color: #000000">*HTML for Confluence*</span><span style="color: #000000"> or scroll to </span><span style="color: #000000">*Bob Swift Configuration,*</span><span style="color: #000000"> and click </span><span style="color: #000000">*HTML*</span><span style="color: #000000"> to view app configuration.</span>

> ✅ *Try this for older Confluence versions!*
> ✅ 
> ✅ Navigate to **CONFLUENCE ADMINISTRATION **>** Settings **>** ATLASSIAN MARKETPLACE **> **HTML** >** Profiles**.

2. <span style="color: #000000">Click </span>**Add Profile.**
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</span> <span style="color: #000000">the base URL</span> <span style="color: #000000">in the </span><span style="color: #000000">*URL*</span><span style="color: #000000"> text box. A base URL is a part of the path that specifies the location that the macro must access.</span>
6. <span style="color: #000000">Click </span><span style="color: #000000">**Save profile **</span>to create the profile.

![Image shows how to add a profile with partial URL.](media://e84d766f-d909-4a29-b034-c77d7c1acfa3)

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

1. <span style="color: #000000">Add the </span><span style="color: #000000">*Html-bobswift*</span><span style="color: #000000"> macro or edit an existing macro on the page.</span>
2. <span style="color: #000000">Select the newly created profile 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 of the HTML file in the </span><span style="color: #000000">*Location of HTML data*</span><span style="color: #000000"> parameter. The relative URL is appended to the base URL specified in the profile to create an absolute path to the file to be rendered.</span>
4. <span style="color: #000000">Click</span> **Save**<span style="color: #000000">.</span>  
> Macro (inline-media-image)

> ℹ️ *Points to remember!*
> ℹ️ 
> ℹ️ - <span style="color: #000000">Only raw URLs must be given in either, the </span><span style="color: #000000">*URL*</span><span style="color: #000000"> field in profiles or the </span><span style="color: #000000">*Location*</span><span style="color: #000000"> fields, in the macros. </span>
> ℹ️ - <span style="color: #000000">It is recommended to specify absolute URLs to access files from public locations and to use profiles to access files from private sources. For example, a raw URL that can access an HTML file in a public Bitbucket repository is valid. But to render an HTML file located in a private repository, we recommend using a profile.</span>
> ℹ️ - <span style="color: #000000">Profiles are a means to access and retrieve contents from external applications such as Bitbucket, GitLab or GitHub. A profile already contains the base URL and the required credentials (user credentials or an access token) to access the relevant application.</span>
> ℹ️ - <span style="color: #000000">This method allows multiple users to access a profile across pages and instances of the macros.</span>

## <span style="color: #000000">Helpful resources</span>

- <span style="color: #000000">[Create a GitLab profile](https://appfire.atlassian.net/wiki/x/FoU1B)</span>
- <span style="color: #000000">[How to use URLs in macros](https://appfire.atlassian.net/wiki/x/5IQ1B)</span>
- <span style="color: #000000">[Profile configuration settings](https://appfire.atlassian.net/wiki/x/l4E1B#Configuration-html_57_config_profiles)</span>