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

# White label FAQs

> Answers to common questions about white label: plans, credentials, branding, builds, embedding, and keeping your builders' apps apart.

Quick answers to the questions that come up most while you set up and run a white label integration. Each answer links to the page with the full details.

## Plans and access

> [accordion] Which plan do I need for white label?
>
> White label is open to workspaces on the [Builder plan](https://docs.base44.com/Account-and-billing/Billing-and-plans.md) and above, and everything on Builder runs on a personal access token alone. Some features need the [Enterprise plan](https://base44.com/enterprise):
>
> * Writing your own [system prompt](https://docs.base44.com/developers/white-label/system-prompt.md)
> * The Admin role
> * The [embedding policy](https://docs.base44.com/Enterprise/Enterprise-SSO-and-app-visibility.md#controlling-app-embedding)

> [accordion] Do I need to ask Base44 to turn white label on?
>
> No. On the Builder plan and above, **White label** is already in your workspace settings.

> [accordion] What terms apply to white label?
>
> The [White Label Terms](https://docs.base44.com/Community-and-support/white-label-terms), on top of the Base44 Terms of Service. You accept them when you turn on white label, in the app or with the API.

> [accordion] Who can change the white label settings?
>
> A workspace owner or admin. The Admin role is only available on Enterprise, so on other plans the workspace owner makes these changes. See [roles and their limits](https://docs.base44.com/Account-and-billing/Managing-your-workspaces.md#roles-and-their-limits).

> [accordion] Can a coding agent set this up for me?
>
> Yes. Paste this message into the AI chat of the app you're adding app building to, such as in the Base44 app editor, or into a coding agent such as Claude Code, Cursor, or Codex, opened on your platform's project: `Set up Base44 white label in my app so my users can build apps under my brand. Use this guide: https://docs.base44.com/developers/white-label/setup/SKILL.md` The agent works through every step, from credentials to a tested integration, and checks each one before moving on. A chat assistant that can't edit code can't run it. You can also copy the prompt, with your workspace ID already in it, from **White label** → **Settings** in your workspace settings. See [use a coding agent](https://docs.base44.com/developers/white-label/overview.md#use-a-coding-agent).

## Credentials

> [accordion] Which credential does my integration need?
>
> A [personal access token](https://docs.base44.com/Workspaces/Personal-access-tokens.md) for the account your integration builds as. It works on every plan, and authenticates every Apps API call, including the ones that sign end users in to an [embedded app](https://docs.base44.com/developers/white-label/embed-the-app.md) and open [live build updates](https://docs.base44.com/developers/white-label/live-updates.md). If your plan includes [workspace API keys](https://docs.base44.com/Enterprise/workspace-secrets.md), you can use one instead for embedding and live updates. See [tenancy and credentials](https://docs.base44.com/developers/white-label/tenancy-and-credentials.md).

> [accordion] Which workspace do I create the token in?
>
> The workspace your integration builds in, not the account's personal workspace. A token only reaches the workspace it was created in, so a token from the personal workspace misses your design system, skills, and plan. Give it **All apps and Superagents** access and **Full access** permission.

> [accordion] Can I still use an account API key?
>
> No. From **October 15, 2026**, account API keys no longer work, and personal access tokens replace them. Create a token, then send it as `Authorization: Bearer <token>` instead of `api_key: <key>`. See [moving from account API keys](https://docs.base44.com/Workspaces/Personal-access-tokens.md#moving-from-account-api-keys).

> [accordion] How do I find my workspace ID?
>
> Open the workspace in Base44, then open the workspace menu at the bottom left and click **Settings**. The workspace ID is the string of characters after `/workspace/` in the browser's address bar. The main **Apps** page address doesn't include it. You can also run [`base44 workspace list`](https://docs.base44.com/developers/references/cli/commands/workspace-list) in the Base44 CLI.

> [accordion] Can my integration's credentials reach the browser?
>
> No. Every call to Base44 goes through your own backend. Keep tokens and keys in your server's environment, and never send them to the browser or show them to your builders.

## Builders and their apps

> [accordion] Do my builders need Base44 accounts?
>
> No. One Base44 account sits behind your whole integration and owns every app your builders create. Your builders sign in to your platform, not to Base44. See [who owns the apps](https://docs.base44.com/developers/white-label/tenancy-and-credentials.md#who-owns-the-apps).

> [accordion] How do I stop builders from seeing each other's apps?
>
> Base44 sees one account behind every build, so it can't tell your builders apart. Record which builder created each app in your own database, and check it before every call that names an app. See [tenancy and credentials](https://docs.base44.com/developers/white-label/tenancy-and-credentials.md).

> [accordion] Can I add custom instructions to an app after it's created?
>
> No. Set `custom_instructions` when you call [Create app](https://docs.base44.com/api-reference/create-app.md). Only the first 10,000 characters are sent to the agent. See [custom instructions](https://docs.base44.com/developers/white-label/custom-instructions.md).

## Brand and system prompt

> [accordion] Can I configure white label with the API?
>
> Yes. With a personal access token from a workspace owner or admin, or a [workspace API key](https://docs.base44.com/Enterprise/workspace-secrets.md) if your plan includes them, you can turn white label on, set your brand and agent names, and turn on **Use design system** with the [white label settings endpoint](https://docs.base44.com/developers/white-label/brand.md#use-the-api). On Enterprise, the same endpoint sets your own system prompt. You can also set up your [design system](https://docs.base44.com/developers/white-label/brand.md#with-the-api) and your [workspace skills](https://docs.base44.com/developers/white-label/skills-and-mcp.md#manage-skills-with-the-api) with the API.

> [accordion] Which apps follow my white label settings?
>
> Every app built or edited in your workspace, once white label is on. New apps follow them from the first build, and existing apps from their next build turn. When you turn white label off, apps go back to Base44 from the next message. See [set your brand](https://docs.base44.com/developers/white-label/brand.md).

> [accordion] Do I need to write my own system prompt to white label?
>
> No. To put your name on the agent, set your [brand](https://docs.base44.com/developers/white-label/brand.md). Writing your own [system prompt](https://docs.base44.com/developers/white-label/system-prompt.md) is optional, needs Enterprise, and replaces the guidance the agent uses to build with Base44's database, sign-in, and backend functions.

> [accordion] Why don't new apps use my design system?
>
> While white label is on, apps use your default design system only when **Use design system** is also on, in the **Design system** card of your white label settings. See [set your design system](https://docs.base44.com/developers/white-label/brand.md#set-your-design-system).

> [accordion] When does a new system prompt take effect?
>
> From the next build turn, including the next turn in a conversation that's already under way.

## Builds

> [accordion] Why does my build look stuck?
>
> The agent may be waiting on a question. It can stop and wait indefinitely for an answer, and nothing else moves until you send one. Check the transcript for a tool call whose `status` is `waiting_for_user_input`. See [the build turn](https://docs.base44.com/developers/white-label/the-build-turn.md).

> [accordion] Why do my build requests time out?
>
> A build turn takes from around thirty seconds to several minutes, so a 30-second client timeout cuts working builds off. Allow at least 120 seconds for Create app, Send chat message, Submit tool-call input, and Deploy an app. Before retrying, check whether the app or message already exists.

> [accordion] How many apps can I create at once?
>
> App creation is capped at 5 requests per minute. Queue bursts instead of sending them in parallel.

> [accordion] Do builds use credits?
>
> Yes. Every build turn draws on your workspace's [credits](https://docs.base44.com/Account-and-billing/Credits.md). Send the same `X-Request-ID` when you retry a request, so a retry isn't charged twice.

## Embedding

> [accordion] Why won't the app load in my iframe?
>
> Check your workspace's [embedding policy](https://docs.base44.com/Enterprise/Enterprise-SSO-and-app-visibility.md#controlling-app-embedding). If it's set to **Only these sites**, add your platform's website to the list. With **No one**, no website can embed your apps.

> [accordion] Why does minting a sign-in token fail with privileged\_user?
>
> The email belongs to the app's owner, an editor, or a service account, including the account your integration builds as. Sign-in tokens are for end users only. See [embed the app](https://docs.base44.com/developers/white-label/embed-the-app.md#errors).

> [accordion] Do I need a sign-in token for every app?
>
> Only for apps that ask people to sign in. An app set to **Public (no login)** loads directly, without a token. See [deciding whether you need a token](https://docs.base44.com/developers/white-label/embed-the-app.md#decide-if-you-need-a-token).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.