>
interface WelcomeProps {
loaderData: LoaderData
}
export function Welcome({ loaderData }: WelcomeProps) {
if (!loaderData || loaderData instanceof Response) return null
return (
Welcome to the {loaderData.organization?.name} Organization
Your role in this organization: {loaderData.orgRole}
)
}
```
**Client-side**
Use the [useOrganization()](https://clerk.com/docs/react-router/reference/hooks/use-organization.md) hook to access information about the currently Active Organization. Use the [useOrganizationList()](https://clerk.com/docs/react-router/reference/hooks/use-organization-list.md) hook to access information about the current user's Organization memberships.
filename: src/welcome/welcome.tsx
```tsx
import { useOrganization, useOrganizationList } from '@clerk/react-router'
export function Welcome() {
const { organization } = useOrganization()
const { userMemberships } = useOrganizationList({
userMemberships: true,
})
return (
Welcome to the {organization?.name} organization
Your role in this organization:{' '}
{
userMemberships?.data?.find(
(membership) => membership.organization.id === organization?.id,
)?.role
}
)
}
```
3. ## Visit your app
Run your project with the following command:
```npm
npm run dev
```
Visit your app locally at [localhost:5173](http://localhost:5173).
When you visit your app, Clerk will prompt you to enable Organizations.
4. ### Enable Organizations
When prompted, select **Enable Organizations**. Choose to make membership required.
5. ### Create first user and Organization
You must sign in to use Organizations. When prompted, select **Sign in to continue**. Then, authenticate to create your first user.
Since you chose to make membership required when you enabled Organizations, every user must be in at least one Organization. Clerk will prompt you to create an Organization for your user.
6. ## Create and switch Organizations
At this point, Clerk should have redirected you to a page with the [](https://clerk.com/docs/react-router/reference/components/organization/organization-switcher.md) component. This component allows you to create, switch between, and manage organizations.
1. Select the `` component, then **Create an organization**.
2. Enter `Acme Corp` as the Organization name.
3. Invite users to your Organization and select their Role.
7. ## Protect routes by Organization and Roles
You can protect content and even entire routes based on Organization membership, Roles, and Permissions by performing authorization checks.
In the following example, the page is protected from unauthenticated users, users that don't have the `org:admin` Role, and users that are not in the `Acme Corp` Organization. It uses the [`has()`](https://clerk.com/docs/reference/backend/types/auth-object.md?sdk=react-router#has) helper to perform the authorization check for the `org:admin` Role.
**Server-side**
filename: app/routes/protected.tsx
```tsx
import { clerkClient, getAuth } from '@clerk/react-router/server'
import { redirect } from 'react-router'
import type { Route } from '../+types/protected'
export function meta({}: Route.MetaArgs) {
return [
{ title: 'Protected Page' },
{ name: 'description', content: 'A protected page requiring admin access' },
]
}
export async function loader(args: Route.LoaderArgs) {
// Use the `getAuth()` helper to access the `Auth` object
// https://clerk.com/docs/reference/backend/types/auth-object
const { isAuthenticated, orgId, has } = await getAuth(args)
// Check if the user is authenticated
if (!isAuthenticated) {
return redirect('/sign-in?redirect_url=' + args.request.url)
}
// Check if there is an Active Organization
if (!orgId) return { error: 'Set an Active Organization to access this page.' }
// Check if the user has the `org:admin` Role
if (!has({ role: 'org:admin' })) return { error: 'You must be an admin to access this page.' }
// Initialize clerkClient
// Use the `getOrganization()` method to get the Backend `Organization` object
const organization = await clerkClient(args).organizations.getOrganization({
organizationId: orgId,
})
// Check if Organization name matches (e.g. 'Acme Corp')
const requiredOrgName = 'Acme Corp'
if (organization.name !== requiredOrgName)
return {
error: `This page is only accessible in the ${requiredOrgName} Organization. Switch to the ${requiredOrgName} Organization to access this page.`,
}
return { organization }
}
export default function Protected({ loaderData }: Route.ComponentProps) {
return (
You are currently signed in as an admin in the{' '}
{loaderData?.organization?.name} Organization.
)
}
```
**Client-side**
filename: app/routes/protected.tsx
```tsx
import type { Route } from './+types/protected'
import { useAuth, useOrganization } from '@clerk/react-router'
export function meta({}: Route.MetaArgs) {
return [
{ title: 'Protected Page' },
{ name: 'description', content: 'A protected page requiring admin access' },
]
}
export default function Protected() {
const { isSignedIn, has } = useAuth()
const { organization } = useOrganization()
// Check if the user is authenticated
if (!isSignedIn) return You must be signed in to access this page.
// Check if there is an Active Organization
if (!organization) return Set an Active Organization to access this page.
// Check if the user has the `org:admin` Role
if (!has({ role: 'org:admin' })) return You must be an admin to access this page.
// Check if Organization name matches (e.g., "Acme Corp")
const requiredOrgName = 'Acme Corp'
if (organization.name !== requiredOrgName)
return (
This page is only accessible in the {requiredOrgName} Organization. Switch
to the {requiredOrgName} Organization to access this page.
)
return (
You are currently signed in as an admin in the{' '}
{organization.name} Organization.
)
}
```
Update your routes configuration to show the `` component when you navigate to `/protected`.
filename: app/routes.ts
```tsx
import { type RouteConfig, index, route } from '@react-router/dev/routes'
export default [
index('routes/home.tsx'),
route('protected', 'routes/protected.tsx'),
] satisfies RouteConfig
```
Navigate to [localhost:5173/protected](http://localhost:5173/protected). You should see a green message confirming you are an admin in `Acme Corp`. Use the `` to switch Organizations or rename the Organization to show the red message.
Learn more about protecting routes and checking Organization Roles in the [authorization guide](https://clerk.com/docs/guides/organizations/control-access/roles-and-permissions.md?sdk=react-router).
8. ## It's time to build your B2B SaaS!
You've added Clerk Organizations to your app 🎉.
Here are some next steps you can take to scale your app:
- **Control access** with [Custom Roles and Permissions](https://clerk.com/docs/guides/organizations/control-access/roles-and-permissions.md?sdk=react-router): define granular Permissions for different user types within Organizations.
- **Onboard entire companies** with [Verified Domains](https://clerk.com/docs/guides/organizations/add-members/verified-domains.md?sdk=react-router): automatically invite users with approved email domains (e.g. `@company.com`) to join Organizations without manual invitations.
- **Enable Enterprise SSO** with [SAML and OIDC](https://clerk.com/docs/guides/organizations/add-members/sso.md?sdk=react-router): let customers authenticate through their identity provider (e.g. Okta, Entra ID, Google Workspace) with unlimited connections, no per-connection fees.
---
## Sitemap
[Overview of all docs pages](https://clerk.com/docs/llms.txt)