Documents
A list of files to download, each with its type and size.
Use this element#
Add complete document rows and replace each file destination through the link controls. Edit the file’s title and supporting type or size text so readers know what they are opening.
A document link does not make a file private. Restricted downloads must stay behind their native application’s authorization. Check the actual file, file type, accessibility, and destination before publishing.
Availability#
Available through the appropriate content or section picker when the theme and editing context allow it.
Content controls#
These are the controls registered for this element. A control that depends on another setting or the surrounding layout appears only when it applies.
Layout#
| Choice | Stored value |
|---|---|
| List | (empty/default) |
| Cards | layout-cards |
This control is conditional on the element’s current state or layout. A hidden control does not indicate that its stored value has been deleted.
Documents#
Use Add a document to create a complete item. The collection manages its content and structural wrapper together.
Min: 1.
Each item exposes: Type, Name. Rich content can also be edited directly on the page.
Save and check#
- Change one setting and inspect the affected element.
- Use Undo and Redo to check the edit is reversible.
- Save a draft, reopen it, and confirm the content and choices remain.
- Inspect the page at desktop and phone widths.
- Publish only when the result is ready. For interactive elements, check the visitor view because editing mode can suppress interaction.
How it is stored#
The block comes from blocks/50-documents.html. Its editable content is HTML in the page or owning template. Native settings update words, attributes, classes, or supported style properties. Generated interface controls are not saved into that HTML.
The settings registry matches .cb-docs in assets/element-settings.js. Public behavior, when needed, is implemented by the native element runtime in assets/elements.js or assets/blocks.js.