The Timeline
When it matters. You are reading about a war, a dynasty, a disease, a case, a family — and your notes are full of dates, scattered over fifty pages. Which events overlap? Where do two of your sources give different dates for the same thing? The Timeline draws every page you have dated on one line, and shows you where each date came from.
The one rule. A page is on the line only when you gave it a date. You give a page a date in one of two ways: you fill in Start (and, if you like, End) in Page info, or you type a line such as Date: August 23, 1942 as the very first line of the page. (Start and End simply write that line for you.) MojoPad never puts a page on the line on a guess. When your sentences hold dates, such as “the battle began on 23 August 1942”, those dates wait in a list as suggestions, and nothing moves until you press Place.
What it is not. The Timeline shows the dates your pages are about, never when you wrote them. A note you made yesterday about a battle in 1942 sits at 1942. The map's ◷ Growth replay is the one that replays how your wiki grew, by when each page was made. The Timeline also does not need AI or the internet, and looking at it changes nothing in your pages.
New here? Read Your first five minutes next. Every button is explained after that, and the last two sections, Troubleshooting and Frequently asked questions, answer the things people get stuck on.
Your first five minutes
When it matters. You have never opened the Timeline and want to see something working before you read anything else.
What to do. Say your wiki holds notes about the Second World War in the Pacific. To point at something, rest the pointer on it (or press Tab until it is selected).
- Open it. Press
⌃⌘L, or press the Timeline button in the toolbar. The Timeline fills the pane you are in. Press the same key or button again to close it. - Read the quiet line near the top. It says what it found, for example Found 3 dates in 3 pages · 38 not yet placed. Pages you dated are bars on the line. If it says No dates yet, nothing is wrong: you have just not dated a page yet. Go on to step 3, or see No suggestions in your wiki? below the steps.
- Look at the side panel on the right. Open Not yet placed. At the top is Suggested dates: pages whose own words hold a date. Nothing in the list is on the line yet, and nothing in your pages has changed. Point at Battle of Midway: a card shows the date it would get, and the sentence it comes from.
- Place one. Press Place on a row whose sentence you agree with. The page joins the line as a bar, and a note says what was written, with an Undo button. If you do not see the bar, press the All time crumb at the top, then Fit (at the bottom), to bring every bar into view.
- Point at the new bar. A card headed You set this date appears. Press Open in page on it to read the sentence in its page, in a pane beside the Timeline.
- Look around. Scroll (mouse wheel or two fingers) to zoom in and out. Drag empty space to move along the line. Press Fit to bring everything back.
- Take it back. Do not like what you placed? Press Undo in the note (it stays for about seven seconds), or press
⌘Zwhile the Timeline is up. The page leaves the line and returns to Suggested dates. Your page's earlier version is also kept in Page Versions. - Close it. Press
Esc: it steps back one level at a time, and at the very top it closes the Timeline. Or press⌃⌘Lagain.
No suggestions in your wiki? Close the Timeline and open any page about something with a known date. Open Page info. In the Dates section, type
Aug 23, 1942 in Start and press Set date. Press ⌃⌘L and the page is on the line.
Opening the Timeline
When it matters. You want to see your dated pages together, or check a date, from wherever you are working.
What to do. Use any one of these:
- the Timeline button in the toolbar (it has a small ◷ on it; a toolbar you arranged yourself may not show it);
- Timeline in the rail's See group, when the calm frame is on;
- View ▸ Timeline, whose shortcut is
⌃⌘Lunless you changed it in Settings ▸ Shortcuts; ⌘K(Find anything), then type Timeline and choose Timeline — the pages you’ve dated. Where⌘Kwould instead complete a page name you are typing, use⇧⌘P, which always searches.
It works with no setup. The Timeline takes the whole pane you were in, as the Map of Your Notes does. Pressing the button or ⌃⌘L again, or Esc at the
very top level, closes it. Opening a page in that same pane also replaces it (see Troubleshooting).
What you are looking at.
- The top row. The crumbs (All time and the levels you have opened) and a small esc chip; the chip that says what is on the line (Showing all 186 pages) with Choose…; the quiet line Found 12 dates in 12 pages · 31 not yet placed; and Group by (Theme, Kind, Tag).
- The stage in the middle. The ruler across the top, then rows, each with a name and a colored dot. Your dated pages are bars on those rows (a very short date can be drawn as a dot).
- The side panel on the right. Facts about the level you are on and, at the top level, Not yet placed.
- The bottom. The All of time strip, and the −, + and Fit buttons.
When the wiki has no dated pages yet. The Timeline shows No dates yet and says how to give a page a date: set Start and End in its Page info, or start its first line with Date: Aug 23, 1942. The Show me how button opens this chapter of the manual. If your sentences already hold dates, a link such as 3 pages have a suggested date takes you straight to them. On this screen Group by is dimmed and the Choose… chip is not shown, because there is nothing to group or choose yet.
Other things you may see. On a big wiki a note such as Reading dates… 412 of 907 pages shows while MojoPad reads your pages for dates; the window keeps working. If the whole wiki is locked, the Timeline says Unlock to see dates and shows nothing of your pages. A page that has its own password or is locked is never read (see Privacy).
This is not the map's ◷ Growth replay, which replays how your wiki grew by when each page was made. The Timeline is about the dates you give your pages.
Giving a page a date
When it matters. You know when something happened and want it on the line: a battle, a birth, a dynasty, the week you started a project.
What to do. Open the page and open Page info (the panel at the side; in the calm frame it is the slim Page info tab at the right edge). The Dates section, subtitled Puts this page on the Timeline, has two fields, Start and End.
- Type Aug 23, 1942 in Start. That is a single date.
- For a stretch of time, also type Feb 2, 1943 in End. Leave End empty for a single date.
- Press Set date, or press Return in either field. The button is dimmed until you type something. Once the page has a date it reads Change date.
Forms that work. A day (Aug 23, 1942, 23 Aug 1942 or 1942-08-23), a month (August 1942), a year (1942), before the common era (44 BCE, or Mar 15, 44 BCE), and about (c. 1500). You can also type a single range, such as June 4–7, 1942, in Start alone, with End empty. The empty Start field shows an example written in the order your Date format setting uses. A slash date such as 3/4/2025 is read by that setting (see Writing dates your way).
What the red field means. If something cannot be read as a date, the field turns red and a sentence under the fields says what to fix, with examples. Nothing is written until it is right. You will see sentences such as these:
- Type a start date first. Leave both empty and nothing changes. Both fields were empty.
- Add a start date first; the end alone isn’t enough. Only End was filled in.
- I can’t read “soon” as a date. followed by examples: that field is the red one.
- The end comes before the start. Swap them, or fix the year.
- The start is a range already. Keep one date in each field, or clear the end. You typed a range in Start and also filled in End.
- Those two dates can’t be written as one line MojoPad reads back. Use the same kind of date in both (both days, both months, or both years). Both fields go red.
What gets written. The dates become the first line of the page, Date: August 23, 1942 – February 2, 1943, in plain words you can read, edit or delete like any other line. That line is the whole story: there is no hidden date on the side. If the page already starts with a Date: line, the new dates replace it, so they do not pile up. The earlier version of the page is kept in Page Versions first (if that cannot be done, nothing is written), and a note under the fields, such as Set Stalingrad notes to Aug 23, 1942, has an Undo button. The note stays until you type in the fields again or press Undo.
Where the Dates section is not shown. Page info offers Dates only for pages of writing: rich text, Markdown and plain text. A PDF or other file, a drawing, and a locked or password-protected page do not get it, because a date line cannot be written into them.
Typing the line yourself. You can skip Page info. Make the very first line of the page Date: followed by one date: Date: August 23, 1942, Date: 1942, Date: c. 1500, Date: 44 BCE, or two dates joined by a dash, Date: August 23, 1942 – February 2, 1943. Three rules matter:
- It must be the first line with writing on it. On a Markdown page it may also sit right under a first line that is a # heading.
- Write Date: with a capital D and a colon. date: 1942 is not read.
- Everything after the colon must be one date and nothing else, and it should be spelled out. A slash date such as 3/4/2025 is too easy to misread, so it is not accepted in a typed Date: line (typing it into Start in Page info is fine, and MojoPad writes it out in words). A line is always read month first, whatever your Date format setting says.
The open Timeline notices the change a moment after you stop typing.
Not yet placed: suggested dates and undated pages
When it matters. Your pages are full of dates in sentences — “the battle began on 23 August 1942” — and you want to put the right ones on the line without typing each again. Or you want to know which pages have no date at all.
Where it is. Not yet placed is a list in the side panel on the right, with a count beside it. It shows when you are looking at the top level (All time, or a stretch of your reading).
If you have opened a row or a page, press the All time crumb or Esc to get back to it. The … not yet placed link in the quiet line at the top jumps to it. The list does not appear when every page is already on the line.
Suggested dates. At the top of the list, Suggested dates names every page whose own words (or another page's sentence that names it) hold a date, each with the date it would get. The small print says Found in your text, but not on the line until you place them. Nothing in your pages changes until you do. Point at a row, or Tab to it, to see why: a card says Suggested · not on the line yet, the date, Suggested from sentence in “Stalingrad notes”, and the sentence itself with the date marked. When a suggestion comes from another page's sentence that merely names this one, the card adds (a sentence that names this page), because a short name like “Art” or “Rome” can be mentioned in passing. Pressing the page's name opens the page.
- Place on a row writes that one date as the page's Date: line. The page joins the line, and a note says what was written, with Undo.
- Place all suggested (31) does it for every suggestion at once, after asking: Write a “Date:” line at the top of 31 pages? It also says how many of them come from a sentence in a different
page, so you can look at those first. Place 31 pages goes ahead; Cancel writes nothing. Each page's earlier version is kept in Page Versions first, and one Undo in the note (or
⌘Z) takes every one of them back. If some pages cannot take a date line (a locked page, say), the rest are still placed and the note says how many could not. - Dragging a page from the list onto the line places it too, at the date under your pointer (see Changing a date by dragging). This works for suggested pages and for undated ones alike.
Pages with no suggestion. Under the suggestions, the line Drag a page onto the line to place it introduces the pages with no date at all. The ones whose date MojoPad is unsure of come first (point at one to read why), then the ones you edited most recently, each with its kind when it has one. The list names five pages in each group; and N more… opens the rest, and Show fewer folds them back. Each page is a chip: press it to open the page, or drag it. To place one, give it a date in Page info, drag it onto the line, or, if it has a suggestion, press Place.
What is left out of the list. A page that only dates other pages (a source such as a clipped article) is not counted as unplaced. A locked page, a page with its own password and a page in the trash appear nowhere. A PDF or other file is listed, but it is never given a suggestion, because a file cannot take a Date: line; dragging one onto the line is refused with a plain sentence. The sentences inside a PDF can still suggest dates for your other pages.
What it reads, and how
When it matters. You write the way you naturally write — “the battle began on 23 August 1942”, “c. 3300 BCE”, “the second half of 1941” — and want it understood as you wrote it, not rewritten into a form.
What to do. Nothing: write dates in sentences, in any page. MojoPad reads English dates in these forms, and offers them as suggestions under Not yet placed ▸ Suggested dates. They never put a page on the line until you press Place.
| Form | Examples |
|---|---|
| A full date | 23 August 1942 · August 23, 1942 · 1942-08-23 |
| A month | August 1942 · September 1941 · June of 1944 |
| A year | in 1942 · since 1939 · 1941: (as a list entry) |
| Before the common era | 1274 BCE · 3300 BCE · 1600 BC · 44 BCE |
| Approximate | c. 3100 BCE · circa 3200 BCE · around 2560 BCE · c. 1850 |
| A range | 1939–1945 · between 1939 and 1945 · between March and May 1942 · 4–7 June 1942 |
| A season, or part of a year | spring 1942 · summer of 1941 · the second half of 1941 · early 1942 |
| A decade or a century | the 1930s · early 1940s · the 340s BCE · the 5th century BCE |
A date is a start, an end or a point according to the words beside it (“began”, “from”, “until”, “ended”). A sentence that names another page — by its title, an alias or a [[link]] — is counted as being about that page, so a source page that says “Stalingrad began on 17 July 1942” suggests that date for your Stalingrad page. It is only ever a suggestion until you place it.
When a date is worded loosely, the line reflects it: “c.” and “early 1940s” fade at their edges instead of ending sharply.
What it does not read. Relative dates (“two weeks later”), dates with no year (“on the 7th”), a bare number that could be anything (a lone “1500 ships” is a count, not a year), dates in other languages, and other calendars: every date is read as Gregorian, and nothing is converted. A bare year with nothing around it to vouch that it is a year is not even suggested; the page waits in the tray as it is (see Not yet placed). The dates when you made or changed a page are never events — the Timeline is about what your pages say, not when you wrote them — and the “Retrieved”, “Accessed” and “Last updated” lines on clipped web pages are skipped.
Why a date is where it is
When it matters. A date on a line is only worth trusting if you can see where it came from.
What to do. Point at a bar or a dot (or Tab to it) and a card headed You set this date appears, with the line Written in this page's own “Date:” line. Nothing was guessed. Beside the heading it says how exact the date is (exact day, to the month, approximate · to the year…). It shows the date, how long it lasts, the page and its source, and, under Also happening, what else was going on at the same time. (A c. in a date means “about”; point at it to see.) If the page's own sentences say something else, the card adds Your source says… and From sentence in <page>, with that sentence marked: press it, or press Open in page, and that page opens with the sentence lit, so you can read the paragraph around it. Pointing at a bar also lights a column across every row, and everything that overlaps stays bright while the rest dims. In the list of suggestions the card says Suggested from sentence in <page> instead, because those pages are not on the line yet.
The foot of the card says Click to open it here · ⌘-click to open its page. Open it here means the bar's details in the side panel (see Drilling in); ⌘-click opens the page itself, by whatever your Settings ▸ Links & Pages choice for opening pages says. A small line also reminds you that the ends of a bar can be dragged (Drag the ends to change dates), or that a dot can be moved (Drag it to change its date), and the card has × Hide from Timeline and, for a tagged page, Only and the tag (see Choosing what's on the Timeline).
The sentence is found again each time you look. It is never written into your pages.
Keep an event and its page connected
When it matters. You pressed Open in page to check a date against its source, and now you are reading the page and want to know which bar it came from, or you glance back at the Timeline and wonder which page you opened.
What to do. Press Open in page (or the sentence itself) on a card. The page opens beside the Timeline, and a line runs from the bar you pressed to the page. The line stays until you go on working somewhere else, so there is no hurry to read it. Right after the page opens, your next click, key press or wheel turn outside it puts the line away. From then on it follows the pane you are in: it shows while you are in that page, goes quiet when you move to another pane (a click, Tab, Next Pane or a menu), and comes back when you click or type in the page or move into it again. Turning the wheel over the Timeline while the page is the pane you are in keeps it. It follows the bar as you zoom, pan, scroll or resize the window. Two events from one page each draw from their own bar, and opening a second event into the same pane moves the line to that event. This works from the card's Open in page, from the sentence on the card, and when you Shift-click a bar. Pages opened any other way (a chip in Not yet placed, ⌘-click on a bar, a dated line in the side panel) open as they always have and draw no such line.
When there is no line. The line only joins things you can see. If the bar is folded into a count badge, scrolled out of its row or past the edge, or hidden, or the page is hidden or behind another tab, the line is hidden, and it returns when the bar does. It ends for good when you close the page or open something else in its pane, and when you close the Timeline. Nothing about it is saved, so it never changes a page. Links in a page, Ask answers and passage chips still draw their own line, which fades after a few seconds.
Rows that sort themselves
When it matters. A wiki about one war holds three fronts; a wiki about the ancient world holds several empires. You want them in rows, without sorting them yourself.
What to do. Use Group by at the top: Theme, Kind or Tag (point at each for a one-line explanation). Bars slide into their rows. Theme makes one row per subject MojoPad finds in your reading (see Map of Your Notes and Local AI); until those subjects have names it opens on Tag when at least half of your dated pages carry a tag, and on Kind otherwise, and pointing at the button that is on tells you why (for example Tag (no themes yet)); a choice with nothing to sort by is dimmed. Pages that do not fit are not dropped — they sit in an honest Unsorted, No kind or Untagged row, always the last one and drawn in a quiet gray (you can still give it a color of your own, below). Bars keep their theme color in every grouping, so under Kind you can still see which front a battle belonged to.
Choosing a row's color
When it matters. Two rows came out in colors that look alike, or you want the war's three fronts in the colors you think of them in, or one row simply should stand out.
What to do. With Group by on the grouping the colors come from (the one the Timeline opened on), point at the colored dot beside a row's name: it says Change color. Press it, and a small panel opens under the dot with the ten colors and Automatic. Press a color and the row, its bars, its threads and the all-of-time strip at the bottom change at once; the one in use wears a check. Press Automatic to give the row back the color MojoPad chose. Press anywhere else, or Esc, to close the panel without changing anything. From the keyboard, Tab to the dot, press Return or Space, move with the arrow keys and press Return.
A wrong pick is not final: Edit ▸ Undo (⌘Z) puts the earlier color back, and Redo (⇧⌘Z) does it again. Your colors are kept with the wiki, so they are there next time you open it, and they follow it to another Mac. Under another Group by the dots are plain, because the colors belong to the one grouping the bars take them from; switching Group by never changes a color, and your picks are waiting when you switch back.
Choosing what's on the Timeline
When it matters. Your wiki holds notes on voyages, on trade and on the sciences, and today you are writing about the voyages only. Or a clipped PDF, a scan and a few dozen reference pages have put so many dates on the line that you cannot see the ones you wrote. You want the line to show the pages you are working on, and the rest set aside for now — not deleted, not changed, only not drawn.
What to do. Look at the chip at the top of the line, next to the crumbs. With nothing chosen it reads Showing all 186 pages; the pages it counts are the ones that have a date. (The chip is not shown until at least one page has a date.) Press Choose… on it.
- A panel opens where the side panel was, headed with how many pages are on the line (42 of 186 pages). The line keeps drawing behind it, and changes with every box you check, so you see what you are choosing.
- Check a whole tag to put every page with that tag on the line, or a whole kind (Event, Person, Source… and, for files, File: PDF and File: image). Each row shows how many pages it holds; a row that is only partly checked shows 40 of 41. Untagged and No kind gather the pages that have neither.
- Check or uncheck single pages in the list under them. It holds every page that has a date, A to Z, however many you have — scroll it, or press a letter in the slim index beside it to jump there (a letter dimmed in the index has no page). Your daily pages (the ones named for their date) and your files stand folded under Daily pages (12) and Files (3) so they do not flood the list: press the small arrow to open one, or press its box to check all of its pages at once — the box shows a dash when only some are checked. Type in the box at the top of the panel to narrow all three lists to the tags, kinds and pages that match; typing a tag's name also lists the pages that carry it, and a group that holds a match stays open while you search.
- Show all checks every page. Clear all unchecks everything, and the line says Nothing chosen yet until you check something, which is the way to build up from nothing.
- Press Show 42 pages to keep what you have checked. A note says Showing 42 of 186 pages on the Timeline with an Undo, and the line moves to fit those pages (unless you have already zoomed or moved it yourself). Cancel (or
Esc) closes the panel and puts the line back as it was. Save as… opens a box, Name this choice — type Voyages study and press Save (or Return); Never mind goes back without naming it — so the chip reads Voyages study · 42 of 186 pages instead of Your choice · 42 of 186 pages. Save as… is dimmed until you have unchecked something, because with every page checked there is nothing to name.
Take one page off, or keep one tag. Point at a bar. Under the card, × Hide from Timeline takes that page off the line, and Only followed by its tag sets everything but that tag aside. Each says what it did in a note with an Undo. The page stays in your wiki, untouched; bring it back from Choose…, or press Undo.
Show all, and back again. With a choice in force the chip has a Show all button. It puts every page back on the line but keeps your choice; a button then appears that takes you back to it, reading Use your choice (or Use Voyages study when you named it). The chip counts what the line shows, and the side panel's Set aside from the Timeline row says how many pages are left off.
What is remembered. The choice belongs to the wiki, not to the window: it is there when you open the wiki again, and when you open it on another Mac, and a password on the wiki seals it with everything else. It is kept as rules, not as a list of pages. So a page you add later that carries a checked tag or is of a checked kind appears on the line (once it has a date) without your doing anything, and a page you took off by hand stays off even if its tag is checked. A page you drag onto the line from Not yet placed stays on it. The Timeline reads your pages once whatever you choose; checking and hiding only change which of the dates it has already found are drawn, so they are as quick on a wiki of thousands of pages as on a small one. Nothing in any page is ever changed by a choice.
Finding your way around
When it matters. You want the whole of the Bronze Age on one screen, then a single week in November 1942 on the next, and you want to get back without getting lost.
Zoom and move. Scroll (mouse wheel, or two fingers up and down on a trackpad) or pinch to zoom around your pointer, from millennia down to days. Drag empty space to move along the line; a sideways scroll moves it too. The ruler changes its own units as you go, and a small chip on it keeps the year in view. Dates run from before the common era to the future. Because scrolling zooms, the mouse wheel does not scroll the rows: see Troubleshooting if you have more rows than fit.
Buttons and keys instead. At the bottom, − zooms out, + zooms in, and Fit (it says Fit this level in view when you point at it) brings everything on the level you are on back into view. From the keyboard, ← and → move along the line, + and − zoom, and 0 does what Fit does.
The hint line. A quiet line beside All of time reminds you of the gestures — Scroll to zoom · drag to move · click a row or bar to open it · esc to go back — and goes away once you have zoomed and opened something in this session. Every gesture has a button too: − and + to zoom, the row name or bar to open it, the esc chip and the crumbs to go back, and Open in page on the card (⌘-click on a bar opens its page too, but without the lit sentence).
Dates too close to tell apart. Where several dates sit too close to draw, a small badge counts them (2 dates, 6 dates 1941–44). Press it to zoom in on them. Esc (or the esc chip) puts the line back exactly as it was, one badge at a time, and keeps you on the level you were viewing; press Esc again to go up a level, and again at the very top to close the Timeline. Fit, the 0 key, a crumb or opening a row or bar starts fresh, so an old zoom never returns.
The All of time strip at the bottom always shows where your knowledge sits in history, with a lens marking the part you are looking at. Press or drag anywhere on the strip to carry the window there, or press a stretch's name under it to fly to that stretch of your reading. When your dates fall into more than one stretch, the Timeline opens on the most recent one; the top crumb, All time, is one click away.
Drilling in
When it matters. One row is crowded and you want only that; one page has a dozen dated lines and you want them combed out.
What to do. Click a row's name and it opens up while the others fold into thin strips that stay in view (point at the name: Click to zoom to this row). Click a bar and you are inside the page: the side panel lists every dated line it contains (Dated lines in this page), with what overlaps it (Overlaps with) and by how many days, and the lines are combed out under the bar with the words that go with each date. Pressing a dated line in the side panel opens that sentence in its page. A plain click on a bar never leaves the Timeline; ⌘-click opens the page.
Getting back. The breadcrumb at the top
(All time › a row › a page) can be clicked at every level. The small esc chip beside it (Go back one level) and the Esc key go up one level; at the top level Esc leaves the
Timeline. There is no separate Back button: the crumbs, the esc chip and Esc are the ways back.
Long lists of rows. When there are more rows than fit, the stage scrolls up and down. Opening a row, a bar or a
stretch always starts at the top of what it opens, so the page you chose is in view. Going back — Esc, the esc
chip or a crumb — returns each level to the place you left it, rows scrolled as they were. Scrolling inside a view, pointing at a bar and
the Timeline refreshing never move it.
A side panel that fits your reading. The panel on the right, with the page's details and Not yet placed, can be made wider or narrower: drag its left edge, and double-click the edge to put it back (point at the edge: Drag to resize · double-click to reset). MojoPad remembers the width on this Mac. The edge is not there while the Choose… panel is open, because that panel takes the side panel's place.
The Timeline also points out overlaps. An At the same time card in the side panel names events that run together — “three fronts turn at once, 20 days in common” — and its Show me › button takes you there.
When your sources disagree
When it matters. Two books date the same event differently. You wrote both down; you never put them side by side.
What to do. Decide it yourself, once, on the page. Type the date you trust in Start (and End) in Page info. That page is then decided: its own Date: line wins, and it is not drawn as a quarrel with its sources. Point at its bar and the card still shows the other source, so nothing you read is hidden: Your source says Jul 17, 1942, From sentence in Stalingrad notes, with the sentence itself, and Open in page takes you to it. Two dates agree when they overlap or sit within a day of each other, so “in 1942” and “August 23, 1942” never disagree.
The hatched span with pins A and B, the ≠ Sources disagree chip and the choices Prefer A and Prefer B belong to a page whose date is drawn from its sentences. The Timeline no longer draws a page that way, so you will not meet them while every page on the line is one you dated.
Changing a date by dragging
When it matters. A page has no date yet and you know when it belongs. Or a bar is a month too long, a battle sits a year off, a dot is on the wrong day — and you can see it right there, and would rather fix it where you see it than hunt for the sentence.
To place a page, drag it onto the line: from Not yet placed (the chips can be picked up), or from the page list in the sidebar. While you hold it over the line, a thin guide and a caption — Place at Aug 23, 1942 — follow your pointer, snapped to what the ruler is counting: a day when you are zoomed in close, a month a little further out, a year when you are looking at centuries. Drop, and the page appears on the line at once, with a note (Placed Field notes at Aug 23, 1942) and an Undo beside it. If you drop something that is not a page, the note says Drop a page from the sidebar or the Not yet placed list. If the page already starts with a Date: line, the new one replaces it.
To change a date, point at a bar: a round handle appears at each end. Drag an end to move that end
(Starts Aug 23, 1942 / Ends Feb 2, 1943 in the caption), or drag the bar itself to move the whole
thing and keep its length. A dot moves as a whole. The bar, its label and the caption follow your pointer as you
go, and the dates snap to whole days, months or years, whichever the ruler is counting; Esc in the middle puts everything back and writes nothing. A start cannot pass its end.
Pressing a bar and letting go without moving (a small wobble counts as not moving) still opens its details, and dragging empty space still pans. When you let go, a note says
what changed (Changed Field notes to Aug 23, 1942 – Feb 2, 1943) with an Undo.
What gets written. The Timeline never keeps a date of its own on the side: whatever you drag goes back into your words, as the page's own date on one line at the very top — Date: August 23, 1942, or Date: August 23, 1942 – February 2, 1943 — the same line Page info's Start and End write. A page you drop onto the line gets the same line. Your sentences are never touched, so a quotation, a source or a clipped web page stays exactly as it was. If the page already has a Date: line, that line is changed rather than a second one added. You can read the line, edit it, or delete it like any other line; delete it and the page leaves the line. Keep it as the first line of the page and it is the page's date, which is read for sure.
A date you set this way is a decision, so it wins over the page's sentences. The card says You set this date and, when a sentence differs, shows Your source says Jul 17, 1942 with that sentence under From sentence in <page>.
Safe by design. Before anything is written the page is kept in Page Versions, and if that can't be done nothing changes (The earlier version couldn’t be kept, so nothing was changed.). A locked page, a page with a password, a file, a drawing and a page in the trash are refused with a plain sentence (This page is locked, so its date can’t be changed here. or This page is a file or a drawing, so its date can’t be changed here.). Everything is refused too while your changes are on hold for another device (Changes are on hold until the other device’s version is settled.) and in a window that only shows the wiki. Dragging a bar to the very same date says That is the same date, so nothing was changed.
Undo and Redo. Press Undo in the note (it stays for about seven seconds), or ⌘Z / Edit ▸ Undo while the Timeline is up, to take the last change back, and ⇧⌘Z / Edit ▸ Redo to do it again.
These keys leave you alone while your cursor is in a text box. Undo goes back one step: the most recent change, where Place all suggested counts as one step. It works only as long as you
haven't edited that page since; if you have, it says so (… has changed since, so the date stays as it is.) and leaves your page alone. Closing the Timeline forgets what could be undone,
but the page's earlier version is still in Page Versions.
Suggest dates, with AI (optional)
When it matters. A page states its dates in a roundabout way — a long essay, a letter, a chapter summary — and the plain reading above finds nothing, or you want to ask a particular question: when did the siege end?
When it is there. ✦ Suggest dates sits in the Dates section of Page info, beside Set date. It is shown only when AI is on, for the app and for this wiki. If you have turned AI off for either, the button is not shown at all, and everything else in this chapter works the same. It is also not shown on pages that have no Dates section (a PDF or other file, a drawing, a locked page).
What to do.
- Open the page, open Page info, and press ✦ Suggest dates. A small panel opens with a box, What should it date? (optional) e.g. when the siege ended, and the buttons Find dates and Cancel.
- Type a question if you like (you can leave it empty), then press Find dates or Return. It says Reading this page… while it works.
- It lists what it found: 2 dates found. Nothing is written until you press Apply. Each date shows the sentence from your page it is taken from, word for word, under From this sentence in the page, and how sure it is: Sure (The page states this plainly), Likely (Likely, but the page is not explicit) or Unsure (Unsure: check the sentence before applying). It lists at most five dates.
- Read the sentence. If it is right, press Apply on that date. If not, press Cancel.
What Apply does. It writes the same Date: line as typing Start and End, so the page joins the Timeline. The earlier version is kept in Page Versions, a note with an Undo appears, and the panel closes. Cancel writes nothing, and so does simply reading the list. A date whose sentence is not really in your page is dropped, so the AI cannot make up a source.
Which model reads the page. A model running on this Mac, and only when you press Find dates. It is never an online service, and never your own AI agent app, even if you have chosen one for Ask. It reads the first part of the page (about the first twelve thousand characters). Your page's words do not leave this Mac. If no model is installed here, the panel says No AI model on this Mac could answer just now. You can still type Start and End yourself.
When it finds nothing. The page doesn’t say clearly enough. Nothing to suggest. means no date in the page could be checked against its own words. This page has no words to find a date in yet. means the page is nearly empty. Either way you can still type Start and End yourself.
It is only an assistant: the Timeline never depends on it, never reads its suggestions, and it never puts a page on the line without your pressing Apply.
Writing dates your way: the Date format setting
When it matters. 3/4/2025 is March 4 to one reader and April 3 to another, and a week begins on Sunday for some and Monday for others. MojoPad asks once, in Settings ▸ Dates & Time ▸ Date format, and each choice shows today's date the way it would read, so you can pick by looking:
- United States (the choice every wiki starts with) — Nov 5, 2026; 3/4/2026 means March 4; weeks start on Sunday; 12-hour clocks.
- United Kingdom & Europe — 5 Nov 2026; 3/4/2026 means April 3; weeks start on Monday; 24-hour clocks.
- International (ISO) — 2026-11-05; weeks start on Monday; 24-hour clocks. A slash date like 3/4/2026 is never guessed at; one with a number past 12 (25/12/2026) is still read, since it can only mean one thing.
- Follow my Mac — the order, first day of the week and clock your Mac's region uses.
What it changes. How dates are shown everywhere: a page's Created date, the Timeline's labels, ranges, ruler and hover cards, the Start and End fields in Page info, and the suggested dates. It also decides how a slash date in your sentences, or typed into Start or End, is read. Type 3/4/2025 in Start with United Kingdom & Europe chosen and the page is dated April 3, 2025.
What it never changes. The date written on a page is always spelled out in words — Date: August 23, 1942 — so it means the same on any Mac, and switching the setting never moves a page on the line or edits one. Daily note names keep their own pattern (Daily note name), and no page is renamed.
Troubleshooting
Each answer below comes from how the Timeline actually works, so you can trust it.
My page isn't on the Timeline
A page is on the line only when it has its own date. Check, in this order:
- Does it have a date line? Open the page. Its first line must be Date: (capital D, then a colon) and one whole date, such as Date: August 23, 1942. Or open Page info and fill in Start and press Set date. A date in the middle of a sentence is not enough: it only makes a suggestion (see the next item).
- Is it a PDF or other file, a drawing, or a locked page? These cannot take a date line, and a locked or password-protected page is never read.
- Did you set it aside? If the chip at the top says something like Voyages study · 42 of 186 pages, a choice is in force and the page may be left off. Press Choose… to check it, or Show all on the chip to see everything.
- Is it out of view? The line may be zoomed to another era. Press the All time crumb at the top, then Fit, or look for the page in the All of time strip.
- Did you just change it? The Timeline notices a moment after you stop typing.
I see a suggestion, but nothing on the line
That is how it is meant to work. A date found in a sentence is a suggestion under Not yet placed ▸ Suggested dates, not an event. Press Place on the row (or Place all suggested) and the page joins the line.
✦ Suggest dates is missing
The button is shown only when AI is on for the app and for this wiki, and only in the Dates section of Page info of a page of writing (not a file, a drawing, or a locked page). Turn AI on in Settings, or type Start and End yourself. If the button is there but says No AI model on this Mac could answer just now, no model is installed on this Mac that can answer.
The Timeline is empty after I chose…
Your choice has set every dated page aside. The Timeline says Nothing chosen yet — press Choose… to check some pages, or Show all to bring them back. Press Show all to put every page back, or Choose… to check the ones you want. Nothing in any page was changed. You can also press Undo in the note that appeared when you chose.
Esc closed the Timeline
Esc steps back one level at a time (a zoom on a date-count badge first, then a page, then a row, then a stretch of your reading) and, at the very top level, it closes the Timeline. That is by design. Open it again with ⌃⌘L.
To go back without risking that, use the crumbs at the top or the esc chip, or press the All time crumb.
The Timeline went away when I opened a page
The Timeline fills a pane, so a page that opens in the same pane replaces it. A chip in Not yet placed and a ⌘-click on a bar open pages by your Settings ▸ Links & Pages choice, which by default is
Open links and results in the same view. Press ⌃⌘L to bring the Timeline back. If you want pages to open next to it, choose Open Beside the page you are in there. Open in page on a card normally opens the page in a pane of its own beside the Timeline.
My drag was refused, or did nothing
- This page is locked, so its date can’t be changed here. The page is locked or has a password. Unlock it first.
- This page is a file or a drawing, so its date can’t be changed here. A file or drawing cannot take a date line. Give the page that describes the file a date instead.
- Changes are on hold until the other device’s version is settled. Settle the version your wiki is asking about, then try again.
- The earlier version couldn’t be kept, so nothing was changed. MojoPad will not write a date without keeping the earlier version first. Try again.
- That is the same date, so nothing was changed. The bar ended up where it started.
- Drop a page from the sidebar or the Not yet placed list. What you dropped was not a page.
- Nothing happened at all: the pointer moved too little, so it counted as a click (a click opens the bar's details), or you pressed
Escin the middle, which cancels a drag on purpose.
Dates show in the wrong order or format
Open Settings ▸ Dates & Time ▸ Date format and choose United States, United Kingdom & Europe, International (ISO) or Follow my Mac. It changes how dates are shown, in the Timeline, in Start and End, and how a slash date you type is read. It never edits a page: a Date: line stays written in words.
My mouse wheel zooms instead of scrolling the rows
On the Timeline, scrolling zooms the line. If you have more rows than fit, the rows scroll on their own thin scroll bar at the right edge of the rows. A quicker way is to click a row's name to open just that row, or to pick a different Group by.
Undo says the page has changed
Undo puts back the earlier date only if the page still reads exactly as the Timeline left it. If you have edited the page since, Undo says so and leaves your page alone. Your earlier versions are always in Page Versions.
Place all suggested says some pages couldn't take a date
The note says how many. A locked page, a file or a page whose date cannot be written as a Date: line is skipped, and the rest are placed. One Undo still takes back all that were placed.
A locked page is missing, or the whole Timeline says Unlock to see dates
A locked page, or a page with its own password, is never read, so it appears nowhere: not on the line, not in Not yet placed. If you lock one while the Timeline is open, it leaves the line. If the whole wiki is locked (by the idle lock, say), the Timeline stays closed and says Unlock to see dates until you unlock.
Frequently asked questions
Does the Timeline change my pages? Looking never does. Your pages change only in these ways, and each one writes only the page's Date: line, after keeping the earlier version in Page Versions: you press Set date or Change date in Page info, you press Place or Place all suggested, you drop a page onto the line or drag a bar, or you press Apply on an AI suggestion. Choosing pages, hiding one, Group by and row colors change nothing in your pages.
Does it need AI or the internet? No. It reads your pages on your Mac. The only AI is the optional ✦ Suggest dates button, and it uses a model on this Mac and is hidden when AI is off.
What about BCE, circa and ranges? All three work, in Page info and in a Date: line: 44 BCE, c. 1500 (about), and a range such as August 23, 1942 – February 2, 1943. A date written as c. fades at its edges instead of ending sharply. Every date is read as Gregorian and nothing is converted.
Can I undo? Yes. Press Undo in the note, or ⌘Z while the Timeline is up; ⇧⌘Z does it again. It takes back the most recent change, as long as you have not edited that page since. Earlier versions are also in Page Versions.
Where is my choice kept? The pages you chose with Choose… and the colors you gave rows are kept with the wiki, so they follow it to another Mac and are sealed if the wiki has a password. Which Group by you last used and the width of the side panel are remembered by MojoPad on this Mac, not in the wiki.
Can a page be on the Timeline twice? No. A page is one bar. Other dated lines in the page are listed when you open its bar, under Dated lines in this page.
Why does a page's bar show a different date from my sentence? The date you set in the Date: line decides. The card still shows the other date under Your source says, so nothing is hidden.
Does it show when I made or edited a page? No. That is never an event. See What it is not at the top, and the map's ◷ Growth replay.
Privacy
The Timeline reads your pages on your Mac, and needs no AI and no network. A locked page is never read, and nothing from it is kept; lock a page or a wiki while the Timeline is open and it disappears from the line. The line, the suggestions and the sentences behind them are worked out each time and are not stored in your pages. The Timeline writes into a page only when you set its date, place a suggestion, drag a date or apply an AI suggestion (see the sections above), and says what it wrote. The only things it keeps are which pages you chose to have on the line (Choose…) and your row colors, both kept with the wiki; and, in MojoPad itself on this Mac, your Group by and the side panel's width. The Timeline follows your theme, and holds still if you have turned on Reduce Motion.