Skip to main content
The Design library holds the reusable pieces of your visual work: components you drop onto a frame, pages built out of them, and tokens, the colour, type, and radius values that keep everything looking like one product. It belongs to your Cortex account rather than to any single canvas, so an item you add once is available on every design you open. This page covers the three kinds of item the library holds, how to find and place them in the Design desktop app, how thumbnails work, and why the Design library is a different thing from the Library in Cortex Chat. The library is edited in the Design desktop app; the web app does not draw it.

​
What the library holds

A library item is exactly one of three kinds. There is no fourth. Tokens are the reason two frames can look like the same product. You maintain the values; the components that reference them follow. Each item also carries a theme, which is light, dark, or both, so a component built for a dark surface is not offered where it does not belong. Items are named by you, up to 200 characters, and can be filed under a group name of up to 128 characters. The names you give library items are encrypted at rest.

​
Open the library

1

Open Library in the Design desktop app

It is a row in the sidebar. From inside the editor you can also use the Library button on the canvas overlay, which keeps the canvas in view.
2

Pick a tab

The library screen is split into Components, Tokens, and Pages, each showing how many items it holds. The header repeats the three counts for the whole library.
3

Search

Search components, tokens filters the list by name.
4

Place a component

Drag it from the library onto a frame to insert it.
5

Refresh from your account

Sync pulls the library again, which is what you want after adding items from another machine.
Each item shows its name, its own identifier in the shape dli_..., and a line counting the canvases it is used in. Components are presented as a read-only mirror of your account’s components: you place them, you do not edit the source from the canvas.
The app’s library also lists saved design files under a fourth tab. Those are files, not library items, and they are not one of the three kinds above.

​
Thumbnails

An item can carry a thumbnail, and a thumbnail is a picture you upload rather than a preview the app renders for you. Two rules apply, the same as for images placed on a canvas:
  • A thumbnail must be a raster image. A library thumbnail must be an image. if it is not.
  • SVG is not stored as a Design asset. Convert the artwork to PNG before uploading it as a thumbnail.
An uploaded picture is stored once however many places it appears, so reusing the same thumbnail costs nothing extra.

​
Two libraries, same word

They share no storage and no route. An item in one never shows up in the other.

​
Access and limits

The library needs a signed-in Cortex account, like every other Design surface. A signed-out visitor is refused with Design canvases need an account. Sign in to keep your work. See entitlement_required. Another account’s items are never listed to you. If a kind, a name, or a theme is rejected, the message says which: A library item is a component, a page, or a token., A library item needs a name of at most 200 characters., A library item theme is light, dark, or both., or A library group name is at most 128 characters.
A component you place on a frame is not yet linked back to its library item, so editing the item later does not update copies already on a canvas. That link is planned rather than available.