Bookmarks#

If you want to save a specific view of the app for later, for example an interesting map or table, you can just copy the URL from your browser and paste it somewhere or send to a colleague.

In this section you can learn about the powerful bookmarking and slide decks features.

Requires Pro subscription

From anywhere in the app, find the yellow badge at top right of the screen. Click it! This adds a bookmark to the Bookmarks table.

If there is already a bookmark for this same view, a tick is shown: when a view matches an existing bookmark, show the tick.

When you save a bookmark in the session,

• a small modal, near the badge, opens with a textArea for the Description and Cancel/Save buttons. It is a good idea to provide a description, though it is not required.
• the bookmark is then saved including:
• the screenshot of the currently visible map or table (using the existing handlers for these).
• the current map legend, same as with #copy-legend-btn
• as soon as the screenshot is saved, we open a new small dropdown, headed by the bookmark number, right next to the navbar bookmark badge. This stays open for a few seconds then silently closes but can be opened again on click. This dropdown remains the same, with the same header number, until the next bookmark is recorded. The dropdown has buttons to directly copy to clipboard
• the formatted URL same as #copy-project-link-formatted
• the unformatted URL,
• the screenshot image
• the legend

... and when creating a bookmark on any table tab, when map panel is not showing, remember to also save the screenshot same as for pivot tab #pivot-copy-btn, for links tab #export-links-png-btn , for factors tab #export-factors-png,

The bookmarks table itself is gated (not shown) for users below Pro level, i.e. to users only on Free or Private plans.

The Bookmarks Table#

• Each row is one bookmark.
• Click the checkbox to select rows.
• Click Load to recall that bookmark, restoring tabs and outputs.
• Click Copy Formatted Link to copy the bookmark's URL to the clipboard.
• Double-click on the Description field to edit it.
• Click Delete to remove the bookmark.
• Click the badge at top right when viewing a map or table to add a new bookmark to it.
• When a new current project is loaded from a URL or by changing the project dropdown, the "Project" filter in the table is pre-filled with the name of the current project.

Main Features:

• Bookmark badge - Save/remove current URL state from navbar
• Bookmarks table - Manage saved views with sorting and filtering
• Bulk operations - Select multiple bookmarks for deletion
• Editable descriptions - Double-click to edit bookmark names
• Auto-normalization - URLs cleaned and standardized for consistency

Bookmarks Table:

• Actions - Load URL, Copy link (plain), Copy formatted link (HTML), Edit URL, Delete individual bookmarks
• Copy buttons - Both create short ?bookmark=ID URLs instead of full parameter strings
• Columns - Project, Description (editable), User, URL, Created, ID
• Bulk delete - Select multiple with checkboxes, delete with "Bulk:" trash button
• Badge integration - Shows bookmark ID when current view is bookmarked

URL Editor:

Click the Edit button next to any bookmark to open the URL Editor, which provides a user-friendly interface to understand complex bookmark parameters. Instead of viewing raw query strings, you see a structured breakdown with proper labels and grouping - showing your selected project, sources, active filters (displayed as individual cards), table settings, and map configurations. The editor categorizes parameters into logical groups (Navigation, Data Selection, Filters & Processing, etc.) and displays filter pipeline details with sequential numbering and status indicators. This makes it easy to understand exactly what state each bookmark preserves without needing technical knowledge of URL parameters.

When a bookmark of a map is saved, the legend text for that map is also saved as part of the slide_content JSON and is printed small at the bottom-right of the slide in Slideshow view.

Slide Decks#

Coming soon!

Each project can have one or more decks: collections of bookmarks. Each deck has the same permissions as the project. Each slide is json specifying:

• order (an integer)
• layout (for now just provide two layouts but make it extensible)
• usually a bookmark ID, but may be blank

For now, layouts and themes are hardcoded css snippets. Layouts only deal with position and dimensions, themes only with colours and fonts. Themes and layouts both use the same basic slots or set of components: h1, h2, h3, text1, text2, text3, text4.

in the slide template, remove the subtitle text area. we won't use it any more. Instead, put the Description.

Available layouts:

• Initial slide
• Section slide
• Header and two columns
• Large image on right (2/3 width) and narrower header and text box on the left
• Small image on right (1/3 width) and wider header and text box on the left
• Maximum width/height image and all other components float in front with 90% opacity

In these layouts, the image size is maximised. Text boxes have fixed maximum width and height, and the font size increases virtually up to a sensible maximum to fill the boxes.

The UI is just the existing bookmarks table exposing additional columns for Deck, theme, layout and order and a new action button to open the slide. The slide editor contains the same editable fields plus text fields / textareas for the slots and for bookmark1 (which may be empty), bookmark 2. Plus a toggle to show/hide the bookmark image. Plus a preview of how the slide will look when layout and theme are applied to the components.

A dropdown in the UI lists all decks in the current project plus None. Selecting a deck filters the table to show only bookmarks/slides in that deck. In this mode:

• Newly created bookmarks are added to the selected deck with incremental position (at the end).
• A large sortable Slide Sorter modal lets you reorder slides by dragging (flexbox with 4 slides per row). Each slide has a small vertical widget to duplicate the slide and insert another bookmark/slide ahead of it.

In fullscreen preview mode, small Prev and Next buttons float at mid-left and mid-right, and an Edit button opens the editor for the corresponding slide.

URL state includes a "filter by deck" dropdown. It uses the standard editable selectize to allow creating a new (sanitized, unique) deck name. Bulk actions include "Add selected bookmarks to Current Deck" so you can populate a new deck from existing bookmarks or add new bookmarks directly when a deck is selected. The dropdown lists all decks in the current project plus any newly added names.

Slide previews are slightly debounced while editing text fields in the slide editor.

If the text in any text box (main, sub, text1, text2) exceeds one line, the font size is gradually reduced so a paragraph or two can still fit.

Slides display a very small link to the bookmark (e.g., ?bookmark=nn) at the bottom-left.

When creating new bookmarks while a slide deck is selected, the new slide uses the same theme and layout as the last slide in that deck.

In the Initial Slide layout, text is placed on a semi-transparent overlay for readability with large image backgrounds.

Styles with dark backgrounds use light fonts. In the "maximum image with overlay text" layout, the overlay uses a dark background, and the Initial Slide overlay also uses a dark background for contrast.

Slide 1 discreetly prints the Causal Map filename, the project's last modified date, and today's date near the bottom.