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

# Branding

Your branding is set up by OmyPayments from the materials you send us. To change anything, contact your OmyPayments manager. Changes take effect without a release; allow a short delay for caches to refresh.

### Identity and addresses

| Field                      | What it is                                                                                                    | Where it is used                                                                                                                                                                                      |
| -------------------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                   | Your company or product name                                                                                  | Page titles, emails (as sender name and in place of a logo), wallet connection prompts                                                                                                                |
| **Domain**                 | Your second-level domain, e.g. `partner.com`                                                                  | Identifies you on every request. See [Domains and proxy setup](https://docs.omypayments.com/white-label/domains-and-proxy-setup.md)                                                                   |
| **Payment page URL**       | Base address of your payment page, e.g. `https://pay.partner.com` — no path, no trailing slash                | Every invoice link. Must be on your domain. **Required:** without it, invoices cannot be created                                                                                                      |
| **Merchant dashboard URL** | Base address of your merchant dashboard, e.g. `https://dashboard.partner.com` — `https://`, no trailing slash | Links in emails to merchants: email confirmation, password reset, team invitation. Must be on your domain. **Required for launch:** these links are built from it                                     |
| **Customer dashboard URL** | Base address of your customer dashboard, e.g. `https://customer.partner.com` — `https://`, no trailing slash  | Links in emails to customers (email confirmation, password reset) and the sign-up link a merchant gives its customers. Must be on your domain. If you do not set it, `customer.<your domain>` is used |
| **API documentation URL**  | Link to your API documentation for merchants, on any host                                                     | The **Docs** menu item and the **View API Documentation** link in the merchant dashboard. If you do not set it, the OmyPayments API documentation is linked                                           |

The dashboard addresses are set once the subdomain already opens the dashboard through your proxy, so that links in emails never lead nowhere.

### Colours

| Field                          | Format         | Notes                                                                     |
| ------------------------------ | -------------- | ------------------------------------------------------------------------- |
| **Primary colour**             | Hex, `#RRGGBB` | Buttons, links, accents                                                   |
| **Secondary colour**           | Hex, optional  | Secondary accents                                                         |
| **Primary button text colour** | Hex, optional  | Text on primary buttons — pick one that contrasts with the primary colour |

If you set no colours at all, the default OmyPayments palette is used.

### Images

| Field           | Formats            | Notes                                                                                                      |
| --------------- | ------------------ | ---------------------------------------------------------------------------------------------------------- |
| **Logo**        | PNG, JPG           | Headers, receipts and emails. SVG is not accepted, because email clients do not display it                 |
| **Square mark** | PNG, JPG, SVG      | Compact places such as the dashboard header and loading screens, and the icon wallets show when connecting |
| **Favicon**     | PNG, JPG, ICO, SVG | Browser tabs                                                                                               |

Upload the logo, the mark and the favicon. Until an image is uploaded, the OmyPayments image is shown in its place.

### Support contacts

| Field                | Format                  | Where it is used                           |
| -------------------- | ----------------------- | ------------------------------------------ |
| **Support email**    | Email address           | Support blocks in the dashboards, receipts |
| **Support Telegram** | `https://t.me/...` link | Support blocks in the dashboards           |
| **Website**          | URL                     | Receipts                                   |

Contacts are never replaced with ours. A contact you do not set is simply not shown. With neither email nor Telegram set, the support block is hidden.

### Legal documents

| Field                  | Format                                   |
| ---------------------- | ---------------------------------------- |
| **Terms of Use URL**   | `https://` link to the page on your site |
| **Privacy Policy URL** | `https://` link                          |
| **AML Policy URL**     | `https://` link                          |

The documents are shown as links: on sign-up, where the merchant accepts them, and on the merchant dashboard's legal documents page. A document you do not provide is not shown — our documents are never shown under your brand.

### Where your brand appears

| Place                             | What is branded                                                                 |
| --------------------------------- | ------------------------------------------------------------------------------- |
| Merchant dashboard                | Colours, logo, mark, favicon, name, support contacts, legal links               |
| Payment page                      | Colours, logo, mark, favicon, name, support contacts, wallet connection prompts |
| Customer dashboard                | Colours, logo, favicon, name, support contacts                                  |
| Emails to merchants and customers | Logo (or your name), sender name, links to your domain                          |
