All docs

Cross-survey dashboards

Chart one mapped question across several surveys, share a read-only link and send scheduled PDF or CSV reports.

Updated . 3 min read.

A dashboard can chart one question concept across every survey it is mapped on, for example likelihood to recommend across your onboarding, support and renewal surveys. Open Surveys, Dashboards.

Add a cross-survey widget

  1. Create a dashboard or open an existing one and add a widget.
  2. Choose Mapped question across surveys as the metric and pick the question.
  3. Tick the surveys to include, or leave all ticked. Pick the period size and any filters.

Each widget shows the sample size per survey and per period, and a survey measured on a different scale appears as its own segment, never pooled. Every chart has a data table next to it for readers who do not use the chart.

You only see surveys you may open. A dashboard that draws on a survey you cannot open does not show it, and cannot be shared or scheduled by you.

Share a read-only link

Under Share links, press Create link, choose a label and when it expires, and copy the link. It is shown once; only a fingerprint of it is stored.

  • The page shows the aggregate figures of the dashboard. It never shows an individual response or a free-text answer.
  • Revoke stops the link at once. A revoked, expired or unknown link answers the same way and returns nothing, neither the page nor the data.
  • Changing which surveys a dashboard covers revokes its links, so a link never shows more than the person who made it saw. Renaming does not.
  • Search engines are told not to index shared pages.

Scheduled reports

Under Scheduled reports, name a report, choose PDF or CSV, daily, weekly (Monday) or monthly (the first), the language of the email, and the workspace members who receive it.

Each run first captures a snapshot: the data, the filters, the denominators and the response window, stored with a checksum. The PDF or CSV is produced from the snapshot only, so a file always matches its snapshot, whatever responses arrive afterwards. A snapshot that no longer matches its checksum is refused.

Access is checked each time a report goes out. A recipient who has left the workspace or can no longer open the surveys is skipped, and the reason is kept on the report. Pause and Resume control the schedule.

Capture snapshot now stores a snapshot without emailing anyone. Download any snapshot as PDF or CSV from the list.

API and agents

With surveys:read and surveys:write:

  • GET /survey-dashboards lists dashboards, GET /survey-dashboards/{id}/sharing shows links, reports and snapshots.
  • POST .../shares creates a link (the response carries the URL once), POST .../shares/{id}/revoke revokes it.
  • POST .../reports and PATCH .../reports/{id} manage scheduled reports, POST .../snapshots captures one, GET .../snapshots/{id}/csv or pdf downloads it.
  • Agent tools: get_survey_dashboard_sharing, create_survey_dashboard_share, revoke_survey_dashboard_share, create_survey_dashboard_report, update_survey_dashboard_report, capture_survey_dashboard_snapshot, get_survey_dashboard_snapshot.

Next