> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/settings/branding.md).

# Branding

Customizing your loyalty program's branding strengthens your brand identity and deepens customer connection. Perkville offers extensive customization options—from logos and colors to main pages and [emails](/features/emails.md)—so you can align the program's look and feel with your business.

This section covers the tools available to help you effectively brand your loyalty program.

{% hint style="success" %}
To navigate to your branding page, click on **Settings** from your program dashboard and then **Branding**
{% endhint %}

## Logo and colors

In the branding settings, you'll be able to complete the following:

* **Add your logo:** Upload your primary logo, which will be displayed prominently on the site and in emails. We recommend using square images with dimensions of 150px by 150px for optimal display.
* **Add your secondary logo:** Upload your secondary logo, which will be used in the top-most navigation bar and emails. Rectangular images work best, and we recommend dimensions of 150px by 50px.
* **Custom font (optional):** Optionally, you can add a custom font to further personalize your branding.
* **Enter hex values for colors:** Define the hex values for your primary and secondary colors, which will be used across the site and in emails.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FbrYZhZPiTKcmpMhXjlFj%2FScreenshot%202025-06-12%20at%2011.00.16%E2%80%AFAM.png?alt=media&amp;token=5746de21-5b78-4f06-b2f8-5dc84a65e5c2" alt=""><figcaption><p>Set your program's logos, colors, and fonts in your branding settings</p></figcaption></figure>

Once you've set these values, click "Preview" to see how your branding will look on the site and in emails. You can also add more customizations at this stage.&#x20;

{% hint style="info" %}
Updates will not go live until your publish your changes
{% endhint %}

## Web page and email branding

You can customize your rewards website and emails through Perkville's branding tool.

For each component, you can customize the following:

* **Header:** Customize the header of the page or email.
* **Background color:** Choose the background color to align with your brand.
* **Text color:** Define the text color for better readability.
* **Button background color:** Customize the background color of buttons to make them stand out.
* **Button text color:** Define the text color of buttons for clear visibility.
* **Footer type:** Choose the type of footer and customize its appearance.
* **Footer background color:** Define the background color of the footer.
* **Footer text color:** Customize the text color in the footer.

### **Components for customization:**

1. **Website as a whole:** Customize the overall appearance of your loyalty program website.
2. **Referral page:** Customize the page where customers refer their friends.
3. **Login/registration page:** Personalize the login and registration page for a seamless user experience.
4. **Emails:**
   * **Earned points email:** Customize the email sent when a customer earns points.
   * **Referral email:** Personalize the email sent to prospects referred by a customer.
   * **Invitation email:** Customize the email sent to customers inviting them to join the loyalty program.

{% hint style="info" %}
After customizing these components, you can save your settings. Remember, updates will not go live until you publish the changes.
{% endhint %}

{% hint style="danger" %}
**Accessibility note**

Please note that it's important to follow [WCAG recommendations](https://www.w3.org/TR/WCAG20/) for accessibility, including color and contrast ratio. Adhering to these guidelines ensures that your rewards program is usable for everyone. Perkville will not be held responsible for neglecting to adhere to these requirements when setting brand colors and images.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.perkville.com/features/settings/branding.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.