# Branding & Customization

Customize the look and feel of your AccessIQ login pages, emails, and user-facing screens to match your brand.

## Branding Settings

1. Go to **Settings > Branding**.
2. Configure the options below.
3. Click **Save**.
4. Preview your changes using the **Preview** button.

## Customizable Elements

### Logo and Favicon

| Setting | Description                         | Recommended size         |
| ------- | ----------------------------------- | ------------------------ |
| Logo    | Displayed on login pages and emails | 200 x 50 px (PNG or SVG) |
| Favicon | Browser tab icon                    | 32 x 32 px (ICO or PNG)  |

Upload your files or provide a URL.

### Colors

| Setting          | Description                         |
| ---------------- | ----------------------------------- |
| Primary color    | Buttons, links, and active elements |
| Background color | Page background                     |
| Text color       | Primary text                        |
| Accent color     | Highlights and secondary actions    |

Enter hex color codes (e.g., `#1A73E8`) or use the color picker.

### Login Page

| Setting          | Description                                   |
| ---------------- | --------------------------------------------- |
| Layout           | Centered, side-by-side, or full-width         |
| Background image | Optional image behind the login form          |
| Welcome text     | Custom heading displayed above the login form |
| Footer text      | Custom text at the bottom of the login page   |

### Email Templates

Customize the appearance of system emails (verification, password reset, magic links):

| Setting      | Description                                                 |
| ------------ | ----------------------------------------------------------- |
| Header logo  | Logo shown at the top of emails                             |
| Button color | Color of action buttons in emails                           |
| Footer text  | Custom footer content (e.g., company address, support link) |

## Custom Domain

Use your own domain for login pages instead of the default `<tenant>.accessiq.app`:

1. Go to **Settings > Branding > Custom Domain**.
2. Enter your domain (e.g., `login.yourcompany.com`).
3. Add the provided DNS records (CNAME) to your domain registrar.
4. Click **Verify** once the DNS records are in place.
5. AccessIQ provisions an SSL certificate automatically.

## Best Practices

* Use your brand's primary color for buttons to create a consistent experience.
* Keep the login page clean and uncluttered -- users should immediately recognize where to sign in.
* Test your branding on both desktop and mobile devices.
* Verify email branding by sending test emails to yourself.


---

# Agent Instructions: 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:

```
GET https://accessiq.gitbook.io/accessiq-docs/workspace-settings/branding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.