---
title: "How to create a profile with a URL"
canonical: "https://support.appfire.com/space/GVIZ/70221915/How%20to%20create%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. We recommend using <span style="color: #000000">profiles </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">*Graphviz*</span><span style="color: #000000"> macros using a URL.</span>

> ⚠️ <span style="color: #000000">Profiles are not available for use with the </span><span style="color: #000000">*Graph from table*</span><span style="color: #000000"> and </span><span style="color: #000000">*Space graph*</span><span style="color: #000000"> macros.</span>


> ℹ️ ## <span style="color: #000000">Before you begin:</span>
> ℹ️ 
> ℹ️ - <span style="color: #000000">Before you enter the URL for a repository, ensure that it complies with the REST standards published by GitHub or GitLab.</span>
> ℹ️   - [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>
> ℹ️ 
> ℹ️ <sup>       /projects/:id/repository/files/:file_path/raw</sup>
> ℹ️ 
> ℹ️ - <span style="color: #000000">Since the host address begins with:</span>
> ℹ️ 
> ℹ️ <sup>        https://gitlab.com/api/v4</sup>
> ℹ️ 
> ℹ️ - <span style="color: #000000">The complete URL, in this example, looks like: </span>
> ℹ️ 
> ℹ️ <sup>       https://gitlab.com/api/v4/projects/:id/repository/files/:file_path/raw?ref=master</sup>
> ℹ️ 
> ℹ️ - <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">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](https://appfire.atlassian.net/wiki/pages/resumedraft.action?draftId=70221915#HowtocreateaprofilewithaURL-GVIZ_Cld_HowTo_CompleteURL)</span><span style="color: #000000"> in a profile</span>
- <span style="color: #000000">A </span><span style="color: #000000">[base URL](https://appfire.atlassian.net/wiki/pages/resumedraft.action?draftId=70221915#HowtocreateaprofilewithaURL-GVIZ_Cld_HowTo_FixedURL)</span><span style="color: #000000"> in a profile</span>
- <span style="color: #000000">An </span><span style="color: #000000">[absolute URL directly](https://appfire.atlassian.net/wiki/pages/resumedraft.action?draftId=70221915#HowtocreateaprofilewithaURL-GVIZ_Cld_HowTo_AbsoluteURL)</span><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 Graphviz content.</span>

1. <span style="color: #000000">Navigate</span><span style="color: #000000"> to </span><span style="color: #000000">***CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > Graphviz Configuration > Profiles***</span><span style="color: #000000">.</span>
2. <span style="color: #000000">Click </span><span style="color: #000000">**Add Profile**</span><span style="color: #000000">.</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. For this example, enter </span><span style="color: #000000">**BitbucketFullURL**</span><span style="color: #000000"> in the 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">https://bitbucket.org/bobswift-test/testfiles/raw/66f9cf5ba2bfe3890caf9dc2d89e81b59210a5e6/digraph</span> <span style="color: #000000">in the </span><span style="color: #000000">**URL**</span><span style="color: #000000"> text box. </span>  
> Macro (inline-media-image)
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">Search for the </span><span style="color: #000000">*Graphviz*</span><span style="color: #000000"> macro and edit it.</span>
2. <span style="color: #000000">Enter </span><span style="color: #000000">**BitbucketFullURL**</span><span style="color: #000000"> in </span><span style="color: #000000">*Profile*</span><span style="color: #000000"> and then, click </span><span style="color: #000000">**Save**</span><span style="color: #000000">.</span>
  

# > Macro (anchor)

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

<span style="color: #000000">You can create a profile by providing a base URL and then, enter the relative path to the relevant files in the </span><span style="color: #000000">*Graphviz*</span><span style="color: #000000"> 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">**Settings**</span><span style="color: #000000"> > </span><span style="color: #000000">**ATLASSIAN MARKETPLACE**</span><span style="color: #000000"> > </span><span style="color: #000000">**Graphviz Configuration**</span><span style="color: #000000"> > </span><span style="color: #000000">**Profiles**</span><span style="color: #000000">.</span>
2. <span style="color: #000000">Click </span><span style="color: #000000">**Add Profile**</span><span style="color: #000000">.</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. For this example, enter </span><span style="color: #000000">**BitbucketProfile**</span><span style="color: #000000"> in the text box.</span>
4. <span style="color: #000000">Select </span><span style="color: #000000">**URL**</span><span style="color: #000000"> from the options in Profile type. </span>
5. <span style="color: #000000">Enter</span> <span style="color: #000000">https://bitbucket.org/bobswift-test/</span> <span style="color: #000000">in the </span><span style="color: #000000">**URL**</span><span style="color: #000000"> text box.</span>  
> Macro (inline-media-image)
6. <span style="color: #000000">Click </span><span style="color: #000000">**Save profile **</span>to create the profile.

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

1. <span style="color: #000000">Search for the Graphviz macro and edit it.</span>
2. <span style="color: #000000">Enter </span><span style="color: #000000">**BitbucketProfile**</span><span style="color: #000000"> in Profile in the editor.</span>
3. <span style="color: #000000">Enter the relative path to the file in the </span><span style="color: #000000">*URL to*</span><span style="color: #000000"> </span><span style="color: #000000">**Graphviz file**</span><span style="color: #000000"> parameter.</span>
4. <span style="color: #000000">Click</span> **Save**<span style="color: #000000">.</span>  
> Macro (inline-media-image)

> ℹ️ <span style="color: #000000">This method allows multiple users to access a profile across pages and instances of the </span><span style="color: #000000">*Graphviz *</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 entirely and enter an absolute URL in the </span><span style="color: #000000">*URL to Graphviz file*</span><span style="color: #000000"> parameter.</span>

1. <span style="color: #000000">In a Confluence page, search for the </span><span style="color: #000000">*Graphviz*</span><span style="color: #000000"> macro and edit it.</span>
2. <span style="color: #000000">Enter</span> <span style="color: #000000">https://bitbucket.org/bobswift-test/testfiles/raw/4e437c71635ac79f796456495807fb6c65218c84/grphviz</span> <span style="color: #000000">in the the </span><span style="color: #000000">**URL**</span><span style="color: #000000">* to *</span><span style="color: #000000">**Graphviz file**</span><span style="color: #000000"> parameter.</span>
3. <span style="color: #000000">Click </span><span style="color: #000000">**Save.**</span>

![image](media://f7f0a6bb-7546-4a7f-84bc-c1814638fc19)