Scenario Narratives
Each scenario can have a narrative — a written description of that planning alternative. Narratives appear alongside the scenario in reports, shared links, and stakeholder presentations. You can write them manually, or use the built-in AI assistant to generate and refine the text.
Opening the narrative editor
- Open the Scenarios panel (left toolbar).
- Click the scenario you want to add a narrative to.
- Click the Narrative button to open the narrative detail panel.
The panel shows a rich text editor on the left and an AI assistant drawer on the right. If the drawer is collapsed, click the sparkle icon to expand it.
Writing manually
The editor supports standard rich text formatting: headings, bold, italic, bullet lists, and numbered lists. Write directly in the editor at any time — changes are saved automatically.
Generating a narrative with AI
The Generate tab in the AI drawer creates a full narrative from scratch based on the current scenario's layer data and your configuration choices.
Generate options
| Option | Choices | Notes |
|---|---|---|
| Tone | Professional, Accessible / Public, Technical, Persuasive | Controls the register and vocabulary of the output |
| Audience | City planners, Elected officials, General public, Technical engineers, Investors & stakeholders | Adjusts what background knowledge is assumed |
| Length | Short (1–2 paragraphs), Medium (2–3 paragraphs), Long (3–5 paragraphs) | Long is the default |
| Language | English, Norwegian (Bokmål), Nynorsk, Swedish, Danish, Finnish, German, French, Spanish | The narrative is written entirely in the chosen language |
| Focus areas | Environmental impact, Traffic & mobility, Visual integration, Regulatory context, Shadow & light, Green space, Building density, Economic impact, Accessibility, Community impact | Toggle one or more tags to direct the AI's attention to specific topics; leave all off to let the AI decide |
| Custom guidance | Free text, up to 300 characters | Optional extra direction, for example: "Emphasise the shadow impact on the park" or "Avoid technical jargon" |
When you are happy with your settings, click Generate. The AI streams the result directly into the editor. You can stop the stream at any time and edit the partial result.
The AI has access to the layers loaded in the current scenario — their names, attributes, and data. The more descriptively your layers are named, the more accurate and specific the generated text will be.
Generating a narrative replaces the existing content in the editor. If you want to keep the current text, copy it before clicking Generate.
Refining an existing narrative
The Refine tab becomes available once the editor contains text. It lets you iteratively improve the narrative without starting over.
Full-narrative refinement
Type an instruction describing what should change — for example:
- "Make the introduction shorter"
- "Add more detail about the traffic impact on the main road"
- "Rewrite in a more optimistic tone"
Click Refine and the AI rewrites the entire narrative, incorporating your feedback while keeping the existing style and structure.
Selection rewrite
To change only a specific part of the narrative:
- Select the text you want to rewrite in the editor.
- Switch to the Refine tab (it will show that selected text is active).
- Type an instruction for how that passage should change.
- Click Rewrite selection.
Only the selected portion is replaced. The rest of the narrative is untouched.
Selection rewrite uses a faster AI model, so the response is usually near-instant for short passages. Use it to polish individual sentences or swap out a paragraph without affecting the rest of the text.
How narratives appear in shared links
When a scenario is shared via a public link, its narrative is displayed to viewers as context for the plan. This makes narratives a key part of public engagement — write them for the audience who will be viewing the shared link, not just internal team members.
See Public Engagement for more on sharing scenarios with the public.
Narratives and scenario snapshots
Narrative text is saved as part of the scenario — it is stored separately from the map snapshot but tied to the same scenario record. Switching scenarios loads the narrative for that scenario. Deleting a scenario also deletes its narrative.
See Scenario Snapshots for a full list of what each scenario stores.