Description
Give a Collection its own how-to page — with embedded videos — and read it from any card, or from an exercise inside a workout.
Every Collection can carry a Description: a free-form page about the Collection itself. What it's for, when you log it, what counts as one entry — and, more usefully, how to do the thing. Form cues for an exercise. The grind setting for your coffee. The stretch you always forget.
It's the wiki side of Kaizendex, and you can read it from wherever the Collection shows up — you don't have to go find the Collection to read its notes.
Writing one
- Open the Collection and go to its Description tab.
- Start typing. It's the same editor you use for an entry's page — headings, lists, checklists, quotes, tables, the
/menu. - There's no save button. Your writing lands as you type.
Leaving it blank is completely fine. Most Collections don't need one.
Embedding a video
This is what makes a Description worth writing for anything physical. Paste a YouTube link on its own line and it turns into a playable video, right there in the page:
https://www.youtube.com/watch?v=IODxDxX7oi4
Press Enter after pasting and the link becomes a player you can watch without leaving Kaizendex. Vimeo, Loom, Spotify, TikTok, SoundCloud, Figma, CodePen, Google Maps and X posts all work the same way — see Links, embeds and bookmarks for the full list and what happens to links that can't be embedded.
Reading it later
Once a Collection has a Description, an About option appears wherever entries of that Collection are shown.
From a card. Open the ⋯ menu on any card in your log, board or calendar and choose the About option — it's named after the Collection, so on a push-ups log it reads About Push-ups. The Description opens in a panel on top of what you were looking at. Close it and you're exactly where you left off.
From an exercise inside a workout. If you use sub-entries — a Workout entry holding a list of exercises, a Dish holding its ingredients — each row has its own ⋯ menu, and it offers About for that row's Collection. So mid-workout you can open a set of push-ups and pull up the push-up how-to without closing the workout.
From a "How to" button on the card itself. If the ⋯ menu is one step too many for a Collection you look up often, you can put a button right on the card. Open the Collection, go to the Card layout editor, and add an action:
"actions": {
"how_to": { "action": "open_info", "label": "How to", "icon": "lucide:info", "style": "ghost" }
}
That's it — no target needed, because the button belongs to the Collection rather than to any one field. It's yours: rename the label, change the icon, move it, or delete it. And it's safe to copy between Collections, because it only shows up where a Description actually exists.
Buttons are never added for you. A Collection with a Description but no button in its card layout still has the ⋯ menu route — that one is always there.
The panel is for reading. If you want to change what it says, the Edit description button at the bottom takes you to the Description tab.
Why you sometimes don't see an "About" option
The About option only appears when the Collection actually has a Description written. No description, no option — a bedtime checkbox stays clean and uncluttered, while a Push-ups Collection with a form guide offers its guide.
There's nothing to switch on or off. Writing a Description is the switch.
Next
- Creating a Collection — where the Description tab lives
- Links, embeds and bookmarks — every link type that turns into something richer
- Sub-entries — entries made of other entries, like a workout of exercises
- AI instructions — the sibling tab, for guidance you're writing to the assistant instead of yourself