---
title: "Create a profile with a URL"
canonical: "https://support.appfire.com/space/SUPPORT/89136776/Create%20a%20profile%20with%20a%20URL"
format: markdown
---
# <span style="color: #000000">Description</span>

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

> ℹ️ ## Before you begin:
> ℹ️ 
> ℹ️ - Before you enter the URL for a repository, ensure that it complies with the REST standards published by GitHub or GitLab.
> ℹ️   - [Click here](https://docs.gitlab.com/ee/api/repository_files.html) <span style="color: #000000">for more information on REST Pattern for GitLab.</span>
> ℹ️   - [Click here](https://developer.github.com/v3/) <span style="color: #000000">for more information on REST Pattern for GitHub.</span>
> ℹ️ - <span style="color: #000000">Know what is a complete URL. A typical path for the raw file on GitLab looks like:</span>
> ℹ️ 
> ℹ️ `    /projects/:id/repository/files/:file_path/raw`
> ℹ️ 
> ℹ️ - <span style="color: #000000">Since the host address begins with:</span>
> ℹ️ 
> ℹ️ `     https://gitlab.com/api/v4`
> ℹ️ 
> ℹ️ - <span style="color: #000000">The </span><span style="color: #000000">complete URL, in this example, looks like: </span>
> ℹ️ 
> ℹ️ ` https://gitlab.com/api/v4/projects/:id/repository/files/:file_path/raw?ref=master`
> ℹ️ 
> ℹ️ - <span style="color: #000000">For illustrative purposes, we have used a public</span> [Bitbucket public repository](https://bitbucket.org/bob_swift/gint/src/default/README.md). <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">You can work with URLs in three ways:</span>

# <span style="color: #000000">Use the complete URL</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 to </span>**<span style="color: #000000">CONFLUENCE ADMINISTRATION ></span>**<span style="color: #000000"> </span>***<span style="color: #000000">General Configuration > </span>*****<span style="color: #000000">BOB SWIFT CONFIGURATION > </span>****<span style="color: #000000">Markdown > Profiles.</span>**
2. <span style="color: #000000">Click </span>**<span style="color: #000000">Add Profile.</span>**
3. <span style="color: #000000">Enter BitURL in the </span>*<span style="color: #000000">Profile name</span>*<span style="color: #000000"> text box.</span>
4. <span style="color: #000000">Select URL from the options in </span>*<span style="color: #000000">Profile type</span>*<span style="color: #000000">. </span>
5. <span style="color: #000000">Enter</span> [https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md](https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md) <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 a Profile.</span>

![image](media://01ff8090-d6f5-4ae2-aac0-fd9ed7daded2)

<span style="color: #000000">7. In the </span>*<span style="color: #000000">Markdown from a URL macro</span>*<span style="color: #000000">, select BitURL from the </span>*<span style="color: #000000">Profile</span>*<span style="color: #000000"> list.</span>

<span style="color: #000000">8. Click </span>**<span style="color: #000000">Save</span>**

![image](media://1f4b447e-8de8-4177-afd7-7d55f8ab23ea)

# <span style="color: #000000">Use a fixed URL</span>

<span style="color: #000000">You can create a profile by providing a fixed URL for the Markdown content and enter the relative path to the Markdown file in the markdown-url macro.</span>

1. <span style="color: #000000">Navigate to </span>**<span style="color: #000000">CONFLUENCE ADMINISTRATION ></span>**<span style="color: #000000"> </span>***<span style="color: #000000">General Configuration > </span>*****<span style="color: #000000">BOB SWIFT CONFIGURATION > </span>****<span style="color: #000000">Markdown > Profiles.</span>**
2. <span style="color: #000000">Click </span>**<span style="color: #000000">Add Profile.</span>**
3. <span style="color: #000000">Enter BitURL in the </span>*<span style="color: #000000">Profile name</span>*<span style="color: #000000"> text box.</span>
4. <span style="color: #000000">Select URL from the options in </span>*<span style="color: #000000">Profile type</span>*<span style="color: #000000">. </span>
5. <span style="color: #000000">Enter</span> [https://bitbucket.org](https://bitbucket.org/bob_swift/gint/src/default/README.md) <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 a Profile.</span>

![image](media://3d513e80-fb95-49f6-a628-d06a32ae6835)

7. <span style="color: #000000">Select BitURL from the </span>*<span style="color: #000000">Profile</span>*<span style="color: #000000"> list in the markdown-url macro editor. </span>

<span style="color: #000000">8. Enter the relative path to the Markdown file </span>[/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md](https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md) <span style="color: #000000">in the </span>*<span style="color: #000000">URL to markdown file</span>*<span style="color: #000000"> parameter.</span>

<span style="color: #000000">9. Click </span>**<span style="color: #000000">Save.</span>**

![image](media://5544b537-f15f-4440-a569-d9d016349895)

> ℹ️ This method allows multiple users to access a profile across pages and instances of the markdown-url macro.

# <span style="color: #000000">Skip creating a profile</span>

You can skip creating a profile and provide the complete URL in the URL to markdown file parameter in the macro editor. 

1. Enter [https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md](https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md) in the the *URL to markdown file.*
2. Click **Save.**

![image](media://e284bfa3-6ce4-4daf-8320-5f1495019f74)