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

> ## Agent Instructions
> OwnPay is licensed under AGPL-3.0 and is completely free - no licensing fees.
> Production docs URL: https://ownpay.org/docs - append .md to any page URL for clean markdown.
> OwnPay requires PHP 8.3+, MySQL/MariaDB, and Redis.
> MCP server available at https://ownpay.org/docs/mcp for programmatic documentation queries.
> Use root-relative links (e.g. /quickstart) for internal navigation - do NOT include /docs prefix.
> Plugin development: consult /developer/plugins/ pages for correct interfaces and manifests.
> Canonical locations: API auth = /api/authentication, webhook verification = /api/webhooks, rate limits = /resources/rate-limiting, transaction statuses = /fundamentals/payment-flow.
> The documentation uses the Diataxis framework: Tutorials (learning), How-to (tasks), Reference (lookup), Explanation (understanding).

# Create and manage brands

> How to create, configure, and assign gateways and staff to brands in OwnPay for multi-tenant payment operations.

Brands are the core organizational unit in OwnPay. Each brand operates as an independent payment storefront with its own currency, gateways, checkout appearance, and staff assignments. If you are new to the brand concept, read the [explanation in /fundamentals/brands](/docs/fundamentals/brands) first.

## Create a brand

1. Log in to the admin dashboard as a super admin.
2. Go to **People** → **Brands** in the sidebar.
3. Click **+ Add Brand**.
4. Fill in the brand details (see the table below).
5. Click **Create** to save.

## Configure brand settings

After creating a brand, click **Edit** on the brand row to adjust its configuration.

| Setting              | Type         | Required | Description                                                                     |
| -------------------- | ------------ | -------- | ------------------------------------------------------------------------------- |
| **Business name**    | Text         | Yes      | Public-facing name shown on checkout and invoices                               |
| **Slug**             | Text         | Yes      | URL-safe identifier (lowercase, hyphens only)                                   |
| **Default currency** | Select       | Yes      | Base currency for the ledger and checkout (for example USD, BDT, EUR)           |
| **Timezone**         | Select       | Yes      | Timezone for reports, invoice due dates, and transaction timestamps             |
| **Contact email**    | Email        | No       | General support email displayed to customers                                    |
| **Phone**            | Text         | No       | Public contact phone number                                                     |
| **Status**           | Select       | Yes      | `Active` (live), `Suspended` (blocks checkout), or `Pending`                    |
| **Custom domain**    | Text         | No       | Fully qualified domain for white-label checkout (for example `pay.example.com`) |
| **Logo**             | File upload  | No       | Brand logo on checkout. Recommended: 200×60 px PNG                              |
| **Primary color**    | Color picker | No       | Accent color for checkout buttons and links                                     |
| **Support email**    | Email        | No       | Where customer support queries route from checkout                              |

## Assign gateways to a brand

1. Open the brand editor by clicking **Edit**.
2. Navigate to the **Gateways** section.
3. Toggle the payment gateways you want to enable for this brand.
4. Only gateways that support the brand’s default currency will appear as options.
5. Click **Save**.

<Note>
  A gateway must be configured globally under **Gateways & Currencies** before you can assign it to a brand. Brand assignment controls which gateways appear at checkout for that brand.
</Note>

## Assign staff members

1. Go to **People** → **Staff**.
2. Click **Edit** on the staff member’s row.
3. In the brand assignment section, select the brands this staff member can access.
4. Choose the role level for each brand.
5. Click **Save**.

Staff members only see data for the brands they are assigned to. A staff member with no brand assignments cannot access any payment data.

<Warning>
  Do not change the default currency of a brand after transactions have been processed. This causes inconsistencies in your ledger and reporting.
</Warning>

## Related Pages

* [Brands concept](/docs/fundamentals/brands) - explanation of how brands work in OwnPay
* [Staff](/docs/people/staff) - invite and manage team members
* [Roles](/docs/people/roles) - built-in roles and permission matrix
* [Payment gateways](/docs/gateways/configuration) - configure gateway credentials
* [Domains](/docs/system/domains) - verify DNS for custom brand domains


## Related topics

- [Brands - Multi-Tenant Merchant Isolation](/docs/fundamentals/brands.md)
- [Domains](/docs/system/domains.md)
- [Create and manage invoices](/docs/payments/invoices.md)
- [Quickstart - Accept Your First Payment in 5 Minutes](/docs/quickstart.md)
- [Invite and manage staff](/docs/people/staff.md)