---
title: "Add a GitHub profile"
canonical: "https://support.appfire.com/space/HTML/70616352/Add%20a%20GitHub%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://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">GitHub 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://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)</span><span style="color: #000000"> </span><span style="color: #000000">for information about generating a GitHub access token. Refer to </span><span style="color: #000000">[GitHub access token](https://github.com/settings/tokens)</span><span style="color: #000000"> for the actual URL to get the access token if you have a GitHub account.</span>
> ℹ️ - <span style="color: #000000">Whitelist</span><span style="color: #000000"> the GitHub 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"> GitHub 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">*GitHub*</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</span> <span style="color: #000000">relevant</span> <span style="color: #000000">URL for GitHub in the </span><span style="color: #000000">*URL*</span><span style="color: #000000"> text box. Example: </span>`https://api.github.com/repos`<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 GitHub 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://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)</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 GitHub repositories.</span>
7. <span style="color: #000000">Click </span><span style="color: #000000">**Save profile**</span><span style="color: #000000"> to create a profile.</span>

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

- <span style="color: #000000">[Create a GitLab profile](https://appfire.atlassian.net/wiki/x/FoU1B)</span>
- [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#html_57_config_profiles)</span>