Skip to content

Reports

Reports are long-form documents you write inside FASTR - a quarterly review, a country brief, an analytical narrative. You write the text in markdown and drop in live visualizations, so the charts in the document stay tied to your data instead of being pasted-in pictures that go stale. When the report is ready, export it as a PDF, a Word document, or an HTML file.

A report is the right tool when you need prose around your numbers. If you mainly want charts on a page, a dashboard fits better; if you’re presenting to a room, a slide deck does. Reports are for the written word.

Open the Products tab on your instance home screen. Reports appear as cards in the product explorer alongside slide decks and visualizations. Click New and choose New report to create one — a dialog opens where you name the report, choose its folder, results package, and scope before the editor opens. You can organise reports into folders using New folder, and move them between folders from their card menu.

To create reports, at least one results package and one scope must exist at the instance level.

When you leave a report you created in the same session while it is still completely empty, FASTR asks whether you want to keep it or delete it.

The editor uses FASTR Markdown, so you write plain text and format it with simple marks - # for headings, - for bullet lists, 1. for numbered lists, and pipes for tables. Bold, italic, and inline code work the way they do anywhere else. FASTR Markdown also supports ::: blocks for callouts, stat tiles, bands, cover pages, and other structured content — the Widgets menu lists them all.

Your work saves on its own as you type. A status indicator in the header shows where things stand - Saving while a change is in flight, Saved with the time of the last save once it lands, and a clear error state if a save ever fails so you know to check your connection rather than lose work.

When live collaboration is active, the save indicator changes: it shows Live with a green dot while edits are streaming to the server continuously, Offline — reconnecting… with a yellow dot if the connection drops, and Not saving — retrying… with a red dot if the server-side checkpoint is failing. In Live mode the REST autosave is replaced by the room’s continuous checkpoint, so the indicator no longer cycles through Saving/Saved.

FASTR Markdown reports open directly in Edit mode — the finished page layout is what you see as you type. The markdown editor and the rendered preview are one and the same: page boxes, live visualizations, and all block styling appear in place while you write, so there is no separate View or Split toggle for this format.

Older plain Markdown and HTML reports retain the Edit / Split / View toggle. Edit shows the markdown source. Split shows the editor and rendered preview side by side. View renders the report as it will read when finished.

Edit and View Modes

FASTR Markdown reports include a toolbar above the editor with two rows. The menu row contains File, Widgets, Figures, and Page menus. The toolbar row is a persistent row of formatting controls that adapts to the cursor’s context.

The File menu holds whole-document operations: download, email, rename, manage access, and duplicate. The Widgets menu lists every block type you can add — headings, callouts, stat tiles, tables, links, logos, cover pages, and more. The Figures menu lets you insert a visualization or an image. The Page menu controls the document’s theme, background, orientation, and numbered sections.

The toolbar row shows text controls (heading style, bold, italic, underline, text size, highlight, link, text colour, and list types) whenever the cursor is on a regular text line and no embed is selected. When the cursor sits on a block’s own fence line or on a figure or image line, the text controls are hidden and only the block’s own controls appear. When the cursor is inside a ::: block on a text line, the block’s name and its own controls appear appended to the right of the text controls. When a visualization or image is selected, the embed’s controls replace the text controls entirely.

Reports hold two kinds of visual content, and the difference matters. A visualization is a live chart or map from the product’s results package - it renders from current data and updates when that data changes. An image is a static file you upload, such as a diagram or a photo.

To add a visualization, open the Figures menu and choose Visualization…. A menu lets you choose between inserting a New visualization… (the metric and preset wizard) or an Existing visualization… (a copy of a saved visualization product). To add a picture, choose Image… and upload a file or choose one from your project’s assets. Either way, the item appears in the document as a card you can select.

Selecting a visualization or image reveals controls in the toolbar for working with it:

  • Edit visualization opens the visualization’s settings - adjust the period, disaggregation, or styling
  • Switch replaces the visualization with a different one, again offering new or existing
  • Size (FASTR Markdown only, when the embed is on its own line) sets how wide the figure is on the page: Small, Medium, Full width (the column, which is the default), or Edge to edge (the full sheet width)
  • Delete removes the visualization or image from the report

Because visualizations stay linked to the results package, a report you wrote last quarter shows this quarter’s numbers the next time you open it - no manual updating, no re-pasting charts.

If a visualization or image cannot be loaded when you export the report, FASTR replaces it with a short notice in place of the missing item rather than aborting the export. The rest of the report exports normally.

Adding Figures and Images

Every visualization in a report takes its numbers from the results package and scope the report is set to use. The package and scope are shown at the top of the report. If you can edit the report, click there to change either one. Visualizations made before the change are then out of date, and an Update all visualizations button appears so you can refresh them together.

FASTR Markdown reports support a Logos block that renders a row of logos — your organization’s, partners’, or FASTR’s. Insert one from the Widgets menu. Clicking an empty logos row, or double-clicking one that already has logos, opens the logo picker where you choose which logos appear and in what order. The picker shows FASTR’s built-in logos and all image files you have uploaded to the instance. Upload a new logo directly from the picker using Upload logo. Drag items in the chosen list to reorder them.

When a logos block is selected, the toolbar shows alignment and size controls for the row.

When editing a FASTR Markdown report, a document outline sidebar appears on the left side of the editor. The outline lists every heading in the report, indented by level, and highlights the section you are currently reading. Click any heading in the outline to jump the editor to that line. To collapse the outline, click the chevron button in its header; a small Report tabs button on the left edge of the editor re-opens it.

Click Settings in the report header to open the report settings panel. Here you can change the report’s name and move it to a different folder. To change the results package or geographic scope, click Results package and scope… from the report’s card menu. Changing the package or scope affects every visualization in the report — visualizations that came from a different package or scope show an update badge.

Open the File menu and choose Manage access… to control who can view and edit the report. This opens the product access panel where you can set per-user permission levels.

FASTR Markdown reports have a design theme that controls fonts, colours, and the look of every block. Open the Page menu and choose Theme to switch between built-in themes or apply a saved custom style. A custom style contributes its colour palette to a FASTR Markdown report. You can re-theme a report at any time without touching the body text.

The theme picker also shows any custom styles saved by your instance’s administrators. Saved styles appear alongside the built-in themes in the picker.

When you open a report as a viewer (without edit permission), the editor loads in read-only mode. For FASTR Markdown reports, the toolbar shows only the File menu with download, email, and other non-editing options. The text formatting controls and widget menus are hidden.

When multiple people have the same report open, you can see where colleagues are working. Live cursors appear in the editor pane, so you know at a glance whether someone else is editing the section you are about to change. A small presence avatar also appears on the report card in the list view. Collaborators who are currently viewing the same report appear as avatar icons in the header.

The editor is collaborative: remote collaborators’ text selections are highlighted in their color, and hovering over a highlighted selection shows the person’s name. When the AI assistant proposes a text edit that you accept, the change is rebased over any concurrent edits your colleagues made while the proposal was open - if a hunk could not be applied cleanly, the assistant lets you know which lines were skipped.

When a collaborator has a visualization selected, a colored presence border appears around that visualization in the editor, with their name shown above it. If they have the visualization editor open, the border is labeled with an edit indicator so others know the visualization configuration is being actively changed.

Click History in the report header to open the version history panel. Versions are saved automatically at the end of each editing session and grouped by day on the left side. Select any version to see a diff of what that session changed - added text is highlighted in the editor’s color, removed text is shown struck through, and hovering over a change shows who made it.

From the version preview you can also switch to a Preview view that renders the full report snapshot as it looked at that point. Use Restore to reset the report to that version (your current content is saved as a new version first, so nothing is lost), or Restore as copy to create a brand-new report from the snapshot while leaving the current one untouched.

If the report has unsaved live edits that cannot be saved at the moment you request a restore, FASTR will let you know and ask you to retry once saving has recovered.

The AI button opens an assistant that can help as you write. It can rewrite a passage you’ve selected, insert or replace visualizations, and edit existing visualizations in place - for example, changing the replicant a chart displays, adjusting its filters, or updating captions. The assistant proposes text changes for you to accept or reject in a modal before anything is applied; visualization edits are applied immediately to the live preview and saved.

When you open a new report that has not yet had any content added, the assistant works through a brief, sections, plan, and draft sequence before writing the full document. It first asks questions using interactive prompts, reviews the data, agrees a section structure with you, then proposes a detailed plan for your approval. If you prefer to skip straight to a draft, just say so.

When you ask the assistant to write a full report, it writes the body once and then checks it automatically — laying out the pages and reviewing any new figures against the data. If the pages have problems or the figures need checking, the draft is held rather than proposed immediately. The assistant then asks you to fix specific passages using small, targeted edits. Once the draft passes its checks, it is proposed to you for acceptance or rejection in the usual diff view.

See AI assistant for the full picture.

The report toolbar includes Undo and Redo buttons that reverse your own body-text changes without affecting your colleagues’ edits. These buttons appear only when you have permission to edit the report. They operate the same history as the keyboard shortcuts Ctrl+Z and Ctrl+Shift+Z inside the editor.

Press Ctrl+F (or Cmd+F on Mac) while the editor is focused to open the find-and-replace panel over the source text. Unlike the browser’s own Ctrl+F, this panel reaches text inside collapsed blocks that are not visible in the rendered preview.

Click Email from the File menu to send the report as an email attachment. Enter one or more recipient addresses and an optional message. FASTR attaches the report as a PDF and sends it on your behalf.

Click Download to open the export options. FASTR Markdown reports offer PDF (paginated exactly as the editor shows), Word (.docx), and HTML file. The PDF has exactly the pages the editor shows. The Word file keeps headings, text, tables and visualizations editable; covers, bands and tiles are pictures with their text in editable boxes on top. The HTML file is self-contained with visualizations embedded as images and reads as one continuous page.

Live visualizations are rendered into the document at export time.

Exporting Reports

A visualization shows nothing or looks wrong: The visualization behind it has no data for the current window, or its configuration needs a change. Select the visualization and use Edit visualization - see Visualizations.

The status says “Save failed”: A save didn’t reach the server, usually a connection issue. Stay on the page, check your connection, and keep editing - FASTR retries; don’t close the tab until you see Saved.

The exported file doesn’t match what I see: Export renders the current saved version. Make sure the header shows Saved, then download again.

Restore says saving must recover first: If the report has live edits that are currently failing to save, the safety version cannot be created until saving resumes. Wait for the Not saving indicator to clear, then retry the restore.