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

<span style="color: #000000">This article illustrates how administrators can </span><span style="color: #000000">create a profile using URLs to be used with the </span><span style="color: #000000">*Visio Viewer*</span><span style="color: #000000"> macro</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><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 Bitbucket looks like:</span>  
> ℹ️ <span style="color: #000000">*/projects/:id/repository/files/:file_path/raw*</span>
> ℹ️   - <span style="color: #000000">If the host address begins with:</span>  
> ℹ️ <span style="color: #000000">*https://bitbucket.workspace.com*</span>
> ℹ️   - <span style="color: #000000">The </span>complete URL, in this example, 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</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: #000000">The process of 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 configure profiles with URLs:</span>

- <span style="color: #000000">Using an</span><span style="color: #000000"> </span><span style="color: #000000">[absolute URL](#CreateaprofilewithaURL-vis_53_tutl_profileURL_absURL)</span>
- <span style="color: #000000">Using a </span><span style="color: #000000">[partial URL](#CreateaprofilewithaURL-vis_53_tutl_profileURL_partURL)</span>

## > Macro (anchor)

<span style="color: #000000">U</span><span style="color: #000000">sing an</span><span style="color: #000000"> 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">*Visio 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">*Visio*</span><span style="color: #000000"> to view app configuration.</span>
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 of the location to be accessed</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>

<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">*Visio Viewer*</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. </span>
3. <span style="color: #000000">See a </span><span style="color: #000000">*Preview *</span><span style="color: #000000">of the Visio diagram, or click </span><span style="color: #000000">**Save**</span><span style="color: #000000">.</span>  
> Macro (inline-media-image)

## > Macro (anchor)

<span style="color: #000000">U</span><span style="color: #000000">sing a p</span><span style="color: #000000">artial URL in a profile</span>

<span style="color: #000000">You can create a profile by providing a base URL to access the remote location, and then users can provide</span><span style="color: #000000"> the relative path</span><span style="color: #000000"> to the relevant file in the </span><span style="color: #000000">*Visio Viewer*</span><span style="color: #000000"> macro editor</span><span style="color: #000000">.</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">*Visio 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">*Visio*</span><span style="color: #000000"> to view app configuration.</span>
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 the base URL</span><span style="color: #091e42"> </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](media://c1a1c8f4-2592-45ff-9e4f-f6d7850932e2)

<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">*Visio Viewer*</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 to the</span> <span style="color: #000000">Visio file in the </span><span style="color: #000000">*URL to Visio file*</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 in app configuration or the </span><span style="color: #000000">*URL to Visio file*</span><span style="color: #000000"> field in the macro editor.</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 a Visio file in a public Bitbucket repository is valid. But to render a Visio 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. 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>