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

# Choose your subdomain

> Guide to choosing and editing a Brandless subdomain for your client login URL.

Your subdomain is the URL where your customers sign in and access their dashboard. It's unique to your account and appears as `your-slug.brandless.app`. You can choose it now and change it anytime, though updates will affect any existing customer-facing links.

## Understanding your subdomain

When you set up your account, you pick a slug (like "acme") that becomes your customer login URL: `acme.brandless.app`. This is the address your customers use to access the dashboard. The slug can only contain lowercase letters, numbers, and hyphens — spaces and uppercase letters are automatically converted.

If someone else has already claimed your first choice, the system automatically adds a suffix like `-2` or `-3` to make it unique. You can edit it anytime from the **Branding** section of your settings.

## Steps

<Steps>
  <Step title="Go to Branding settings">
    From the dashboard, navigate to **Branding** in your account menu.
  </Step>

  <Step title="Find the Customer login URL field">
    In the **Profile** section, look for the field labeled **Customer login URL**. Your current slug appears on the left; the platform domain `.brandless.app` appears on the right.
  </Step>

  <Step title="Edit your subdomain">
    Click the field and type your new slug. Spaces are converted to hyphens, and letters are lowercased automatically — so `My-Acme` becomes `my-acme`. Keep it short and memorable for your customers.
  </Step>

  <Step title="Save changes">
    Click **Save changes** at the bottom of the form. Your new login URL is live immediately.
  </Step>
</Steps>

## Important notes

<Warning>
  Changing your subdomain affects any existing bookmarks or links your customers may have saved. If you're already in production, notify your customers of the new URL before updating it.
</Warning>

<Note>
  You can only use lowercase letters, numbers, and hyphens in your slug. Spaces and uppercase letters are automatically converted.
</Note>

<Note>
  If your desired slug is taken, the system will suggest an alternative with a numeric suffix (like `-2`). You can choose a different slug instead.
</Note>

## Next step

Once your subdomain is set, consider upgrading to a custom domain (like `app.yourbrand.com`) for a fully branded experience. A custom domain removes the `.brandless.app` suffix and makes your sign-in page feel like it belongs entirely to your brand.

## Related

* [Set up a custom domain](/docs/your-brand/custom-domain)
* [Custom email sender](/docs/your-brand/custom-email)
* [Getting started](/docs/getting-started/quickstart)