> ## Documentation Index > Fetch the complete documentation index at: https://docs.supaboard.ai/llms.txt > Use this file to discover all available pages before exploring further. > Manage your workspace, teammates, permissions, usage, and billing. # Workspaces A **Workspace** is your organisation's private environment inside Supaboard. Every resource you create — dashboards, data sources, agents, automations, datasites, team members — belongs to a single workspace. You can be a member of multiple workspaces and switch between them at any time. ## Before you begin Open **Settings** from the sidebar to manage the active workspace. Your role determines which settings you can change. For a specific task, use the guides below. Set roles, feature access, and data access. Read activity, plan allowance, and subscription details. ## Creating a Workspace You can create as many workspaces as you need — for example, one per product, client, or environment. ### How to create one 1. Click your workspace name at the top of the sidebar to open the workspace menu. 2. Choose **Switch Workspace**, then **New Workspace**. 3. Enter a **Workspace Name** in the **Create New Workspace** dialog and confirm. That is the whole form — name only. You become the **Owner** of any workspace you create. ### Regions New workspaces are provisioned in **North America** (`us-central-1`). The region is shown, read-only, on the workspace settings page. Supaboard also operates **Asia** (`ap-south-1`) and **Europe** (`eu-central-1`) regions; if you need one of those, talk to your account manager before creating the workspace. > **Region cannot be changed after a workspace is created.** ## Configuring Your Workspace Navigate to **Settings → Workspace**. | Field | Notes | | - | - | | **Workspace name** | Human-readable label, shown in the sidebar and switcher | | **Region** | Read-only — see above | | **Industry** | Used to tailor onboarding and AI defaults | | **Team Size** | Used to tailor onboarding and AI defaults | | **Require two-factor authentication** | See below | Your workspace image is uploaded from a separate section on the same page. ### Requiring two-factor authentication **Require two-factor authentication** — *"Require members to enable MFA to access this workspace."* Turning this on is itself protected: you are asked for a 6-digit code from your authenticator app to confirm the change. Once on, every member must set up MFA before they can access the workspace. Members below Admin see the setting as a read-only line: *"Mfa has been enabled by your system admin/owner"*. ### Permissions required Only **Admin** or **Owner** can edit workspace settings. ## Inviting Team Members Navigate to **Settings → Team Members** and click **Invite Members**. You can invite several people in one batch. ### What you configure per invite #### Role Controls what actions they can take across the workspace — see [Roles and permissions](#roles-and-permissions). Options are **Viewer**, **Editor**, and **Admin**. > Editors and Admins consume a **billable seat**; Viewers are free. The invite form shows the cost per row before you send — see [Seats and billing](#seats-and-billing). #### Which features they can use Restrict which parts of Supaboard they can use. Leave it on **All features** for unrestricted access within their role. See [Feature Access](#feature-access) for how this interacts with roles. | Feature | What it unlocks | | - | - | | **Ask Analysts** | The conversational AI interface | | **Dashboard** | Build and view dashboards | | **Query Builder** | Write and run queries | | **Data Sources** | Browse and manage data source connections | | **Agents** | View and configure agents | | **MCP and Tools** | Connected MCP tools | | **Automations** | Build and run automations | | **Datasites** | Build and publish datasites | The picker shows **All features** when nothing is restricted, or **N features** when it is. #### Resource access Optionally limit which data source connections the user can query. **All resources** (default), or pick specific ones. ### Validation rules * **Work email addresses only.** Personal domains (Gmail, Hotmail, and similar) are rejected with *"Use a work email."* * Duplicate emails within a batch are flagged before sending. * People who are already members are detected and skipped. Once sent, each invitee receives a link. While their status is *Invited* you can **copy the invite link** or **resend it** from the team member table. ## Managing Team Members The team members table (**Settings → Team Members**) lists everyone in the workspace. | Column | Description | | - | - | | **Name / Email** | Avatar, display name, and email address | | **Role** | Current workspace role | | **Resource Access** | Number of data sources the user can query | | **Feature Access** | Number of features enabled | | **Joined** | Date they joined the workspace | | **Actions** | Context menu of available actions | ### Filtering and sorting * Search by name or email * Sort by username or role, ascending or descending * Members are grouped by status: Active, Invited, Deactivated ### Available actions per member | Action | Who can perform it | Notes | | - | - | - | | **Copy invite link** | Owner · Admin | Available while status is *Invited* | | **Resend invite** | Owner · Admin | Sends a fresh email to the invitee | | **Transfer ownership** | Owner only | Target must hold the Admin role | | **Remove member** | Owner only | Cannot remove yourself or the current owner | ### Changing a role Only the **Owner** can change roles, and you cannot change your own or the Owner's. Promoting a **Viewer** to **Editor** or **Admin** makes them billable. Before the change is applied you see a confirmation: > You are about to upgrade *`{name}`* from viewer to editor. *`{name}`* becomes billable and you will be charged for the same. Confirming charges your saved payment method for the prorated remainder of the current cycle, with a **Processing payment** step while it completes. Demoting someone back to Viewer does not charge. ### Transferring ownership Ownership can be handed to any current **Admin**. A confirmation is required. After the transfer, the previous owner becomes an Admin. ### Removing a member Removed members lose all access immediately. Their contributions — dashboards, queries, automations — remain. You cannot remove the workspace owner or yourself. ## Roles and Permissions A workspace role sets the kinds of actions a member can take. Feature access, resource access, and individual item sharing also apply. | Role | Typical access | | - | - | | **Unassigned** | No workspace access until a role is assigned | | **Viewer** | Read and interact with work shared with them | | **Editor** | Create and edit permitted content | | **Admin** | Workspace administration, including inviting members | | **Owner** | Owner-only administration, billing, and ownership management | Being an Admin or Editor does not make you the owner of every dashboard, project, chat, or query. Use the item's **Share** dialog to check its access level. Item owners manage actions such as sharing or deletion where required. ### Role assignment rules * Only the **Owner** can change member roles * You cannot change your own role * You cannot change the Owner's role ## Feature Access Feature access is a per-user toggle that sits *on top of* the role system. Even an Editor can be blocked from specific features. The feature flags are listed under [Which features they can use](#which-features-they-can-use) above, and they can be changed afterwards from the Team Members table. > Only the **Owner** can modify a user's feature access. Restrict individual features when, for example, you want someone to view dashboards but not chat with an agent or browse raw data. Feature access does not replace an item's sharing settings. A shared chat also needs **Can chat** access for follow-up questions. ## Resource Access Resource access limits which **data source connections** a user is allowed to query. This is independent of their role. * **All resources** (default) — the user can query any connected data source * **Specific resources** — only the sources explicitly listed Useful when you have sensitive databases (production financials, say) that should reach only part of the team, even among Admins. > Only the **Owner** can modify a user's resource access. ## Workspace Invites When another workspace owner invites you, the invitation appears in the settings sidebar under **Profile Settings**, below your profile entry. * The name of the workspace you've been invited to * An **Accept** button to join Accepting activates your membership and switches your active workspace to the one you just joined. ## Usage Analytics Open **Settings → Usage**. The **Usage** tab shows activity; **Limits** shows plan allowance and extra credits. See [Usage and billing](/workspace/usage-and-billing) for a walkthrough. ### Top-level KPIs The activity cards cover **Data Source**, **Ask Analyst**, **Dashboard**, **DataSites**, **Automation**, and **Queries**. Use the selected period to review the workspace's activity. ### Filters Choose a date range and use the user filter to focus on a teammate where available. ### Charts The Usage tab includes prompt activity over time. The Limits tab also includes the prompt usage heatmap. ### Leaderboard **Platform usage per user** lists activity by teammate. Prompt history and CSV export require the corresponding permission; they are not available to every member. ### Plan allowance and extra credits Use **Limits** to check the percentage plan allowance and reset time. The current screen labels its bar as **% used**. Extra credits, when shown, use a dollar balance and display their expiry information. These are separate displays. ## Seats and Billing **Settings → Plans and Billings** manages your workspace subscription. ### Seat-based pricing The current plan card shows your subscription, billable seats, and renewal details. Read the amount displayed for your workspace before making a change. ### What a role change costs Inviting or promoting a member may add a billable seat. Review the amount and timing shown in the invitation or role-change confirmation. [Team access](/workspace/invite-and-manage-access) explains how to choose the role and access settings. ### Trials If your workspace is on a trial, its plan card shows the remaining time and upgrade options. ### Billing management From **Plans and Billings** you can: * **View billing email and legal organisation name** — the details used on invoices * **See the next payment amount and date** * **Update payment method** — change the card on file (last 4 digits shown) * **Manage billing address** — the legal address used on invoices * **View and download invoices** — full history with a PDF per invoice * **Cancel subscription** — a confirmation shows the cancellation date; access continues to the end of the billing period * **Upgrade** — jump to plan selection and generate a payment link For plan tiers and prices, see [pricing](https://supaboard.ai/pricing). > Billing is managed at the workspace level, not per user. Only the **Owner** can access billing settings. ## Switching Workspaces If you belong to multiple workspaces, click your workspace name in the sidebar → **Switch Workspace**, then pick one. Switching is **not** an in-place update. Supaboard clears its local caches and reloads the application on the new workspace, landing you on Home with the Analyst. > If you have background tasks running — a generating dashboard, a running automation — you are warned first: *"You have tasks running in the background. Changing Workspace will terminate them. Do you want to continue?"* Let long-running work finish before you switch. ## Programmatic API Keys Supaboard issues API keys for authenticating programmatic access. | Detail | Behaviour | | - | - | | **Format** | Prefixed `sb_` | | **Storage** | Hashed — Supaboard never stores the raw key | | **Visibility** | Returned in full **exactly once**, at creation. Afterwards only a masked form is shown. | | **Who can manage them** | Admin · Owner | > **There is no Settings screen for API keys yet.** They are created and revoked through the Supaboard API. Save the key when it is issued — it cannot be retrieved again. ## The Command Palette Press **⌘K** (macOS) or **Ctrl+K** (Windows/Linux) anywhere in Supaboard to open the command palette. Use **All chats** to search conversations or the search field in a library to find its items. * Type to search across dashboards, conversations, queries, data sources, and agents * Filter with the chip: **All** · **Recents** · **Create New** · **Settings** * Results are grouped into Recents, New, Settings, and Results * Navigate with the arrow keys, open with Enter, dismiss with Escape Recently opened items are remembered per workspace. The palette only surfaces entity types you have [feature access](#feature-access) to. ## Quick reference: Settings navigation | Path | What you manage | | - | - | | **Settings → Workspace** | Workspace name, industry, team size, image, MFA requirement | | **Settings → Team Members** | Invite, manage, and remove members; assign roles and access | | **Settings → Usage** | Monitor AI and query usage across the team | | **Settings → Connections** | Data source connections (see [Data Sources](/data-sources/overview)) | | **Settings → MCP & Tools** | External tools used by agents | | **Settings → Plans and Billings** | Subscription, seats, invoices, payment method, billing address | | **Settings → White Label** | Branded standalone app (see [White Label](/workspace/white-label)) — negotiated plans only | | **Settings → Profile** | Your own name, avatar, and password | Pending invitations from other workspaces appear under the **Profile Settings** heading, not under Workspace Settings. ## Permissions at a glance | Action | Viewer | Editor | Admin | Owner | | - | :-: | :-: | :-: | :-: | | View workspace settings | ✓ | ✓ | ✓ | ✓ | | Edit workspace settings | — | — | ✓ | ✓ | | Require two-factor authentication | — | — | ✓ | ✓ | | Invite team members | — | — | ✓ | ✓ | | Change member roles | — | — | — | ✓ | | Change feature access | — | — | — | ✓ | | Change resource access | — | — | — | ✓ | | Remove members | — | — | — | ✓ | | Transfer ownership | — | — | — | ✓ | | Manage billing and seats | — | — | — | ✓ | | Manage API keys | — | — | ✓ | ✓ | | View usage analytics | — | — | ✓ | ✓ | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.