Skip to main content

Workspace Settings

Open settings from the workspace detail page (Settings button, top right) or by going directly to /workspaces/:workspaceId/settings. The settings route is feature-gated by workspaces.settings; if you don't see it, enable the flag under Feature Previews.

Permissions: workspace:update. Without it the page shows an Access Denied card with a back-to-workspace button.

General settings​

The General Settings card lets you edit:

FieldWhat it does
Workspace NameDisplay name shown in lists, headers, and the workspace selector. Min 2 / max 100 characters.
Contact EmailPrimary email used for outbound notifications from this workspace. Must be a valid email (or left blank).
DomainOptional domain shown on the workspace card and detail page, such as your organization's web domain. It is for reference only; the workspace keeps its usual Burdenoff Workspaces address.
WebsiteOptional public homepage URL. Must be a valid URL (or left blank).

Click Save Changes to apply. On success you are returned to the workspace detail page. The changes are audited and visible in the activity feed.

The backend also stores address, status, and owner ID on a workspace, but these are not currently exposed as editable form fields in the UI — they are managed through admin flows.

Tags​

The Tags card uses the universal tags widget (powered by the tags service) to attach tags directly to the workspace itself. Use these to classify the workspace across departments, BUs, regions, or any taxonomy you maintain.

  • Click the + in the widget to add a tag from your vocabulary.
  • Click the x on a tag to remove it.

While a change is being persisted the widget is briefly disabled. Tag changes go through the replaceWorkspaceTags mutation, which requires workspace:update.

Lifecycle actions​

Lifecycle actions (archive, reactivate, delete) are backed by archiveWorkspace, reactivateWorkspace, and deleteWorkspace and use the permissions workspace:archive, workspace:update, and workspace:delete respectively. They are not yet exposed as buttons on this settings page — invoke them through the workspace overview's lifecycle controls or admin tools.

See Creating and managing workspaces for full lifecycle details.

Members shortcut​

To manage members, go to /workspaces/:workspaceId/members. See Members and Invitations.

Tips​

  • Every setting is workspace-scoped. Changes never affect other workspaces in the same tenant.
  • If a field appears greyed out, you are missing workspace:update. Ask the workspace owner to grant a role that includes it.
  • The contact email becomes the From address for invitation and notification emails sent from this workspace, so keep it current.