Guide

Workspace landing

A per-user preference that flips what opens when you visit a workspace. The default behavior, today, opens the first surface on the workspace’s tab strip. The new behavior opens a workspace home view that lists every surface as a tile, organized by recency. Pick whichever fits how you think about your work; flip it back any time.

Two modes

The setting lives in Settings → Profile → Workspace landing. Two options:

Option
What opens
When to pick it
The first surface
Today's behavior. /[org]/[workspace] auto-routes to the workspace's primary surface (the first tab). Surface tab strip is always visible above the body.
You spend most of your time inside one or two surfaces and want to jump straight to work.
The workspace
/[org]/[workspace] opens a workspace home (the Launch dock). Every surface is a tile in the kind's hue, banded by recency (Active now / Today / This week / Older). The surface tab strip is suppressed; one click opens a surface alone with a back affordance to return.
You move between three or more surfaces in the same workspace, or you want the workspace itself to feel like the document.

Folder pattern in workspace mode

With the workspace selected, the workspace UX is a folder, not a stack of tabs:

  • Opening the workspace lands on the home. Plank header with the iridescent brand sigil, recency bands beneath, each surface as a glass tile.
  • Clicking a tile opens that surface alone. The body fills with the surface; no tab strip above, no other surfaces visible. The URL becomes /[org]/[workspace]/[surface] so refresh and right-click open-in-new-tab still give a shareable deep link.
  • A small back affordance above the surface body shows ← Workspace name and the current surface. Click it to return to the home.
  • “+ New surface” lives in the home plank, since the tab strip’s “+” steps aside in this mode.

Recency bands

Tiles on the workspace home are bucketed by Surface.updatedAt into four bands:

Band
Window
Active now
Edited in the last 30 minutes
Today
Edited in the last 24 hours
This week
Edited in the last 7 days
Older
Everything else

Within a band, freshest first. Empty bands are hidden so the home doesn’t reserve vertical space for placeholders.

Scope of the setting

The preference is per-user and applies to every workspace you open across every org you belong to. There’s no per- workspace override and no admin-level override, by design: choosing how you read your own work is your call. Your choice persists across browsers, devices, and sessions through the User.workspaceLanding column.

Explicit surface URLs always win. If you bookmark or share /[org]/[workspace]/[surface], that link opens the surface even when your preference is the workspace. The home is the landing for the bare workspace URL only.

API

The preference flows through /api/me. Read your current value:

GET /api/me
// {
//   "type": "user",
//   "workspaceLanding": "primary-surface" | "workspace",
//   ...
// }

Write a new value:

PUT /api/me
{ "workspaceLanding": "workspace" }

The toggle in Settings calls the same endpoint. No agent equivalent — agents inherit a workspace through their owner’s membership, and their first call to a workspace is always against a specific surface, so this UI-level preference doesn’t apply to them.

Frequently asked questions

Does flipping this change behavior for anyone else in my org?
No. The preference is per-user. Your teammates and agents see the workspace exactly as their own preference says, independently of yours.
Will my old bookmarks to /[org]/[workspace] still work?
Yes. They open the home in workspace mode and the primary surface in the default mode. Bookmarks to specific surfaces always open that surface regardless of mode.
Can I preview the workspace home without flipping the setting?
Not today. Flip the toggle to 'the workspace' in Settings, visit a workspace, then flip it back if it isn't for you. The change is reversible at any time and persists across devices.
How do I open a surface in a new tab from the workspace home?
Right-click a tile and choose 'Open in new tab', or Cmd-click on macOS, Ctrl-click on Windows. Tiles are real links pointing at the canonical surface URL.