Tutorials Data and forms

One collection, eight looks

The same entries as a table, cards, a list, an accordion, a timeline, a carousel, a list group and your own block design.

15 minutes IntermediateFree

Tools usedBuilt into Domma CMS

You will build

ACME's Tool catalogue shown eight ways - and a design of your own for the eighth.

You need

The idea

Enter the data once, in the admin. Choose how it looks page by page with one word: display.

Every example below is one line in a page. They all accept the same filters (where_...), sort, order, limit and fields, and every one has the right-click menu for filtering, sorting and exporting.

1. Table - the default

[collection slug="tool-catalogue" fields="name,category,price" exportable="true" /]

A proper data table with search, sortable columns, paging (25 rows a page; change with page-size) and a column chooser. exportable adds a download button. Leave out display and this is what you get.

2. Cards

[collection slug="tool-catalogue" display="cards" columns="3" title-field="name" fields="price,description" /]

A card per entry, columns wide. The workhorse for products, people and places.

3. List

[collection slug="tool-catalogue" display="list" title-field="name" fields="category,price" /]

A compact list - good in a sidebar or a narrow column.

4. Accordion

[collection slug="tool-catalogue" display="accordion" title-field="name" body-field="description" /]

Each entry becomes a heading that opens to show its body-field. Ideal for FAQs: make a collection with question and answer fields and this is your FAQ page. Add multiple="true" to allow several open at once.

5. Timeline

[collection slug="tool-catalogue" display="timeline" title-field="name" date-field="launched" body-field="description" layout="centred" sort="launched" order="asc" /]

Entries along a timeline by their date-field. Choose a layout (vertical, centred, horizontal) and a theme (minimal, corporate, modern). With mode="roadmap" and a status-field, the same display becomes a product roadmap.

6. Carousel

[collection slug="tool-catalogue" display="carousel" title-field="name" image-field="photo" body-field="description" autoplay="true" /]

A slideshow, one entry per slide. It needs a field holding an image address (photo here - add one to the collection first). Set interval, loop and the animation to taste.

7. List group

[collection slug="tool-catalogue" display="listgroup" title-field="name" variant="numbered" /]

A Domma list group: flush, numbered or horizontal, with optional colour per item (itemvariant) and hover styling (action="true"). Tidy for top-ten lists and links.

8. Your own design with a block

When none of those fits, design the entry yourself. Go to Data > Blocks and create a block called tool-tile:

<div class="tool-tile">
  <span class="tool-tile-cat">{{category}}</span>
  <h3>{{name}}</h3>
  <p>{{description}}</p>
  <strong>&pound;{{price}}</strong>
</div>

Each {{field}} is filled from the entry (safely escaped). Put the block's styling in its Custom CSS pane - it is scoped to this block automatically, so it cannot leak into the rest of the site. The block editor's sample values table drives a live preview exactly as the site will draw it.

Then use it:

[collection slug="tool-catalogue" display="block" block="tool-tile" cols="3" /]

cols sets 2 to 6 columns that stack on phones. The same block= also works for carousel and list group entries. Dates can be formatted in the template: {{launched:DD MMM YYYY}}.

The same tool catalogue shown as a table, cards and a timeline on one page

Make any of them interactive

Add searchable, sortable or filterable="category" to cards, list, block and the rest and they gain the search box and filter panel from Build a searchable directory.

What you built

One set of data, eight presentations, each a single line you can change without touching the data. Your team edits entries in the admin; every page showing them updates by itself.

Keep going

Try it on your own site

Everything in this tutorial is free. One command gets you a site to follow along on.

Get started freeMore tutorials