Library

The Library holds reusable material for Create workflows: uploaded media, documents, fragments, and saved block presets. Open Create → Library (/dxp/create/library) to upload, organise, filter, and edit metadata before you reuse assets across pages and Spaces.

Data scope (important)

Library behaviour follows the same multi-Space rules as CRM and catalog:

Consolidated operators (one legal entity, several storefront Spaces that share CRM today) may later opt child Spaces into a parent Space for shared Library metadata. That is permission-gated and not automatic. Until your operator enables it, treat collections and tags as Space-local only.

Always confirm the workspace switcher shows the Space you intend before you upload, filter, or edit the inspector.

What belongs in the Library

• Media — images, video, 3D models, and similar files for blocks and themes.
• Documents — PDFs, price lists, trade terms, and other downloadable assets.
• Fragments — reusable copy or HTML snippets you reference from many pages.
• Blocks — presets from Block builder and site library entries (platform presets may also appear). Insert these from the canvas Library tab or Ctrl+/ palette, not only from this desk.

Permissions follow the same desk roles as the rest of Create.

Library desk layout

Left sidebar — filters

• Collections — click an album to show only assets assigned to it in the current Space. Use + New collection to create an album for the active Space. All collections clears the filter.
• Types — All, Media, Documents, or Fragments scrolls the main column to the matching section.
• Tags — click a tag (shown as #label) to filter assets tagged in this Space. All tags clears the filter.

Filters can be combined with the toolbar search. The URL updates with ?collection=, ?tag=, ?type=, and ?q= so you can bookmark a view or share a link with a teammate.

Toolbar — search

Use Search name or tag… to narrow the grid by file name or tag text. Search works together with sidebar filters.

Main column — sections and upload

• Drop zone — drag files onto the page or use the file picker. You may be asked which section (Media, Documents, Fragments) should hold an ambiguous file. Failed uploads show the server reason with Retry and Dismiss.
• Grids — each section lists assets as tiles. Switch Masonry vs List in the toolbar for density.

If uploads fail with library unavailable, the engine process is not reachable — in local dev run make run from the eonix repo root so engine, platform, and edge are up.

Right inspector

Select a tile to open the inspector:

• Metadata — file size; ALT text for images (editable; click Save changes).
• Collections — toggle which Space albums this asset belongs to.
• Internal tags — ops/editorial labels (not shown on the public site).
• Content tags — public-facing labels used for themes, Jump, and (where wired) Observe signals.
• Delete asset — removes the file from the workspace library (confirm dialog).
• Block tags — when you select a saved site block, toggle tags in the inspector; changes save immediately.

Click Save changes after editing ALT text, collections, or tags on file assets.

Collections (albums)

Collections group assets for a single Space — for example “Marketing 2026” or “Trade show booth”. They do not copy the underlying file; they are membership labels.

1. Confirm the correct active Space (banner appears if none is selected).
2. Click + New collection in the sidebar or assign membership from the inspector when an asset is selected.
3. Filter the grid from the sidebar to work inside one album.

Tags

Tags are registered per Space with a display name and a normalized key (slug).

Assign tags from the inspector: type a label and click Add under Internal tags or Content tags, then toggle chips to assign. Saved blocks in the Blocks section can be tagged the same way (site entries only).

Jump

From the desk Jump field (omnibar), you can open Library filtered by tag:

• Type #spring-fashion or tag:spring-fashion and confirm — you are sent to /dxp/create/library?tag=spring-fashion for the active Space.

Using Library material in Spaces

From the canvas editor, pick Library assets when a block or media field allows it. The page stores a reference to the Library item, not a second copy of the binary, so a canonical asset update can flow to every reference (depending on block type).

For blocks, use the editor Library tab or block builder presets; see Pages and editor.

Organisation and hygiene

• Name uploads clearly (hero-spring-2026.webp, not IMG_0042.jpg).
• Use internal tags for workflow; content tags for anything public or analytic-facing.
• Before deleting a Library file, check live pages and drafts — broken media on published routes often means a removed asset.
• Retire outdated albums and tags when a campaign ends so filters stay trustworthy.

Related Create areas

• Workspace and Spaces — active Space and switcher.
• Spaces — where Library material is published.
• Drafts — in-progress work that may reference Library items.
• Pages and editor — inline media vs Library-first workflows.
• Observe → Webhooks — content_tags on published page events (where enabled).