---
title: "Add a GitLab profile"
canonical: "https://support.appfire.com/space/HTML/70616342/Add%20a%20GitLab%20profile"
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://bobswift.atlassian.net/wiki/spaces/info/pages/2537850172/Deprecation+notice%https://appfire.atlassian.net/wiki/spaces/info/pages/86083883/Deprecation+notice+URL+user+and+URL+user+password+parameters)). We recommend using [profiles](https://appfire.atlassian.net/wiki/x/l4E1B#html_57_config_profiles) to access external data.

<span style="color: #000000">This article illustrates the process of adding a </span><span style="color: #000000">GitLab profile to be used with 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">To add a profile, you need the following:</span>
> ℹ️ 
> ℹ️ - <span style="color: #000000">[Personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)</span><span style="color: #000000"> for information about </span><span style="color: #000000">generating a GitLab</span><span style="color: #000000"> access token. Refer to </span><span style="color: #000000">[GitLab access token URL](https://gitlab.com/profile/personal_access_tokens)</span><span style="color: #000000"> for the actual URL to generate the access token if you have a GitLab account.</span>
> ℹ️ - <span style="color: #000000">Whitelist the required GitLab URL in Confluence configuration settings if </span><span style="color: #000000">*Restrict URL access*</span><span style="color: #000000"> in HTML for Confluence Configuration is enabled.</span>
> ℹ️ - <span style="color: #000000">Raw URL of the file to be rendered.</span>

> ℹ️ 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 `http://www.contoso.com/articles/recent.aspx`, the raw URL is `/articles/recent.aspx`.

> ✅ *How to identify if a file is valid for the macro?*
> ✅ 
> ✅ Paste the file link into your browser's address bar. If the actual code is displayed in the browser, it is considered to be invalid or in an incorrect format. If the file downloads to your system, the macro(s) can process the file and its contents.

<span style="color: #000000">For this example,</span><span style="color: #000000"> let's add a</span><span style="color: #000000"> GitLab profile to an </span><span style="color: #000000">*Html-bobswift*</span><span style="color: #000000"> macro.</span>

## <span style="color: #000000">Steps</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 profile name 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">*GitLab*</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 relevant URL for GitLab in the </span>*URL*<span style="color: #000000"> text box. Example: </span>*https://gitlab.com/api/v4/projects*<span style="color: #000000">. </span>
6. <span style="color: #000000">Enter </span><span style="color: #000000">*User*</span><span style="color: #000000"> and </span><span style="color: #000000">*Password*</span><span style="color: #000000"> credentials required to access the given URL, or enter the access token</span> <span style="color: #000000">for your GitLab profile in the </span><span style="color: #000000">*Access token*</span><span style="color: #000000"> text box. </span><span style="color: #091e42">Refer to this </span><span style="color: #000000">[personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)</span><span style="color: #000000"> article to know how to create your personal access token. </span>
  <span style="color: #000000">In this example, an access token is used to connect and access the </span><span style="color: #000000">GitLab</span><span style="color: #000000"> repositories.</span>
7. Click **Save profile**<span style="color: #000000"> to create the profile.</span>

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

- [Create a GitHub profile](https://appfire.atlassian.net/wiki/x/IIU1B)
- [Create a profile with a URL](https://appfire.atlassian.net/wiki/x/94Q1B)
- <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>