Skip to content
5 changes: 5 additions & 0 deletions docs/guides/organizations/org-slugs-in-urls.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,11 @@ metadata:
title: "Enable organizations for your instance",
link: "/docs/guides/organizations/overview",
icon: "globe",
},
{
title: "Enable organization slugs for your application",
link: "/docs/guides/organizations/overview#organization-slugs",
icon: "globe",
}
]}
exampleRepo={[
Expand Down
13 changes: 12 additions & 1 deletion docs/guides/organizations/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,18 @@ Most multi-tenant applications want every user to be part of an organization rat
To enable personal accounts for your application, toggle **Allow personal accounts** in the [**Organizations Settings**](https://dashboard.clerk.com/last-active?path=organizations-settings) page.

> [!IMPORTANT]
> Personal accounts being disabled by default was released on 08-22-2025. Applications created before this date will not be able to see the **Allow personal accounts** setting, because personal account were enabled by default.
> Personal accounts being disabled by default was released on August 22, 2025. Applications created before this date will not be able to see the **Allow personal accounts** setting, because personal account were enabled by default.

## Organization slugs

Organization slugs are human-readable URL identifiers that help users reference which organization they're working in.

To enable it on your application, toggle **Enable organization slugs** in the [**Organizations Settings**](https://dashboard.clerk.com/last-active?path=organizations-settings) page.

If disabled, organization slugs won't be displayed in the [`<CreateOrganization />`](/docs/reference/components/organization/create-organization), [`<OrganizationList />`](/docs/reference/components/organization/organization-list), and [`<OrganizationSwitcher />`](/docs/reference/components/organization/organization-switcher) components.
Copy link
Member

@alexisintech alexisintech Oct 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's a given that if org slugs are disabled, they won't appear for an application. because they are disabled.
It'd make more sense to tell users what the behavior will be if they enable the feature.

Suggested change
If disabled, organization slugs won't be displayed in the [`<CreateOrganization />`](/docs/reference/components/organization/create-organization), [`<OrganizationList />`](/docs/reference/components/organization/organization-list), and [`<OrganizationSwitcher />`](/docs/reference/components/organization/organization-switcher) components.
When enabled, organization slugs will be displayed in the [`<CreateOrganization />`](/docs/reference/components/organization/create-organization), [`<OrganizationList />`](/docs/reference/components/organization/organization-list), and [`<OrganizationSwitcher />`](/docs/reference/components/organization/organization-switcher) components.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Love the change in phrasing from negative to positive.


> [!IMPORTANT]
> Organization slugs are disabled by default for applications created after October 7, 2025. For applications created before this date, you can opt to disable it.

## Active organization

Expand Down