Skip to main content
Prime DirectionBundle

Bookmarks

Wire gives every reader a private reading list. They save a post with the bookmark button, review the list in the header popover, and open the full list at /bookmarks/. Nothing is stored on your site: the list lives in the reader's own browser, so it works without a membership and without signing in.

Setup Instructions#

Bookmarks are on by default. The only requirement is the routes.yaml file that ships with the theme, which creates the /bookmarks/ URL. If you have not uploaded it yet, follow the Getting Started guide, otherwise the page returns a 404.

To link the page from your menu:

  1. Navigate to ⛭ Settings → Navigation
  2. Add a new item with the label Bookmarks and the URL /bookmarks/
  3. Click Save

How Readers Use It#

WhereWhat they can do
Post cardsThe bookmark icon in the card's action row saves or removes the post
Post pageThe bookmark icon next to the share button does the same
Header popoverReview the saved list, open a post, or remove a single entry
/bookmarks/The full list as cards, with the time each post was saved

The bookmark icon in the header carries a counter, so readers can see how many posts are waiting. When the list is empty, the popover explains that bookmarks are kept on the device and offers a link to browse stories. The same happens on /bookmarks/, which shows No bookmarks yet and a Browse stories button.

Each saved card shows the post title, its feature image, a relative timestamp such as Saved 2 days ago, and the reading time. Saving the same post from two different places keeps one entry, and removing it anywhere updates the header counter and both lists at once.

Where the List Is Stored#

The reading list is stored in the reader's browser under the local storage key wire-bookmarks. It never reaches your Ghost site, so you cannot see, export, or restore it.

What that means in practice:

  • No account needed. Bookmarks work for anonymous visitors, free members, and paid members alike.
  • Per device and per browser. A list saved on a phone does not appear on a laptop, and Chrome does not see what Safari saved.
  • Cleared with site data. Clearing browsing data, using a private window, or a browser that discards storage on exit removes the list.
  • Not synced and not backed up. There is no server-side copy to fall back on.

If your readers need a list that follows them between devices, that is a job for a membership feature, not for bookmarks.

Notes#

  • The saved entry keeps a copy of the title, image, and reading time from the moment it was saved. Renaming a post later does not rename the saved entry until the reader saves it again.
  • Unpublishing or deleting a post does not remove it from anyone's list. The entry stays until the reader removes it, and the link stops working.
  • Project cards do not carry a bookmark button. Bookmarking is offered on post cards and on the post page itself, next to the share button. See Post features.
  • To rename the Bookmarks heading or the empty-state text, edit the matching strings in the theme's translation file, as described in Section Headings.