Workspaces

Create a workspace

Create a workspace to organize a new team or project.

Where to find it

  • Workspace switcher in the dashboard header

Steps

  1. Open the workspace switcher.
  2. Select Create a new workspace.
  3. Enter a workspace name.
  4. Confirm to create the workspace.

Notes

  • A default collection named Links is created automatically.
  • You become the owner of the new workspace.
  • The new workspace becomes active right away.

Creation is blocked if you reach the ownership limit.

Workspace name rules

Workspace names keep your switcher readable and organized.

Rules

  • Name is required.
  • Maximum length is 32 characters.

Examples

  • Marketing
  • Client A
  • Product Team

Tips

  • Keep names short for easier switching.

Workspace slug rules

Workspace slugs appear in URLs and must be unique.

Rules

  • Slug is required.
  • Length must be between 3 and 32 characters.
  • Slug must be unique across workspaces.

Tips

  • Use lowercase letters, numbers, and hyphens for clarity.

Update workspace name

Update the workspace name to keep it recognizable in the switcher.

Where to find it

  • Dashboard → Settings → Workspace

Steps

  1. Open Workspace settings.
  2. Edit the workspace name.
  3. Save the changes.

Notes

  • Maximum length is 32 characters.

Update workspace slug

Update the workspace slug to change its URL identifier.

Where to find it

  • Dashboard → Settings → Workspace

Steps

  1. Open Workspace settings.
  2. Edit the workspace slug.
  3. Save the changes.

Notes

  • Slug length must be 3–32 characters.
  • Slug must be unique.

Update workspace image

Upload a new image to represent the workspace.

Where to find it

  • Dashboard → Settings → Workspace

Steps

  1. Open Workspace settings.
  2. Choose a new image file.
  3. Wait for the upload to finish.
  4. Save the changes.

Notes

  • PNG, JPG, or SVG files only.
  • Maximum size is 2 MB.
  • The image is stored as a hashed file name.

Workspace image rules

Workspace images follow these rules to keep storage consistent.

Rules

  • Allowed types: PNG, JPG, or SVG.
  • Maximum file size is 2 MB.
  • File name uses a SHA256 hash and is stored as hash.png.
  • Storage path is avatar/{workspaceId}/hash.png.
  • The database stores only hash.png.

Tips

  • Use a square image for consistent avatars.
  • Keep the file size small for faster upload.

Workspace ownership limits

Workspaces have ownership limits to keep accounts manageable.

Default limit

  • The default policy allows up to two owned workspaces per profile.

What happens at the limit

  • Creating new workspaces is blocked.
  • You can still be invited to other workspaces.

Transfer ownership if you need to stay within the limit.

Troubleshooting

Use these fixes when workspace actions fail.

Failed to create workspace

  • Check the workspace name length.
  • Confirm you have not reached the ownership limit.
  • Try again after refreshing.

Workspace name rejected

  • Keep the name under 32 characters.
  • Avoid empty names.

Workspace slug rejected

  • Use 3–32 characters.
  • Pick a unique slug.

Failed to update workspace image

  • Use PNG, JPG, or SVG.
  • Keep the file under 2 MB.
  • Retry the upload.