---
title: "White Label Your Loyally.ai Portal"
description: "Step-by-step instructions to set up a custom domain, upload your logos and favicons, choose your brand colors, and configure meta tags—so your customers always see your branding in the Loyally.ai experience."
url: https://help.loyally.ai/en/articles/100-white-label-your-loyallyai-portal
collection: "White Label"
updated: 2026-10-01
language: en
---

# White Label Your Loyally.ai Portal

Step-by-step instructions to set up a custom domain, upload your logos and favicons, choose your brand colors, and configure meta tags—so your customers always see your branding in the Loyally.ai experience.

* * *

> **Info:** **Note**: White labeling is available on the **Premium Plan**. Upgrade in **Settings** > **Plan** to unlock these features.

### Why White Labeling Matters

Your loyalty program is an extension of your brand. When customers see _your_ colors, logos, and domain, it:

-   **Boosts Trust** — Familiar branding reassures customers they’re in the right place.
    
-   **Increases Engagement** — A seamless experience keeps focus on your offers, not ours.
    
-   **Drives Conversions** — Consistent visuals reduce friction, helping users complete actions faster.
    

* * *

-   **What you’ll do:** Link your own domain; upload logos, favicons, and hero images; pick your color palette; set meta tags; and tweak on‐card text.
    
-   **Why it matters:** Keeps customers in your brand environment, builds trust, and removes distractions.
    

* * *

![](https://staticfiles.gleap.io/ghelparticle/BjuhqzcKxne6PDIo3t5ztRx5jsyn6tqHqyhXROqraWYBOKkw7w5BhoRwtgKnyStfdzmZWcKgjBm.png)

### Quick Guide

> **Settings > White Label**
> 
> 1.  Link Domain
>     
> 2.  Upload Logos & Favicons
>     
> 3.  Add Login/Signup Images
>     
> 4.  Pick Colors & Save
>     
> 5.  Configure Meta Tags
>     
> 6.  (Optional) Customize Card Text & Scanner App
>     

* * *

## 1\. Connect Your Custom Domain

You can use any domain you own—or create a subdomain (e.g. `app.yourdomain.com`)—to get a fully white-labeled portal.

1.  In your Loyally.ai dashboard, go to **Settings > White Label**.
    
2.  Under **Connect Domain**, enter the domain or subdomain you’d like to use.
    
3.  **In your domain registrar’s control panel (e.g. Cloudflare, Namecheap, GoDaddy, etc.)**:
    
    -   Navigate to the DNS or zone settings for that domain.
        
    -   Create a **CNAME** record:
        
        -   **Name/Host:** your chosen domain or subdomain (e.g. `app` if you’re using `app.yourdomain.com`)
            
        -   **Value/Target:** `ns.digitalwallet.cards`
            
        -   If you use Cloudflare, set the DNS record to **DNS only** (disable the proxy orange cloud) to ensure proper SSL provisioning.
            
4.  Click **Continue** in Loyally.ai.
    
5.  Wait up to 24 hours for DNS propagation and SSL provisioning. Then click **Update status**. The status will update from “Pending” to “Active.”
    

> **Info:** **Tip**: Many customers choose an `app.` subdomain (e.g., `app.yourdomain.com`) because it’s intuitive—but you’re free to connect any domain or subdomain you prefer.

![](https://staticfiles.gleap.io/ghelparticle/gfGTIZ8Ahrr6ItlYTH6CTgMAbduNH8xZuCIGUkDikyRH0yRH3Bvnd7jY9sa87FXGnSfhVrwN5OR.png)

![](https://staticfiles.gleap.io/ghelparticle/seHbBWyjV00tBDMDoRdTpwbd0v7o59qiBn5XaZ0HrPyjNHt2brSpeoTtjfR14t8riaYgX6tzcMJ.png)

![](https://staticfiles.gleap.io/ghelparticle/319rrksIRl0RCQ8sAM5xQ3DsSD0mJ9oh1ykxdZaPSBad9MhlMfGPGaiNoZD3krp50rGVoUIVoiR.png)

* * *

> **Info:** After connecting, we recommend using your new domain/subdomain that you’ve connected (e.g. `app.yourdomain.com`)

## 2\. Upload Brand Assets

![](https://staticfiles.gleap.io/ghelparticle/QAc1bi0O0njrkOOqLVjLiXobZeabWwFkFYkVYwsUpu6BhiHp5kLDE1hUmtflHj2ZwxxXniNrzPR.png)

<table data-id="98a7952d-ce80-446b-b93b-e098ba91230b" style="min-width: 100px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="345134da-944d-4f62-acad-8b61019eff76" style="text-align: left;"><strong>Asset Type</strong></p></td><td colspan="1" rowspan="1"><p data-id="7f81cfa5-dcb9-400d-96a3-74e3f214609d" style="text-align: left;"><strong>Tip</strong></p></td><td colspan="1" rowspan="1"><p data-id="bdd14b0f-2961-4824-ad1f-6da0b10d1368" style="text-align: left;"><strong>Recommended Dimensions</strong></p></td><td colspan="1" rowspan="1"><p data-id="cf3c78c5-170d-481c-a054-b6ed0a9830d8" style="text-align: left;"><strong>Notes</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="e6178df2-397d-4121-9187-8801817ab1a6" style="text-align: left;">Logo (light variant)</p><p data-id="cabeb458-8f42-4fe7-8495-20e055430ba9" style="text-align: left;"></p><p data-id="cabeb458-8f42-4fe7-8495-20e055430ba9" style="text-align: left;"></p><p data-id="d16cda4a-4fab-4dcd-a451-33b2ed7807d4" style="text-align: left;">Light-mode Logo (PNG ≤ 3 MB)</p></td><td colspan="1" rowspan="1"><p data-id="8e432838-a6c7-48e3-9d56-2ac2c4c2dfba" style="text-align: left;">Horizontal logo, file size less than 3mb</p></td><td colspan="1" rowspan="1"><p data-id="08afd5ba-5328-4bf8-b328-a3a48a1176c7" style="text-align: left;">The recommended proportions are 16/3 at least 210x44px.</p></td><td colspan="1" rowspan="1"><p data-id="683d6482-ff81-4a96-9902-b86328cc1c24" style="text-align: left;">Transparent background recommended</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c72d5dc7-d059-4b69-be03-2abcd3386ed0" style="text-align: left;">Dark-mode Logo (PNG ≤ 3 MB)</p></td><td colspan="1" rowspan="1"><p data-id="e6ed12b6-fb21-4538-9573-4566e4057ccb" style="text-align: left;"></p></td><td colspan="1" rowspan="1"><p data-id="b98802e1-cd93-4b7b-add7-a7a7b57ad500" style="text-align: left;"><strong>Dashboard Branding &gt; Logo (Dark Variant)</strong></p></td><td colspan="1" rowspan="1"><p data-id="c0f50ec1-8f7c-4a7a-b18e-1f5a9afc53ea" style="text-align: left;">For dark-theme users</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="23b33fd6-187f-44f6-bd20-152ef09dd2bd" style="text-align: left;">Favicon (PNG)</p></td><td colspan="1" rowspan="1"><p data-id="245f23e3-c422-4a85-90dc-26e490bae04e" style="text-align: left;"></p></td><td colspan="1" rowspan="1"><p data-id="fb6065b8-b4ef-4a3b-8714-e2b5ee25d22e" style="text-align: left;"><strong>Dashboard Branding &gt; Favicon (PNG)</strong></p></td><td colspan="1" rowspan="1"><p data-id="f3206dba-9f69-43b0-8013-c0804eeacbd7" style="text-align: left;">32 × 32 px or 64 × 64 px</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b765948e-0a6a-4f52-81e4-e2a99aedaf6c" style="text-align: left;">Favicon (SVG)</p></td><td colspan="1" rowspan="1"><p data-id="9ca931fc-5321-46cd-b1f0-7bc443868fc2" style="text-align: left;"></p></td><td colspan="1" rowspan="1"><p data-id="7a82c6e6-7e1b-4463-a6ad-0218a175076e" style="text-align: left;"><strong>Dashboard Branding &gt; Favicon (SVG)</strong></p></td><td colspan="1" rowspan="1"><p data-id="8c4eb1d6-1389-4c05-b01c-245513851d17" style="text-align: left;">Scales crisply on all devices</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="04a57deb-aa6c-4181-90da-78f7614bf72e" style="text-align: left;">Sign-In Screen Image</p></td><td colspan="1" rowspan="1"><p data-id="a6e30ed4-0360-4852-9810-96b69462be01" style="text-align: left;"></p></td><td colspan="1" rowspan="1"><p data-id="de347aba-50b4-4365-9f23-f6e341bfde55" style="text-align: left;"><strong>Dashboard Branding &gt; Sign-In Screen Image</strong></p></td><td colspan="1" rowspan="1"><p data-id="0f57b027-21a9-4949-9e25-dcad74178cc5" style="text-align: left;">≥ 1200 × 600 px; appears on login page</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4ce21940-a7cd-469b-9e81-fbeb78810afe" style="text-align: left;">Sign-Up Screen Image</p></td><td colspan="1" rowspan="1"><p data-id="6624d3e2-2487-40bf-b1e8-750c07c8da7e" style="text-align: left;"></p></td><td colspan="1" rowspan="1"><p data-id="79bf9645-f16d-4b83-865b-4185e519bf75" style="text-align: left;"><strong>Dashboard Branding &gt; Sign-Up Screen Image</strong></p></td><td colspan="1" rowspan="1"><p data-id="ed879e1a-a017-4af3-afea-5360bb6505ec" style="text-align: left;">≥ 1200 × 600 px; appears on registration page</p></td></tr></tbody></table>

* * *

## 3\. Pick Your Palette & Configure Meta Tags

### Interface Colors

1.  Scroll to **Interface Colors**.
    
2.  Use the pickers to set header, menu, button, and hover colors.
    
3.  Click **Save Colors**.
    
    -   **Tip:** Verify contrast ratios (≥ 4.5:1) so text remains legible.
        

### Meta Tags

1.  In **Meta Tags**, fill in:
    
    -   **Page Title** (browser tab)
        
    -   **Social Media Title** & **Description** (link previews)
        
    -   Upload a **Social Media Image** (1200 × 630 px recommended)
        
2.  Click **Save**.
    
    -   **Why it matters:** Ensures your brand appears correctly when customers share links or find you via search engines.
        

* * *

## 4\. (Optional) Customize Card Text & Scanner App

### Card Text

1.  Under **Text on Cards**, enter the message beneath the barcode (e.g., “Powered by \[YourBrand\]“ or “Earn 1 point per $1 spent”, etc.).
    
2.  Toggle **Front-of-Card Text** and **Back-of-Card Text** on/off.
    
3.  Click **Save**.
    

### Scanner App Branding

_(Only if you use our mobile Scanner App.)_

1.  Click **Scanner Branding**.
    
2.  Upload your **App Icon** (512 × 512 px) and **Header Logo**.
    
3.  Choose header background, text, and button colors.
    
4.  Preview in the dashboard, then click **Install** or copy the distribution link.
