Ascend Documentation

Appearance

Managing Workspaces ​

Creating a Workspace ​

  1. Click the workspace dropdown (on /pages or /databases)
  2. Click "+ New Workspace"
  3. Fill in the details:
    • Name: Clear, descriptive name
    • Icon: Choose an emoji or icon
    • Color: Optional visual identifier
  4. Click "Create"

Editing a Workspace ​

Currently, workspaces can be edited via the API. UI editing coming soon.

Deleting a Workspace ​

⚠️ Important: Deleting a workspace does NOT delete the pages/databases in it. They become unassigned and appear in "No workspace".

Best Practices ​

✅ Do's ​

  1. Keep It Simple

    • Start with 2-3 workspaces
    • Add more only when needed
    • Don't over-organize

  2. Use Clear Names

    • "Work" not "W"
    • "Client Projects" not "CP"
    • Make it obvious at a glance

  3. Choose Distinctive Icons

    • Different icon per workspace
    • Makes sidebar scanning easier
    • Visual recognition is faster

  4. Combine with Tags

    • Workspaces for broad categories
    • Tags for specific attributes
    • Use both for powerful filtering

  5. Regular Cleanup

    • Review workspace assignments monthly
    • Move completed projects to archive workspace
    • Delete unused workspaces

❌ Don'ts ​

  1. Don't Create Too Many

    • More than 15-20 becomes unwieldy
    • Hard to remember which is which
    • Defeats the purpose of organization

  2. Don't Use for Permissions

    • Workspaces don't restrict access
    • Use the permissions system instead
    • Everyone sees all workspaces

  3. Don't Forget to Assign

    • New content should go in a workspace
    • "No workspace" should be temporary
    • Unassigned content is harder to find

  4. Don't Duplicate Tag Function

    • If tags already categorize it, don't create workspace
    • Example: Don't create "Urgent" workspace if you have "Urgent" tag
    • Workspaces are for broader organization

Workspace Naming Conventions ​

Use prefixes for grouped workspaces:

  • "Client - Acme Corp"
  • "Client - TechStart"
  • "Project - Website Redesign"
  • "Project - Mobile App"

Archive Pattern ​

Create an "📦 Archive" workspace for completed work:

  • Move finished projects there
  • Keeps active workspaces clean
  • Easy to find historical content

How many workspaces can I create?

  • No hard limit
  • Recommended: 5-15 for optimal organization
  • Too many workspaces can become hard to manage
  • Consider using tags instead for fine-grained categorization

Can I set a default workspace for new content?

  • When creating content, the currently selected workspace is pre-selected
  • Navigate via sidebar to have that workspace pre-selected
  • The "General" workspace is the system default