# Write up a report

Mapstack writes up what your data shows as a dated report: the finding first, then maps, tables, charts and the method, to share or download as Word or PDF.

Video: Write up a report (1 min 20 s): /images/docs/videos/reports.mp4

- **Who can use it:** Creator and Creator Max. A Viewer can read, download and ask about a report.
- **You provide:** Data or analysis in the conversation, and who the report is for
- **You get:** A written report, to share, publish or download as Word or PDF

A report is a written account of what your data shows, for people who decide from a paper. It leads with the finding, not the topic, sets out the key points, makes the case in sections with maps, tables and charts, and ends with the method and the sources, so the reasoning can be checked. Under the headline it says when the data is from, when you or the data give that date, and the day the report was made.

People use it for a paper for a committee or a board, evidence for a grant or a submission, a written answer to "which should we choose?" or "are we within the limit?", or a brief that is sent round. The asks on this page are examples of the kind of thing to say.

![A report asked for in plain words: the Liverpool bus stop report writes itself from the headline down to the table that shows stop counts do not rank access.](/images/docs/loops/report-committee.mp4)

## Write up your work, or a question

Tell Mapstack:

- **Who reads it and what it is for.** "For the council's transport committee" changes what is written.
- **What must be in it,** if anything: a map, a table, a section, an appendix, recommendations.
- **A title,** if you want exact words. It is used unchanged.

The data goes in the conversation, with any analysis the report should rest on done there first. **A report works out the figures it needs.** It counts, totals, averages, ranks and compares on its own. Anything that makes new data (walking catchments, joins by location, clusters) is worked out first in the conversation and kept as a dataset; the report then uses those results. Mapstack may make a combined dataset first to hold what the report needs.

**It asks when the answer would change the report.** If a missing fact, or two readings of your request, would change what the report says, Mapstack stops and offers options. It does not ask about wording: it decides and tells you.

On one job, Mapstack wrote a report for a council transport committee on walking access to bus stops in Liverpool's 64 wards. Its headline stated the finding ("Recorded bus stop access reaches 92.90%, but Allerton falls to 57.85%"), and it called out the five lowest wards, put a register of all 64 and the method in appendices, and gave the date of the data. It also made a point the request had not asked for: more stops did not mean better access, as one ward with 97 stops had lower access than one with 6.

You get a card in the conversation that opens the report, and an entry in your **Library**. With it, Mapstack lists the choices it made, any caveats, and anything you asked for that it could not include, with what was missing. Writing a report uses part of your allowance. See [Your allowance](/docs/workspace/your-month).

**Who it is for changes how it is written.** Ask for a paper for a committee, a submission for a regulator or a story for the public, and the same findings are written for that reader. A report for a funder can come with a note on sources and method, ready to paste into the application.

### Write up the work you have done

Say who will read it and what must be in it. Mapstack builds on the analysis already in the conversation, with the same figures.

> Write this up as a report for the council's transport committee: the stop counts and the 400 m walk access by ward, with the map, the five lowest wards called out, and the method in an appendix.

### Get an answer to a question, written up

The question decides the kind of report. "Which should we choose?" and "Are we within the limit?" end with a conclusion and recommendations; "What does this show?" ends with a conclusion when the findings add up to one.

> Which five wards should get new stops first? Give me a report I can take to the committee

## The outline: headline first, method last

Every report has the same outline, so a reader always knows where to look. The parts always come in the same order. The sections between them are Mapstack's to plan, from what you say the report is for, and yours to change.

| Part | What it is |
|---|---|
| Title, headline and opening paragraph | The headline states the finding, with a short paragraph under it |
| **Key points** | A numbered list, most important first, one sentence each: 1 to 6 |
| Background | The situation before the findings. Optional |
| Sections | The body, as many as the report needs. Appendices are sections too |
| Conclusion | The overall reading or answer. Always there when the report answers a choice or checks a limit |
| Recommendations | Numbered actions, each with its basis and an optional priority: 1 to 7. Always there when the report answers a choice or checks a limit |
| **About the data** | Method, coverage and limitations, then the sources, with the date of the data when it is known. Always last |

![Example: a committee report on bus stops and walking access in Liverpool. The top carries the headline finding, when the data is from and the key points; further down come a map section and About the data, with the method and sources.](/images/docs/reports/liverpool-committee-report.jpeg)

**Conclusions add reasoning, not figures.** The conclusion reasons from the findings; its figures come from the sections. Recommendations are never for something the findings do not support.

### Ask what to do: recommendations

Recommendations come with every report that answers a choice or checks a limit. For any other report, ask for them.

> Add recommendations: which five sites should we visit first, and why?

## Sections, tables, charts and maps

A section can hold text, tables, charts, headline figures and still maps; the full list is under Reference on this page. A figure, table, chart or map layer can show part of the data through one filter: a period, a category or a threshold. Still maps come in wide, standard, square and tall shapes, on a light basemap made for data unless you ask for another. About seven classes is the most a still map reads well with.

**A chart can carry your target.** A chart over time can show a limit or a target as a line across it, and dates can be grouped into quarters.

### Add a section, with a map that picks places out

Say what the section should cover, and any map, table or chart it should hold. A map in a report can show a few places picked out from the rest.

> Add a section on the three sites over the limit, with a map showing them as large red markers and the rest as small grey ones

### Add a table, a chart or a headline figure

Say what it should show. The values are always worked out from the report's data, never typed in.

> In the report, add a table of the ten wards with the most residents outside a 400 m walk

> Put total revenue and the number of outlets as headline figures at the start of the sales section

## Where every figure comes from

**Every number has a source.** Each figure in the text traces to a calculation on the report's data, to a table or chart in it, to the data's own details, or to your words. A written figure may be rounded, never given more precisely than its source. A report with a figure that has no source is not published.

**Interpretation is labelled.** Background knowledge and readings of the data sit in their own sentences, opened with one of six phrases: "From general knowledge", "As is widely known", "Outside this data", "In our reading", "One likely explanation is" or "is consistent with". They never appear in key points, tables, headings or the title.

**It says what was and was not checked.** In the committee report, the standfirst said the ward results were arithmetically verified but the routing and the dates of the source data were not.

**It reports association, not cause.** It does not forecast, or promise outcomes such as footfall or payback. When your question implies a kind of report the data cannot support (a comparison with last year, with no last year in the data), it says so and writes the kind the data does support.

**What cannot be included is listed.** If part of what you ask for is not possible with the data, Mapstack says what you asked, what was missing and what it offers instead. It never presents a different measure as the one you asked for.

### Check where a figure came from

Mapstack runs the report's own steps again on its copy of the data and shows you how the figure was reached, the way a colleague would show their working.

> Where does the 92.90% in the report come from?

## Change a report

Name the part and say what should change. A change gives you the same report updated, with a list of what changed; the Word and PDF files are made again. If the new content needs data the report does not hold, add a dataset.

**A report records a moment.** It takes a copy of its data when it is written and prints that day as "Made", so it still reads the same when the data has moved on. Later edits to the data do not change it; ask for a new report.

**When the data is from is a separate line.** "Data as of" under the headline and in the sources is the data's own date: a release, a last-updated date, a survey year or a period. Mapstack takes it from what you say or from the dataset's own release when it has one. When nothing gives a date, the report states none rather than guess, and you can add it.

### Take something out or reword it

Name the part. The title, the headline and any section can be changed. Everything you do not mention is kept.

> Remove the background section and shorten the headline

### Put the date of the data on it

Say when the data is from, in the words a reader should see. It goes under the headline and in the sources line, beside the day the report was made.

> The file is ComReg's Gigabit Statistics, last updated 29 September 2026. Put that as the data date, not today's date.

## Go back to an earlier version

**Every change is a version.** Each time a report is written or changed, it is saved as a new version with its maps, its PDF and its Word file, and **Version** at the top shows which one you are looking at. Going back brings an earlier version back as the newest one, so the version you left stays in the list.

1. Open the report.
2. Select **Version** at the top, pick the version you want, then **Restore**.

The report changes in place, and its PDF and Word file are that version's. A report card in the conversation also shows **Revert** when its version is no longer the current one. How many versions are kept is in [Sizes and limits](/docs/workspace/sizes-and-limits).

## Share, publish and download

**Share**, **Publish** and **Download** are at the top of the report.

| Download | What you get |
|---|---|
| **Word** | A .docx named after the report. Text uses Word's own styles (title, headings, lists, tables), so it can be edited or brought into your own template. Charts and maps are pictures |
| **PDF** | An A4 PDF of the report |
| **Print** | Your browser's print window |

## Reference

**What a section can hold**

| Content | Notes |
|---|---|
| Text, sub-headings, lists | Lists of up to 12 items |
| Boxed notes | Note, warning or good news |
| Scope facts | Pairs such as period, area, measure and unit |
| Headline figure | One large count, sum, average, median, minimum or maximum |
| Table | Up to 8 columns; 20 rows unless you ask, 100 at most |
| Chart | Bar, line, pie or donut, histogram, scatterplot, box plot or calendar heat chart |
| One record in detail | Its values, a comparison with the average, its place in the range |
| Still map | A picture of a map with a legend and caption, framing all the data or an area you give |

## What it can't do

- Refresh itself when the data changes. Ask for it to be written again.
- Forecast, or state that one thing caused another.
- Hold an interactive map. Its maps and charts are pictures; for one to explore, make a [map](/docs/make/maps).
- Be edited by hand. A report is changed by asking.
- Reorder the outline, put blocks side by side, or use tabs, collapsible sections or footnotes.
- Show more than 100 rows in a table.
- Include a picture that is not drawn from the data.
- Be made from a Free or Viewer seat.

## Common questions

**Where did a figure come from?**

Ask, for example "Where does the 92.90% in the report come from?". Mapstack runs the report's own steps again on its copy of the data and shows how the figure was reached.

**Can I type in my own figures?**

Not into tables, charts or headline figures: their values are always worked out from the report's data. A figure in the text can come from your own words.

**Why do some sentences start "In our reading"?**

It marks interpretation or background knowledge, kept apart from what the data shows. It is one of six such openings, and they never appear in key points, tables, headings or the title.

**Can I use our own report template?**

Download it as **Word**. The text uses Word's own styles for the title, headings, lists and tables, so you can bring it into your own document and edit it there.

**Does the report update when the data changes?**

No. A report takes a copy of its data when it is written, and prints that date. Ask for it to be written again.

## Related

- [Make a map](https://mapstack.io/docs/make/maps.md)
- [Make a map for paper, a slide or a post](https://mapstack.io/docs/make/prints.md)
- [Ask questions about your data](https://mapstack.io/docs/answers/ask-about-your-data.md)
- [Find what share of residents can walk to a bus stop, area by area](https://mapstack.io/docs/guides/walking-access-by-area.md)
- [Download and export](https://mapstack.io/docs/share/download-and-export.md)
- [Map how much of the population each fire station reaches in time, and what closing one would cost](https://mapstack.io/docs/guides/emergency-response-coverage.md)
- [Find the areas with no gigabit broadband, for a funding bid](https://mapstack.io/docs/guides/broadband-coverage-gaps.md)
- [Compare where your customers are with who lives there, and find the gaps](https://mapstack.io/docs/guides/customers-against-who-lives-there.md)
- [Put a plan online in a form residents can follow](https://mapstack.io/docs/guides/publish-a-plan-for-residents.md)
