Clear CMS Docs 2026

Collections and records

Lists of similar things, like news, team members or events. Add, find, import, order and publish their records in one place.

On this page

A collection is a list of similar things on your site: news, events, team members, menu dishes, testimonials. Each item in it is a record. Your site's design decides where records show, like the latest news on the home page or the team on the About page. You fill them in.

See your collections

Press Collections in the left menu. Each row shows how many Records the collection holds, when its changes go live (When you publish, or Right away), whether its records have Own pages on the site, and the Last change. Click a row to open the collection. Right-click a row for New … (like New story) to add a record straight away.

Collections: every list on the site, with its records and how changes go live

Look through a collection

A collection shows its records as a List, as Cards, or on a Calendar when they have a date (events open on the calendar). Switch at the top; Clear remembers your pick on this computer. Each record shows whether it is published or a draft, and when it last changed.

  • Search (or press /) finds records by their words.
  • Filters keeps only the records that match: pick a field, how it should match (is, is not, contains, from, to, is empty, is set) and a value. Add as many as you need; a record must match them all. The filters are part of the page's address, so you can bookmark or share a filtered list.
  • The sliders button sorts and narrows the list: by Status (Published or Draft), by a choice field such as a category, with or without group headings, and in another Order. In the list, clicking a column name sorts by it too.
  • Views keeps what is on screen (the columns, order, filters and search words) under a name, like "Weekend events", for everyone who edits the site. Save view… makes one. The Views menu brings it back, shows a dot when the list has changed since it was saved, and removes a view without touching any record.
News as cards, with Views, Filters, Search and New story at the top

Add a record

  1. Open the collection.
  2. Press New at the top right. It names one record of the collection, like New story or New person. You can also press N.
  3. Type a title, then fill in the other fields and add a photo if there is one. The record is saved as a draft once it has a title.
  4. Press Publish when it is ready (see below).

On the calendar, click an empty day to add an event on that day.

Edit a record

Click a record. It opens in a window over the list, and your changes save as you type (Saving, then Saved). Press Esc or the back arrow to close it.

  • Open full page (the arrows at the top right) gives the record the whole screen. Right-click a record and choose Edit as a page to do the same.
  • The eye shows the record's page on your site over the form, once the record has been published.
  • The photo: point at it, then Edit (focal point, crop, turn; see Editing a photo), Change (pick another from Media) or Remove.
  • A field with a red star is required: the record cannot be published while it is empty. Some fields have a help line under them.
  • Linked from lists the records elsewhere that point to this one, like the events held at a location. The New … button beside it makes such a record with the link already filled in.
  • Undo and Redo step through your changes. The clock shows earlier versions; Restore makes one the draft (see History). In the ⋯ menu, Discard changes throws away what changed since the last publish.
  • If someone else has the record open, their face shows at the top.
A record: its photo, title and text on the left, its details on the right, Publish at the top

On its full page, a published record that has a page of its own can switch from the form to Edit on the page: its real page from your site, where you click the words and type.

For news, blog posts and other long writing, see Writing posts and articles.

Publish, schedule or take records off

  • Publish at the top right of a record puts it live. Its arrow has Schedule…: pick the day and time under Publish on, then press Schedule. The record stays a draft and goes live by itself. Clear checks every 15 minutes, so it may go live up to 15 minutes after the time you set. Open the arrow again for Change time… or Cancel schedule.
  • A collection set to go live Right away has no Publish button: each change shows on the site about two seconds after you stop typing, and the record says Saved · live.
  • Some collections of short records, like a team list, show Publish with a number at the top of the list. It puts every waiting record live at once.
  • To work on several records at once, the collection needs Selecting switched on in its settings. Then tick the records (or Ctrl-click them, Shift-click for a range) and use Publish, Unpublish or Delete. Unpublish takes records off the site straight away and keeps them here as drafts, to publish again later. Clear asks before each, naming what will change.

See also Publishing.

Change the order

If the collection's order is Manual (drag), drag a row by its picture to move it; the site follows. Dragging works only while no search, filter, sort or grouping is on. Other collections sort themselves, like news by date.

Copy or delete a record

Point at a record and press ⋯, or right-click it:

  • Duplicate makes a draft copy right under it, with "(copy)" after its title.
  • Delete… asks first. The record stays on the site until you next publish. Until then it waits at the bottom of the list ("1 deleted · leaves the site when you publish"), where Undo brings it back.
  • Hide from the site and Lock editing only mark the record for now: the site still shows a hidden record, and a locked one can still be edited (coming).

Import from a spreadsheet

To add many records at once, save your spreadsheet as a CSV file (Excel, Numbers and Google Sheets all can). Then press the import button at the top of the collection (a page with an arrow, Import from a CSV file). Three steps, in one window:

  1. The file: drop it in, or choose it. Its first line must name the columns.
  2. The columns: Clear matches each column to a field and shows the first five rows as they will land. Change a match, or choose Skip to leave a column out. One column must fill the record's title. Press Import.
  3. Done: the count of records made. A row that could not be read says which cell and why; the other rows still go in.

Imported records are drafts: nothing goes live until you publish. Undo (Ctrl+Z) takes the whole batch out again.

To bring in a whole old website, see Importing an old site.

Make a collection

You need the Admin or Owner role.

  1. In Collections, press New collection (or N).
  2. Type a Name, like "Events".
  3. Under Start from, keep Blank or pick one of over sixty ready shapes (news, events, people, FAQ, menu items, jobs, recipes and many more). A shape fills in the fields for you.
  4. Check the Fields: remove one with its ×, or type a name, pick a type and press Add.
  5. Switch on Own pages when each record should have its own page on the site. The window shows the address it will get.
  6. A ready shape can also bring Example drafts, to edit or delete.
  7. Press Create. The collection is made as a draft and opens.

Collection settings

An Admin or Owner changes a collection with the gear at the top of its list, or in Settings → Collection settings. Hover a setting's name for what it does. Press Save when you are done; the changes are saved as a draft.

Setting What it does
Names The name in the menu, the word for one record (as in "New story"), and the group it sits in.
Views Row and card size, which fields show on cards and in the list, Selecting, and the photo shape.
Opens as A click opens the record in a Window over the list. Full page gives it its own page in the admin; List beside it keeps the other records at its side.
Goes live When you publish (the usual), or Right away, about two seconds after typing stops.
Roles Which field plays the Title, Cover, Summary, Main text and Date, for cards, lists and record pages.
Group by, Order Headings for each value of a field, and the order: by a field, Address, A to Z, or Manual (drag).
Address Each record's own page on the site, like /news/{slug}. Empty means no page of its own.
Fields Rename a field, mark it Required, choose where it Shows (Main in the form, Side in the side panel, or Hidden: kept but not shown) and give it a help line. Add field adds one.
Last updated October 23, 2026