> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/customise-your-site/add-your-logo.md).

# Add Your Logo

Your logo is a key part of your raffle site's branding. Here's how to upload it, set up a version for your emails, and fine tune how it sits in your site header.

Your logo appears in the header at the top of every page of your site, in the menu customers open on their phones, and at the top of the emails your customers receive. This page walks you through uploading it and getting it looking just right.

Everything on this page lives in one place in your admin panel, the **Branding & Theme** page.

***

### Before You Start

Get your logo file ready first. It makes the rest of the process much quicker.

* **File type:** PNG or JPG. A PNG with a transparent background is best, because it sits cleanly on any background colour.
* **Recommended size:** 480 x 120 pixels (a wide, landscape shape).
* **Maximum file size:** 872KB.
* **Trim the edges:** remove any empty space or blank border around the logo before you upload it.

{% hint style="warning" %}
**Why trimming matters.** Your site treats the whole image as "the logo", including any empty space around it. If your file has a lot of blank border, the actual logo will look much smaller than you expect. Cropping tightly around the logo lets it display at its full size.
{% endhint %}

{% hint style="info" %}
**Wide logos work best.** The header has a maximum height for the logo, so a tall or square logo will be shrunk down to fit and can look small. A wide logo (around four times wider than it is tall, like 480 x 120) fills the space nicely. If your brand only has a square logo, consider creating a wider version with your brand name beside the icon.
{% endhint %}

For more help with sizes across the whole site, see the [Image Size Guide](https://docs.rafflex.io/customise-your-site/add-your-logo/image-size-guide.md).

{% hint style="info" %}
**Want your logo in the browser tab?** The browser tab icon (the favicon) is not your site logo. Upload it as the **Fav Icon** in the Site Icons section of [SEO Settings](https://docs.rafflex.io/marketing/website-tools/seo-settings.md#site-icons).
{% endhint %}

***

### 1. Open the Branding Settings

1. Log in to your **admin panel**.
2. In the left-hand menu, click **Settings** (you will find it under the **Content** group).
3. In the settings menu, click **Branding**. The page that opens is called **Branding & Theme**.

The page is split into sections. Your logo settings are in the **Theme Settings** section. The **Color Theme** and **Typography** sections on the same page are covered in [Choose Site Colours](https://docs.rafflex.io/customise-your-site/choose-site-colours.md) and [Choose Site Fonts](https://docs.rafflex.io/customise-your-site/choose-site-fonts.md).

{% hint style="info" %}
All the settings on this page are edited directly on the page. When you have finished making changes, scroll to the bottom and click **Save Settings**. Nothing changes on your live site until you save.
{% endhint %}

***

### 2. Upload Your Main Logo

1. In the **Theme Settings** section, find **Site Logo**.
2. Click the upload box, or drag your logo file onto it.
3. Wait for the upload to finish. You will see a preview of your logo once it is ready.
4. Scroll to the bottom of the page and click **Save Settings**.
5. Open your website in a new tab (or refresh it if it is already open) to see your new logo.

The **Site Logo** is required, so the page will not save without one. If you want to swap it for a new version, remove the current image by clicking the small **X** on its preview, upload the new file, then click **Save Settings**.

As well as the header and the mobile menu, your Site Logo is shown on your maintenance and password protection pages, and is used as a stand in picture in a few places where a prize has no image of its own, for example on some winner lists and order confirmation screens. This is another reason a clean, trimmed logo looks best.

{% hint style="info" %}
**Do not see your new logo?** Your browser may be showing a saved copy of the old page. Try a hard refresh (hold **Shift** and click the refresh button), or open your site in a private or incognito window.
{% endhint %}

***

### 3. Set Up Your Email Logo

Your customer emails (order confirmations, winner emails and so on) always have a **white background**. If your main logo is white or very light, it will be almost invisible in those emails.

The **Email Logo Override** setting fixes this by letting you upload a separate logo just for emails.

1. In the **Theme Settings** section, find **Email Logo Override**. The note underneath reads *"Emails are a white background so a darker logo is recommended."*
2. Upload a dark version of your logo (for example, a black or dark coloured version).
3. Click **Save Settings**.

Your email logo is used at the top of your customer emails and the marketing emails you send from your admin panel.

{% hint style="success" %}
**Already have a dark logo?** You do not need to upload it twice. If you leave **Email Logo Override** empty, your emails automatically use your **Site Logo** instead. Only upload an email logo when your main logo would not show up well on white.
{% endhint %}

The logo size and spacing settings further down this page are for your website. Your customer emails show the logo at their own fixed size, so you do not need to adjust anything for them.

For the rest of your email setup, see [Email Setup](https://docs.rafflex.io/additional-settings/email-setup.md).

***

### 4. Adjust Logo Size and Header Spacing

Once your logo is uploaded, you can fine tune how it sits in your header. Each of these settings is a number. Change one at a time, click **Save Settings**, then refresh your site to see the effect.

{% hint style="info" %}
**Mobile and desktop are set separately.** In the settings below, "desktop" means larger screens such as laptops, desktop computers and some tablets held sideways. "Mobile" means phones and smaller screens. Always check your site on both a computer and a phone after making changes.
{% endhint %}

| Setting                         | Default | What it does                                                                                                                                                                                               |
| ------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Site Logo Max Width Mobile**  | 180     | The widest your logo can be on phones, in pixels. Lower it if your logo crowds the menu button and basket on small screens.                                                                                |
| **Site Logo Max Width Desktop** | 240     | The widest your logo can be on larger screens, in pixels. Raise it to make a wide logo bigger, or lower it to make it smaller.                                                                             |
| **Site Logo Spacing**           | 10      | Empty space added around all four sides of your logo, in pixels. Increase it for more breathing room, or set it to 0 to let the logo use all of its space.                                                 |
| **Header Height**               | 6       | How tall the header bar is. A higher number makes a deeper header. On phones the header is automatically made a little shorter in proportion.                                                              |
| **Header Padding Left**         | 2       | The gap between the left edge of the screen and your logo. Increase it to move your logo further in from the edge, or set it to 0 to push it right up to the edge. Phones get half this gap automatically. |

#### Tips for getting it right

* **Logo looks too small?** First check your file has no empty border around it. Then try increasing **Site Logo Max Width Desktop** (and the mobile one if needed), and reduce **Site Logo Spacing**, because spacing is taken from the logo's own space and makes the logo itself slightly smaller.
* **Logo still will not get any bigger?** The logo has a maximum height in the header, so a tall logo stops growing once it reaches that height, however wide you allow it to be. A wider version of your logo is the answer here.
* **Header feels cramped?** Increase **Header Height** one step at a time. Each step adds roughly 16 pixels of height on desktop.
* **Header feels too deep?** Reduce **Header Height**. If you set a very small number (below 4 on larger screens, or below 5 on phones), the header simply sizes itself to fit your logo and menu.
* **Logo touching the edge of the screen?** Increase **Header Padding Left**.
* **Logo overlapping the menu or basket on phones?** Reduce **Site Logo Max Width Mobile**.

{% hint style="info" %}
**Have a custom designed header?** If the RaffleX team has built a bespoke header for your site, your header layout comes from that design, so these size and spacing settings may not change it. The menu customers open on their phones still uses your Site Logo and these settings. Contact Rafflex support if you would like changes to a custom header.
{% endhint %}

***

### 5. Add a Custom Icon (Optional)

The **Custom Icon** lets you swap one of the small built in icons on your site for your own branded one. It is a nice finishing touch, for example a small coin or token with your logo on it.

**Where it appears:**

* **Next to your customer's credit balance** in the site header. Logged in customers see their site credit balance with a small coin icon beside it, on desktop, on phones and in the mobile menu. Your Custom Icon replaces that coin.
* **On the progress bar of some competition card styles.** If a **Product grid** block on your homepage (or any other page) uses the **Obsidian** or **Neon** option for **Competition Card Style**, your Custom Icon sits at the end of each competition's progress bar, showing how far ticket sales have got.

**How to upload it:**

1. In the **Theme Settings** section, find **Custom Icon**.
2. Upload your icon. The note underneath recommends *100 x 100 pixels with a transparent background, PNG format only*.
3. Click **Save Settings**.
4. Log in to your site as a customer (or view a page with Obsidian or Neon cards) to check how it looks.

{% hint style="warning" %}
**Using the Obsidian or Neon card styles?** These styles are designed to show your Custom Icon on the progress bar, so make sure you upload one. Without it, the end of the progress bar can show a broken image instead of an icon.
{% endhint %}

#### Tips for a great icon

* Use a **square PNG with a transparent background**. A white or coloured box behind your icon will look out of place.
* Keep it **simple and bold**. The icon is shown very small (around the size of a letter), so fine detail and small text will not be visible.
* Check it against your **background colour**. Make sure it stands out on your chosen site background.

For how customer credit works, see [Site Credit & Wallets](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets.md). To change your **Competition Card Style**, see the Product grid section of [Page Builder Blocks](https://docs.rafflex.io/customise-your-site/manage-your-pages/page-builder-blocks.md#product-grid).

***

### Next Steps

While you are on the Branding & Theme page, it is a good time to set your colours and fonts too.

{% content-ref url="/pages/be0YoFNTYHvIPX4KEva8" %}
[Choose Site Colours](https://docs.rafflex.io/customise-your-site/choose-site-colours.md)
{% endcontent-ref %}

{% content-ref url="/pages/jyGeM3LBsrZIcCEyl02G" %}
[Choose Site Fonts](https://docs.rafflex.io/customise-your-site/choose-site-fonts.md)
{% endcontent-ref %}
