> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Customize My Gameball Customer Widget to Match My Brand?

> Learn how to customize Gameball customer profile widget style and colors to match your website/app branding.

## Plan Availability

> [tab] Shopify & Salla
>
> | Feature | Plan |
> | - | - |
> | Basic customization | All plans |
> | Theme, Font, Points/Score names & icons | Pro, Guru |
> | Guest widget image | Pro, Guru |

> [tab] Non-Platform
>
> | Feature | Plan |
> | - | - |
> | Basic customization | Growth, Enterprise |
> | Theme, Font, Points/Score names & icons | Growth, Enterprise |
> | Guest widget image | Growth, Enterprise |

When your loyalty widget feels out of place on your platform, customers may perceive it as intrusive or untrustworthy. That's why customizing the widget to align with your brand's identity is essential for increasing engagement and trust. Here are detailed steps for how to customize your entire widget to match your brand's theme.

***

## Colors

To brand your Gameball customer widget to match your website or app, go to the **Gameball Admin Dashboard** and navigate to **Widget > Branding: Colors**.

![Branding colors section in widget settings](https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/branding-colors-section.png?fit=max\&auto=format\&n=qQadqvPdUG22Jh8m\&q=85\&s=62ed4c200bd1953edd5ec8dd265af409)

> [accordion] Theme
>
> **Available on:** Shopify & Salla Pro/Guru | Non-platform Growth/Enterprise
>
> Choose between two modes:
>
> * **Light:** Light mode is the default mode unless set otherwise.
> * **Dark:** The main layout color will change to black.
>
> ![Light and dark theme modes](https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/theme-light-dark-modes.png?fit=max\&auto=format\&n=15226X8FGoPfo47L\&q=85\&s=e9a4295dbc4f8f2a632596d135cfa75f)

> [accordion] Widget Color
>
> This is the main color that will be applied to all tabs of the profile. You can easily choose the brand colors you use on your platform.
>
> ![Widget color settings](https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/widget-color-settings.png?fit=max\&auto=format\&n=15226X8FGoPfo47L\&q=85\&s=4eea2b1edbb55aba146fce801be7e963)
>
> Use the color palette to choose a color that matches your platform theme either by hovering over the palette with your cursor and then clicking on the closest color to your platform. Or for more accurate branding, type down your brand's color code, and click **Save**.
>
> ![Color picker palette](https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/color-picker-palette.png?fit=max\&auto=format\&n=qQadqvPdUG22Jh8m\&q=85\&s=be527dd94f5c815626d47bd04fb5ed0a)

> [accordion] Widget Font
>
> **Available on:** Shopify & Salla Pro/Guru | Non-platform Growth/Enterprise
>
> You can choose one of the following 7 fonts:
>
> * Montserrat
> * EB Garamont
> * Roboto Slab
> * Sansita Swashed
> * Mali
> * Work Sans
> * Rubik

> [accordion] Launcher Button Colors
>
> Available for **web only**.
>
> ![Launcher color settings](https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/launcher-color-settings.png?fit=max\&auto=format\&n=qQadqvPdUG22Jh8m\&q=85\&s=abc9d8efa224ed320e72dbe68ccdcbec)
>
> For web applications, you will have a launcher button that will be placed on your website to load/open the Gameball customer widget. You can control the colors of the button:
>
> * **Launcher Main Color**
> * **Icon Color**
> * **Text Color**

***

## Identity

To give your loyalty assets unique names and icons, switch to the **Identity Tab**.

![Identity tab settings](https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/identity-tab-settings.png?fit=max\&auto=format\&n=qQadqvPdUG22Jh8m\&q=85\&s=b1129084159d1a3c63f07fc19b100c2a)

> [accordion] Program Name
>
> Give your loyalty program a name that goes well with your platform's identity. For example, if your platform sells flowers, then a good name for your rewards program could be "Lily Rewards."
>
> ![Program name customization field](https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/program-name-field.png?fit=max\&auto=format\&n=15226X8FGoPfo47L\&q=85\&s=af8e642596b5c7eff047fcee0aad5fdb)
>
> * **Program Name Examples:** Plus Rewards, Adventure Rewards, Fun Portal, etc.

> [accordion] Points / Score / Earn / Redeem Names
>
> **Available on:** Shopify & Salla Pro/Guru | Non-platform Growth/Enterprise
>
> ![Points and score name settings](https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/points-score-name-settings.png?fit=max\&auto=format\&n=15226X8FGoPfo47L\&q=85\&s=225995cb7dd3242cca5e29bc5b9110c3)
>
> In case you are using score as the [Tiering-up method](https://docs.gameball.co/product-documentation/programs/vip-tiers/tier-settings/tiering-up-methods.md), you can also give the score a different name, just as you can do that to the points.
>
> * **Points Name Examples:** Coins, Tokens, Credit, etc.
> * **Score Name Examples:** Freebies, Rank, Gems, etc.
> * **Earn Name Examples:** Win, Acquire, Save, etc.
> * **Redeem Name Examples:** Spend, Exchange, etc.

> [accordion] Points & Score Icons
>
> **Available on:** Shopify & Salla Pro/Guru | Non-platform Growth/Enterprise
>
> Choose icons from Gameball's icon library for:
>
> * **Points Icon**
> * **Score Icon**
>
> ![Points and score icon library](https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/points-score-icon-library.png?fit=max\&auto=format\&n=15226X8FGoPfo47L\&q=85\&s=018ecc45bb391a517893c26ad56161dc)
>
> Choose icons from Gameball's icon library or **upload your own icons** for:
>
> * **Earn Icon**
> * **Redeem Icon**
>
> ![Earn and redeem icon options](https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/earn-redeem-icon-options.png?fit=max\&auto=format\&n=qQadqvPdUG22Jh8m\&q=85\&s=3a4c35d9cab4295e71ecf5e898709227)

***

## Guest Widget

**Available on:** Shopify & Salla Pro/Guru | Non-platform Growth/Enterprise

### Uploading an Image as a Widget Icon for Guests

One of the things that directly affect the branding is the main widget icon that shows on the guest landing page of the widget. You can choose an icon that represents your idea of loyalty without drifting from the platform's main theme.

To change the main guest widget icon, go to **Widget > Branding: Guests** in the **Gameball Admin Dashboard**.

![Guest branding settings](https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/guest-branding-settings.png?fit=max\&auto=format\&n=qQadqvPdUG22Jh8m\&q=85\&s=39b6d927d084b3a78dca89e5c9452fe0)

Under **Image**, choose between the following:

* **Default Image:** Leave Gameball's default icon as it is.
* **Upload Image:** Upload your own image from your own library to match your theme.
* **None:** Leave the guest widget without an icon.

> [!NOTE]
>
> When choosing **"Upload Image,"** the image size and type must be: 280px x 280px. JPEG or PNG.

### Create Account URL

Paste the website link where customers can create a new account.

### Login URL

Paste the website link where customers can log in.

Lastly, click **Save**.

***

## What's Next?

> [card] [Customize the Widget Launcher](https://docs.gameball.co/product-documentation/customer-widget/start-configuring-profile/customize-your-loyalty-launcher-to-fit-your-platforms-interface.md)
>
> Control the shape, position, icon, and visibility of your loyalty launcher button.

> [card] [Customize Tabs Visibility and Order](https://docs.gameball.co/product-documentation/customer-widget/start-configuring-profile/customizing-tabs-visibility-and-order-in-gameball-widget-settings.md)
>
> Control which tabs appear in your widget and in what order they are displayed.

> [card] [Guest Profile Configuration for Web](https://docs.gameball.co/product-documentation/customer-widget/start-configuring-profile/guest-widget-configuration-for-web.md)
>
> Configure the guest experience, including images, sign-up URLs, and login redirects.

> [card] [Configure Widget Language](https://docs.gameball.co/product-documentation/customer-widget/start-configuring-profile/configure-customer-widget-language-on-your-platform.md)
>
> Set a default language and add additional languages to serve a multilingual audience.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.