Skip to main content

Hosting a White-Label Logo Using GitHub Raw Links

pablo
Updated

Overview

For white-label configurations, the logo file must be hosted at a publicly accessible URL. If you do not have an existing website or hosting location available, GitHub can be used as a free hosting option to upload the logo and generate a direct image URL.

This guide explains how to upload a logo to GitHub and obtain a raw image link that can be used for white-label branding.

Requirements

Before starting, make sure you have:

  • A GitHub account
  • A logo file ready for upload

Recommended logo formats:

  • PNG (recommended)
  • SVG
  • JPG/JPEG

For best results, use a transparent PNG logo with appropriate dimensions.

Step 1: Create a GitHub Account

  1. Navigate to:

    https://github.com

  2. Select:

    Sign Up

  3. Complete the registration process.
  4. Verify your email address.

Step 2: Create a Repository for the Logo

  1. Log into GitHub.
  2. Click the + icon in the upper-right corner.

  3. Select:

    New repository

  4. Configure the repository:

    Repository name:

    company-logo

  5. Set the repository visibility to:

    Public

    A public repository is required so the logo can be accessed externally.

  6. Click:

    Create repository

Step 3: Upload the Logo File

  1. Open the newly created repository.

  2. Click:

    Add file → Upload files

  3. Drag and drop your logo file into the upload area.

    Example:

    company-logo.png

  4. Scroll down and click:

    Commit changes

The logo is now stored in your GitHub repository.

Step 4: Obtain the GitHub File Link

  1. Click the uploaded logo file.
  2. Copy the URL from the browser.

Example:

https://github.com/username/company-logo/blob/main/company-logo.png

This URL points to the GitHub webpage displaying the file and should not be used for white-label configuration.

Step 5: Convert the Link to a Raw Image URL

The GitHub file URL must be converted into a raw URL.

Original format:

https://github.com/USERNAME/REPOSITORY/blob/main/FILE.png

Convert it to:

https://raw.githubusercontent.com/USERNAME/REPOSITORY/main/FILE.png

Changes made:

  • Replace:
github.com

with:

raw.githubusercontent.com
  • Remove:
/blob

Example

GitHub URL:

https://github.com/cyberplex/company-logo/blob/main/logo.png

Raw URL:

https://raw.githubusercontent.com/cyberplex/company-logo/main/logo.png

Step 6: Verify the Raw Link

  1. Open the raw URL in a browser.
  2. Confirm that:
    • The image loads directly.
    • No GitHub page is displayed.
    • The URL ends with the image extension.

Example:

https://raw.githubusercontent.com/cyberplex/company-logo/main/logo.png

If the image loads correctly, this URL can be provided for white-label branding.

Troubleshooting

The image does not load

Verify:

  • The repository visibility is set to Public.
  • The filename and capitalization are correct.
  • The URL uses:
raw.githubusercontent.com
  • The image file exists in the repository.

The logo appears broken after configuration

Check:

  • The raw URL opens successfully in an incognito/private browser window.
  • The logo file is not restricted by GitHub permissions.
  • The image format is supported.

Summary

The final URL used for white-label branding should follow this format:

https://raw.githubusercontent.com/USERNAME/REPOSITORY/main/LOGO_FILENAME.png

This provides a publicly accessible direct link to the hosted logo file.

Comments

0 comments

Please sign in to leave a comment.