Skip to content

feat: Add section for organization slug #2672

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Oct 9, 2025
+17 −1
Merged

feat: Add section for organization slug #2672

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
10f8ab9
Add section on organizations overview
LauraBeatris Oct 3, 2025
bc32380
Add as step on org slugs guide
LauraBeatris Oct 3, 2025
ec3214b
docs review
SarahSoutoul Oct 3, 2025
d1b4e26
Merge branch 'main' into laura/orgs-931-update-documentation-guide-fo…
SarahSoutoul Oct 8, 2025
57623c0
Update cutoff date
LauraBeatris Oct 8, 2025
335f825
Change date to written format
SarahSoutoul Oct 8, 2025
a456650
Merge branch 'main' into laura/orgs-931-update-documentation-guide-fo…
SarahSoutoul Oct 8, 2025
070e79f
Remove the suffixes
SarahSoutoul Oct 8, 2025
49258a0
Update docs/guides/organizations/overview.mdx
alexisintech Oct 8, 2025
03f4687
Merge branch 'main' into laura/orgs-931-update-documentation-guide-fo…
SarahSoutoul Oct 8, 2025
459d985
Update docs/guides/organizations/overview.mdx
alexisintech Oct 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/guides/organizations/org-slugs-in-urls.mdx
View file
Open in desktop
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
11 changes: 11 additions & 0 deletions docs/guides/organizations/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,17 @@ To enable personal accounts for your application, toggle **Allow personal accoun
> [!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.

## 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.

> [!IMPORTANT]
> Organization slugs are disabled by default for applications created after 10-06-2025. For applications created before this date, you can opt to disable it.
Copy link
Contributor

Choose a reason for hiding this comment

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

What's the rules with date formats? I can see some places in the docs where the numeric format is used and others where the written format ("October 6, 2025") is used. Personally, I prefer the written format as diff countries have diff numeric formats for dates. But yeah curious on this one @alexisintech ?

Copy link
Member

Choose a reason for hiding this comment

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

I agree with written format!

Copy link
Contributor

Choose a reason for hiding this comment

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

Speaking from my past role, I'd +1 the written out format too. It's the safest default.

If we change this one to October 6, 2025, can we update the 08-22-2025 right above this too on line 68 for consistency?

Note

If we wanted to get crazy fancy, we could create a <Date> component that uses Date.prototype.toLocaleDateString() to format the date in the reader's preference.

Copy link
Contributor

@SarahSoutoul SarahSoutoul Oct 8, 2025 •
edited
Loading

Choose a reason for hiding this comment

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

Done: Change date to written format.

I like the idea of the <Date> component in the long run @manovotny!

Copy link
Contributor

@manovotny manovotny Oct 8, 2025 •
edited
Loading

Choose a reason for hiding this comment

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

LOL! You did something different than what you suggested. October 6, 2025 ≠ October 6th, 2025.

It's @alexisintech's call, but IMO, I wouldn't use nd, th, etc in the dates.

Copy link
Contributor

Choose a reason for hiding this comment

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

Remove the nd and th. @alexisintech let me know what you think!

Copy link
Member

Choose a reason for hiding this comment

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

agree, just use numbers.

the date component could be cool - wanna create a ticket @manovotny

Copy link
Contributor

Choose a reason for hiding this comment

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

the date component could be cool - wanna create a ticket @manovotny

https://linear.app/clerk/issue/DOCS-11049/add-a-date-component-for-displaying-dates-in-readers-preferred-date


## Active organization

When a user is a member of an organization, they can switch between different organizations. The organization workspace that a user is currently viewing is called the **active organization**. The active organization determines which organization-specific data the user can access and which role and related permissions they have within the organization.
Expand Down