---
title: "Using the working agreement editor"
description: "The working agreement editor in Talkspirit supports headings, lists, tables, callouts, emoji shortcuts, and inline mentions for rich content creation."
category: structure-governance
section: policies-and-publications
type: Tutorial
lastUpdated: 2026-08-04
locale: en
canonical: https://support.talkspirit.com/en/structure-governance/how-to-use-publications-editor-tool
---

# Using the working agreement editor


The **Structure** app in Talkspirit provides a rich editor for writing working agreements and the other documents that carry your governance content, such as procedures, policies and technical docs. The editor supports structured content blocks, text formatting, inline mentions, and emoji shortcuts, giving you all the tools needed to write clear, well-organised documents.

You will find these documents in the **Structure** app, under **Working agreements**. The names of the document types are configurable, so your organisation may use a different term than **working agreements**.

## How do I add content blocks?

Click the **+** button at the start of a line to access block-level elements. Typing **/** in an empty line opens the same menu without leaving the keyboard:

- **Headings** (used to generate a table of contents automatically)
- **Lists** (bullet point, ordered, and task list)
- **Coloured callouts**
- **Tables**
- **Code blocks**
- **Images**
- **Quotes**

![The working agreement editor with the cursor on an empty line and the + block menu open, listing Heading 1, Heading 2 and Heading 3 under Headings, then Quote, Toggle List and Numbered List under Basic blocks](/images/structure-governance/how-to-use-publications-editor-tool/01-block-menu.png)

**Note:** Using Headings generates a table of contents for your document automatically. Apply headings consistently to titles and subtitles for this to work.

![A working agreement containing three headings, with its table-of-contents panel open at the top of the page listing each heading as a jump link](/images/structure-governance/how-to-use-publications-editor-tool/02-table-of-contents.png)

## How do I format text?

Highlight any content to access inline formatting options:

- **Bold** or **italic** (or both)
- Strikethrough or underline
- Text colour and highlighting
- Coloured callout
- **Bullet point**, **ordered**, or **task list**

![The working agreement editor in edit mode, with the floating formatting toolbar open above a line of text: a block-type dropdown, a Callout dropdown, bold, italic, underline and strikethrough, alignment, text colour, list indent controls, a link button and an AI menu](/images/structure-governance/how-to-use-publications-editor-tool/03-formatting-toolbar.png)

## How do I use shortcuts and mentions?

The editor supports the following shortcuts:

- Type **:** to open the emoji picker and insert an emoji
- Type **@** followed by the name of a member, role, or circle to mention them. You can also mention a project, goal, task, metric, or checklist. The results are grouped by type, so scroll the list to move from members to roles, circles and the other types. Members are not notified when they are mentioned in the document body, but mentions in comments on the document do send a notification.

![The working agreement editor in edit mode just after typing the @ character, with the mention dropdown open under the cursor listing organisation members in a Users group, each with an initials avatar and email address](/images/structure-governance/how-to-use-publications-editor-tool/04-mention-dropdown.png)

## What's Next?

- [Publications Collaborative Edition](/structure-governance/publications-collaborative-edition)
- [How do I edit or delete a publication?](/structure-governance/how-to-edit-or-delete-a-publication)
- [How do I manage publication types?](/structure-governance/manage-publications-types)
- [How do I mention roles in Talkspirit?](/structure-governance/how-to-mention-roles)