# Set up a client portal

> Give your clients a branded portal where they sign in to view their reports. Set the portal's name and address, then add your logo, favicon, colours and brand theme.

Source: https://mavendata.ai/docs/client-portal

The client portal is where your clients sign in to see the reports you publish for them. You run one portal for your account. Each client user sees only the workspaces you give them access to. Setup has two parts. On **Portal** settings you set the portal's name and web address. On **General** settings you add your brand assets and theme.

You need to be an account admin to change portal settings.

## Set the portal name and address

1. Open the user menu at the bottom of the sidebar, choose **Settings**, then **Portal**.
2. Under **Portal identity & domain**, enter a **Portal display name** and select **Save changes**. If you leave the name blank, the portal uses your company name.
3. In **Subdomain**, enter the address you want, for example `your-company`. Maven shows the full Maven-hosted address next to it.
4. Select **Check availability**. Subdomains must be 3 to 63 characters, using only letters, numbers and hyphens, and can't start or end with a hyphen. Some names are reserved.
5. When Maven confirms the address is available, select **Update address**. The subdomain is saved separately from the rest of the page, and Maven shows the new **Portal URL**.

Once a subdomain is saved, the header shows **Portal Live** (otherwise **Subdomain needed**).

You can also serve the portal from your own domain. See [Use your own domain](https://mavendata.ai/docs/client-portal/custom-domain).

## Add your logo and favicon

1. In **Settings**, open **General** and find **Brand assets**.
2. Select **Upload Logo**. Use a PNG or JPG up to 2MB. SVG and WebP aren't accepted, because the logo also appears in emails.
3. Select **Upload Favicon**. Use a PNG, JPG or WebP up to 2MB. Without a favicon, the browser tab shows your company's initial.

To change either file later, select **Replace Logo** or **Replace Favicon**.

## Set colours and brand theme

Your **Brand theme** is the visual system that the portal, reports and decks inherit.

1. On **General** settings, go to **Brand theme**.
2. Start from your existing brand. Enter your website (for example `acme.com`) and select **Extract from website**, or select **Use existing reports & decks**.
3. Review the **Palette**. Each colour has a role: **Accent** (buttons, links, brand moments), **Ink** (primary text), **Muted** (secondary text), **Surface** (cards and containers), **Canvas** (page background) and **Line** (borders and dividers). Maven derives the remaining colours from your palette when you save.
4. Adjust the fonts if you need to, then select **Save draft** to keep working, or **Publish theme** to apply it.

When you publish, the portal and all workspaces use the theme for new reports and decks. To update existing decks as well, select **Re-theme all decks**. Earlier theme versions can be brought back with **Restore**.

## Choose a portal template

**Portal template**, at the top of **Portal** settings, shows the two starting points for what clients see after they sign in, and which one your live portal runs:

- **Report library**: clients sign in to a library of the reports you share with them. This is the standard portal.
- **Client app**: clients sign in straight to live data for their workspace, with **Overview**, **Attribution** and **Pacing** pages, and still reach their reports.

The client app needs a workspace whose data is on Maven's current data model. Where a workspace is not yet on it, the app's Overview page says the figures are not available for that workspace, and the agent applying the template tells you before anything is published. Contact Maven support about a workspace in that state.

A template is a base to alter, not a fixed design. Each card has a prompt to copy for an AI agent connected to Maven. The agent applies the template in a draft, shows you a preview and asks before publishing, so nothing changes for your clients until you approve it. Sign-in, password and profile pages always stay on the standard portal.

## Other portal settings

**Portal** settings also include:

- **Report card previews**: show report images and data sources on the portal's report cards.
- **Loading screens**: what clients see while pages and reports load.

The emails the portal sends to your clients (**Email sender** and **Email templates**) and **Client sign-in security** (whether client users can turn on MFA, see [Client logins and sharing](https://mavendata.ai/docs/client-portal/sharing-and-access)) are under **General** settings.

## What happens next

1. [Invite your client](https://mavendata.ai/docs/client-portal/sharing-and-access) and give them access to their workspace.
2. [Publish a report](https://mavendata.ai/docs/client-portal/sharing-and-access#publish-a-report-to-the-portal) to the portal.
3. Optionally, [move the portal to your own domain](https://mavendata.ai/docs/client-portal/custom-domain).
