Skip to main content

Participatory texts

General information​

Overview​

This feature allows you to navigate the proposals as text. It’s useful for discussing normatives, plans, or other kinds of texts.

Every paragraph is split into a proposal, so it’s possible to discuss it in a more granular way.

Examples​

Some examples of where this feature was used are:

  • Vision Greenpeace in Greenpeace France Concertation
  • Procés participatiu del Programa d’Actuació Municipal (PAM) 2020-2023 in Decidim Barcelona

Options​

Manage participatory texts​

To configure the "Participatory texts" in proposals component:

  1. Sign in as admin
  2. Go to admin panel
  3. In the main sidebar, click in the button for the space that you want to configure the component for. For instance, it could be "Processes", "Assemblies", or "Conferences"
  4. Go to components
  5. Click on "Add component" button
  6. Click on "Proposals"
  7. Check the "Participatory texts enabled" setting
  8. Save the component
  9. Click in the "Participatory texts" button in the empty proposals component
  1. Click in the "Import document" button in the empty Preview participatory text panel
  1. Fill the Add document form
  1. Preview the document and make corrections
  1. Click on publish the document
  1. Publish the proposal component

Notice that this feature could break existing proposals, so if there is any proposal it will not work. You’ll see the following message in the components settings:

ℹ️ Cannot interact with this setting if there are existing proposals. Please, create a new Proposals component if you want to enable this feature or discard all imported proposals in the Participatory Texts menu if you want to disable it.

Add document form​

Although it’s possible to work with both Markdown (.MD) and ODT (.ODT) files, we recommend working with Markdown as it’s easier to see the formatting.

Download the example participatory text.

FieldTypeDescription
TitleRequiredWhat’s the title of the document?
DescriptionOptionalDescription for the document
DocumentRequiredFile. Add a document lesser than 2MB, each section until 3 levels deep will be parsed into proposals. Supported formats are: Markdown, ODT

Preview the document

After the document is initially imported you have three options:

  • Discard
  • Save draft
  • Publish document

Participant experience

Once the document is imported and the proposals component published, you’ll be able to navigate the document:

Based on Decidim Docs under Creative Commons BY SA 4.0