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

# Publish apps with branded URLs

> Give every app in your workspace a consistent, branded address on vibelyagent.com.

Branded app URLs let your workspace publish apps under a shared, recognizable address pattern instead of a plain `your-app.vibelyagent.com`. You pick one branded subdomain for the workspace, and every app published from it uses it.

<Frame>
  <img src="https://cdn.vibely.sh/doc/v1/deploy-branded-urls.webp" alt="Publish apps with branded URLs" width="1200" height="675" />
</Frame>

When enabled, your app URLs follow this format:

`https://<app-name>--<workspace>.vibelyagent.com`

For example, if your workspace's branded subdomain is `acme`, a project published as `dashboard` lives at `dashboard--acme.vibelyagent.com`.

* **Available on:** Business and Enterprise plans
* **Location:** **Settings → *your workspace name* → Branded app URLs**

## Why use branded app URLs

* Every app in the workspace has a consistent, recognizable address.
* Clients and teammates can tell at a glance which apps are yours.
* Apps stay branded before, or instead of, setting up [custom domains](/features/deploy/custom-domain).

## Set up branded app URLs

<Note>
  A workspace has one branded subdomain.
</Note>

<Steps>
  <Step title="Choose your branded subdomain">
    Go to **Settings → *your workspace name* → Branded app URLs**. Type your subdomain in the field (for example `acme`). The card shows a preview of your app addresses.

    The subdomain must be 3–63 characters: lowercase letters, numbers and single hyphens, with no hyphen at the start or end and no double hyphen. Common words like `www`, `api`, `app`, `admin` and `docs` are reserved, and each subdomain can be used by only one workspace.
  </Step>

  <Step title="Save">
    Click **Save**. There's nothing to provision: the address works as soon as you publish.
  </Step>

  <Step title="Publish your apps">
    [Publish](/features/deploy/publish) as usual. The branded address applies to each app the next time it's published, so republish existing apps with **Update** to move them to the branded pattern.
  </Step>
</Steps>

### Which URL your app uses

* Apps published after you save use `<app-name>--<workspace>.vibelyagent.com`.
* Apps that were already live switch at their next publish.
* A project can also have a [custom domain](/features/deploy/custom-domain). Custom domains keep working alongside the branded address.

## Turn off branded app URLs

Clear the field in **Settings → *your workspace name* → Branded app URLs** and click **Save**. Apps go back to the plain `<app-name>.vibelyagent.com` pattern the next time they're published.

## Troubleshooting

<AccordionGroup>
  <Accordion title="I can't turn on branded app URLs">
    Check that your workspace is on Business or Enterprise. The field is locked on other plans.
  </Accordion>

  <Accordion title="That branded subdomain is already taken">
    Another workspace uses it. Pick a variation, such as your company name plus a suffix.
  </Accordion>

  <Accordion title="My app still shows the old address">
    The branded address applies at publish time. Open **Publish** and click **Update**.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Publish" icon="rocket" href="/features/deploy/publish">
    Put your app live and push updates.
  </Card>

  <Card title="Custom domain" icon="globe" href="/features/deploy/custom-domain">
    Serve an app on a domain you own.
  </Card>

  <Card title="Admin settings" icon="gear" href="/features/workspace/admin-settings">
    Other workspace-wide settings.
  </Card>

  <Card title="Enterprise" icon="building" href="/introduction/enterprise">
    Vibely for larger organizations.
  </Card>
</CardGroup>


## Related topics

- [Connect a custom domain](/features/deploy/custom-domain.md)
- [How Vibely hosts your app](/features/deploy/hosting.md)
- [Workspace admin settings](/features/workspace/admin-settings.md)
- [Web App Mode](/features/web-apps/overview.md)
- [Glossary](/glossary.md)


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