Skip to content

Name tags

Every part of the screen you can style has a name tag. This page lists them all (about 150 in the first version). You do not have to learn them: Design mode shows the tag of whatever you point at, and the editors autocomplete them.

The rules

Word What it is Example
Tag one kind of part, in small words joined by dots checkbox, sidebar.row, toast.error
Piece a part inside a part; never spelled with dots the checkbox’s box and mark
State a moment the part can be in hover, pressed, focus, disabled, checked, open, selected, current, dragging, empty, error, today
Token a theme value the part reads, with a fallback the checkbox fill reads checkbox.checkedFill, which falls back to color.accent
  • More dots = more specific. dialog matches every dialog. dialog.confirm matches every confirm dialog. dialog.confirm.replaceRun matches one. The more specific tag wins.
  • A part carries its general and its specific tag. Styling card changes every card; styling feed.card changes only feed cards.
  • General tags: card, row, dialog, sheet, panel, popover, picker, menu, toast, button, input.
  • Label tags show a name or a short text: a tab, a sidebar row, a chip, a button, a table cell, a menu item, a breadcrumb item, a card title, and the label tag itself. Every label tag has the truncate setting for long text. See When text is too long.
  • Every dialog purpose and every toast kind has its own tag. The build makes it, so a new dialog cannot ship without one.
  • Tags grow on demand. Want to style something with no tag? We add one. A tag is never removed without the update steps.
  • The list comes from the app’s own parts, so it always matches the real app.

In settings and in CSS

In settings, pieces sit under pieces:

{ "parts": { "checkbox": { "pieces": { "mark": { "color": "var(--color-highlight)" } } } } }

In the page, tags, pieces and states are attributes: data-part, data-piece and data-state.

/* every dialog */
[data-part~="dialog"] { border-radius: var(--radius-panel); }
/* only the new-entry dialog */
[data-part~="dialog.newEntry"] { width: 520px; }
/* the mark of a ticked checkbox */
[data-part~="checkbox"][data-state~="checked"] [data-piece="mark"] { color: var(--color-highlight); }

App frame and background

Tag Pieces Notes
app.background — the main background behind everything
app.window titleBar the desktop window frame

The sidebar has five sections: Views, Hubs, Chats, Favorites and Collections. A collection row is one button: it opens the collection page and never lists its entries. An entry row (in Favorites, a hub or a view’s pinned page) can open into a tree of its sub-entries.

Tag Pieces States
sidebar — collapsed
sidebar.header logo, collapseButton —
sidebar.search — focus
sidebar.section, with sidebar.section.views, .hubs, .chats, .favorites, .collections (and .globalCollections, kept for older designs) title, addButton, empty open
sidebar.row icon, label, count, toggle, menu, children (the tree under an open entry row), rest hover, current, dragging, dropTarget, open
sidebar.footer avatar, name, plan —

There is no section for the tree. The tree opens under an entry’s own row: that row is open, and its sub-entries sit in its children piece.

Top of the page and the phone tab bar

Tag Pieces States
topbar back, status (saving and sync), menu, favorite —
breadcrumb item, separator current
collectionChip icon, label —
tabbar (phone) item, icon, label current, pressed
moreMenu (phone) row —

The phone tab bar is drawn by the phone itself, so it takes theme colours and fonts only.

Screens

A page is a screen. Each screen has a page tag.

Tag Pieces
page (any screen), with page.form, .reading, .page, .board, .canvas, .content, .full (the widths) —
collectionPage cover, tags, viewTabs, menu
globalCollectionPage viewTabs
hubPage (the screen of a hub) viewTabs
entryPage cover, icon, title, properties, property, propertyLabel, propertyValue, document, subEntries, relations, backlinks, history, actions
settingsPage (settings pages that are not protected) section, row
libraryPage listing, listingCover, filters

On all three pages, the viewTabs piece holds the one tab bar, tabs.bar. The tab bar looks and works the same on all three.

A dashboard has no tag of its own. It is an entry in the Dashboards collection, so it is an entryPage with a grid. To style all your dashboards, style them with the place This collection on the Dashboards collection.

Block pages, dashboards and blocks

A Block page or a Dashboard property holds blocks. Each block type has its own tag. The block types are on Blocks and charts.

Tag Pieces
document (a Block page property) blockHandle
grid (a Dashboard property; its settings include the gap between tiles) tile
block, with one tag per block type (see below) header, title, body, rangeNav
chart (the chart inside a chart block) axis, grid, legend, tooltip, series, label
Kind of block Tags
Writing block.paragraph, block.heading, block.list (bulleted, numbered, checklist), block.quote, block.callout, block.divider, block.code (shows code as text), block.mention
Media block.image, block.embed
Data block.chart, with one tag per chart kind (the 22 kinds); block.view; block.entry; block.columns (Block page only); block.html (your own HTML, CSS and JavaScript in a sealed frame)

Views and their items

Tag Pieces States
view toolbar, queryBar, groupHeader, empty, addRow —
table header, headerCell, gridLine —
table.row (also row) cell, gutter, handle hover, selected, dragging
list.row (also row) handle, rest hover, selected, dragging
board.column header, count, addButton dropTarget
board.card (also card) — hover, dragging
gallery.card (also card) cover hover
mosaic.tile (also card) — hover
feed.card (also card) — hover
feed.dateSeparator — today
books.shelf — —
books.cover (also card) — hover
calendar.grid day, timeRuler, nowLine, weekStrip, miniCalendar day has today, weekend
calendar.event, with calendar.event.block, .pill, .dot title, time, resize hover, dragging, past
subEntries.row handle —

Controls

Tag Pieces States
checkbox box, mark checked, mixed, disabled, hover, pressed, focus
button, with button.primary, .secondary, .ghost, .danger, .iconOnly label, icon hover, pressed, disabled, focus
input, with input.text, .number, .date, .time, .rating, .slider, .stopwatch, .tags, .relation, .media, .color, .formula field, placeholder, prefix, suffix, plus each kind’s own (symbol for rating, thumb for slider) focus, disabled, error, empty
select trigger, list, item, itemIcon, itemCheck, search, groupLabel open, selected, hover
menu, with menu.kebab, .context, .mention, .slash list, item, itemIcon, separator, groupLabel open, hover; items can be destructive
tag label, remove one look per tag colour
badge, with badge.neutral, .success, .warning, .danger, .plan — —
chip (entry chips, reference pills, the active timer and run pills) icon, label —
tabs, with tabs.section, .pill (other tab looks) item current, hover
tabs.bar (the one tab bar of collection, global collection and hub pages; also has overflow) item, linkMark (the ↗ on a tab from another place), more (the More ▾ menu), add (the + button) current, hover
label (the one icon-and-name control, inside tabs, sidebar rows and titles; setting show: both · icon · name) icon, name —
segmented item current
tooltip, infoHint — —
scrollbar thumb, track hover
dragHandle, resizeHandle — hover, dragging
focusRing, selection, searchHighlight — —
emptyState, progressRing, workingDots — —

The tab bar and the label

  • One tab bar. tabs.bar is the tab bar of every collection, global collection and hub. Its tabs show views or entries. tabs.section and tabs.pill are other tab looks.
  • The link mark. In a collection’s tab bar, a tab that shows something from another place (a dashboard, another collection’s view, a global view) has a linkMark piece: the ↗. Hubs show no link marks.
  • The label. Each tab item, each sidebar row and each title holds one label. Style label to change all of them at once. In a sidebar row, the label fills the row’s icon and label pieces.

Dialogs, sheets, panels, popovers and pickers

General tag Specific tags
dialog (pieces header, body, footer, overlay) dialog.newEntry, dialog.addExisting, dialog.addSubEntry, dialog.moveTo, dialog.history, dialog.convertProperty, dialog.findDuplicates, dialog.cardPreview, dialog.chartBuilder, dialog.addBlock, dialog.blockSettings, dialog.embedView, dialog.calendarEvent, dialog.defaultEventCollection, dialog.imageSettings, dialog.insertReference, dialog.editLink, dialog.longText, dialog.rawValue, dialog.banner, dialog.background, dialog.chatPicture, dialog.chatMemory, dialog.pinView, dialog.globalCollection, dialog.conversation, dialog.bulkImport, dialog.libraryCopy, dialog.libraryReport, dialog.getTheApp, dialog.settings
dialog.confirm (the “Are you sure?” dialogs that are not protected) dialog.confirm.replaceRun, dialog.confirm.moveToCollection, dialog.confirm.revertAiAction, dialog.confirm.dismissSuggestion, dialog.confirm.forgetMemory, dialog.confirm.convertProperty
sheet (phone; pieces handle, body) sheet.menu, sheet.event, sheet.day, sheet.select
panel (side panels and drawers; pieces header, body) panel.viewSettings, panel.propertySettings, panel.assistant, panel.automations, panel.boardData, panel.boardSettings, panel.phoneLayout, panel.json (the one-document editor), panel.trashPreview, panel.peek (entry peek: side, centre or full)
popover popover.eventQuick, popover.inbox, popover.pastChats, popover.sort, popover.columns
picker picker.icon, picker.color, picker.collection, picker.property, picker.date, picker.photo, picker.background, picker.banner, picker.model, picker.agent
palette palette.search (search and commands)
lightbox lightbox.media
fullscreen fullscreen.stopwatch, fullscreen.entry (an entry that fills the screen, such as a run while it records)

Most removals are instant with an Undo toast, so few confirm dialogs are left.

Toasts and status

Tag Pieces Notes
toast, with toast.success, .error, .info, .undo (also “Moved to Trash”), .celebrate, .notification, .custom (a toast your design shows) icon, message, action, close never hidden; error and Undo toasts stay at least 6 seconds
syncStatus — the saving and sync dot
inlineError — for example the chat error line

Chat

Tag Pieces
chat switcher, divider
chat.message, with chat.message.user, .assistant bubble, markdown, attachments, sources, menu
chat.composer field, attach, voice, send, contextPill
chat.toolCard, with chat.toolCard.choices, .job, .actions header, body
chat.working —

Protected screens (not styleable)

These names exist so documents and tests can refer to them. No design can style them, not even Free CSS. They carry no general tag, so a rule for dialog or button never reaches them.

Name
protected.signIn, protected.signUp, protected.resetPassword, protected.onboarding
protected.deleteForever, protected.deleteAccount, protected.massDeletePause
protected.share, protected.unpublish, protected.libraryPublish
protected.plan, protected.aiKey, protected.aiApproval, protected.aiReceipt
protected.disconnect, protected.externalLink, protected.enableCode
protected.endToEnd, protected.removeDevice, protected.recovery
protected.safeMode, protected.resetDesigns
the settings pages for security, plan, devices, privacy, where your data lives, AI routes and AI safety