Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Organization Management & Workspace Switching

Shaf's multi-tenant architecture is organized into Organizations — fully isolated workspaces for different teams, clients, or projects.

What's Sandboxed per Organization

Each organization is a completely isolated workspace with its own:
Custom Domains
Branded short link domains are owned by the organization, not the individual user account.
Links & Tags
All short links, tags, and link groups belong exclusively to the organization.
Analytics
Click events, realtime dashboards, and analytics exports are scoped to the organization.
Team & RBAC
Members, role assignments, and invitation management are per-organization.
Billing
Each organization has its own independent Stripe subscription and billing history.

Creating a New Organization

    Open the Organization Switcher

    In the Shaf Dashboard, click on your current organization name at the top of the left sidebar. A dropdown menu appears.

    Create the Organization

    Select + Create Organization from the dropdown.

    Configure the Workspace

    FieldDescriptionExample
    Organization NameDisplay name shown in the dashboardAcme Corp Marketing
    Identifier (slug)URL-safe unique identifier for the orgacme-marketing

    Enter the New Workspace

    Click Create. The interface switches immediately into the new workspace — it starts empty with no links, domains, or members.

Switching Between Organizations

Click your organization name in the top of the sidebar to open the switcher. All organizations you are a member of (in any role) are listed. Click any organization name to switch context instantly.
If you manage links for multiple clients, create a separate organization per client. This ensures complete data isolation and allows each client to have their own billing, domains, and team members.

Workspace Settings

To customize your organization profile:
  1. Navigate to Settings → General.
  2. Available settings:
SettingDescription
Organization NameDisplay name in the dashboard and emails
Default Short DomainThe domain auto-selected when creating new links
Notification EmailWhere quota alerts and system notifications are sent

Deleting an Organization

Caution
Deleting an organization permanently removes all associated short links, domain configurations, API keys, webhooks, and historic analytics. This operation cannot be undone.

    Open Danger Zone

    Navigate to Settings → Danger Zone.

    Initiate Deletion

    Click Delete Organization (only visible to the Organization Owner).

    Confirm by Typing the Organization Name

    Type the exact organization name into the confirmation field to enable the final delete button.

    Subscription Cancellation

    The active Stripe subscription is canceled at the end of the current billing period. No further charges will occur.

Troubleshooting

I was added to an organization but cannot see it in the workspace switcher
Confirm you are logged in with the same email address that received the invitation. Organizations are account-scoped — logging in with a different provider (e.g. Google OAuth vs. email+password) creates a separate account even with the same email address.
I cannot create a new organization (button disabled or quota reached)
Some plans limit the number of organizations per account. Check Settings → Billing for your current plan's organization limit. Upgrading to the Pro or Enterprise plan removes this restriction.