Newsletters

Understand the basics

Newsletters may be sent out to inform participants of the latest news on the platform: launch of a new consultation, warning before a closing date for votes, announcement of a result, monitoring of projects in progress, etc. The newsletter is sent to any user of the site who has ticked the "Receive an occasional newsletter with relevant information" box when they created their account, or later in their account settings.

Contact permission in participant registration
Contact permission in participant account

Some examples of when you can and should sent a newsletter are:

  • When a new process could be interesting for all the citizens in a city, for instance a Participatory Budgeting process.

  • When there are the results published for a given process.

  • When an assembly has a important topic to discuss.

  • When there’s a new voting planned.

  • When there’s a new conference published.

  • Etc.

Configuration

To access the Newsletters panel, go in the administration panel and click the "Newsletters" item in the administration navigation bar.

Newsletter administrator menu

There, you see the list of newsletters already sent from this instance. If it’s a new instance, you shouldn’t see any newsletter in the list.

Newsletter list

Create a newsletter

To start creating a newsletter, click the "New newsletter" button at the top right of the page.

Select a template

First, you are asked to select a newsletter template, depending on what you want to send. Two templates are displayed, with a preview for each one to help you decide on the best format for the content you want to communicate.

  • Basic (only text): recommended for short updates

  • Image, text and Call To Action button: recommended for more elaborated contents

Newsletter new templates selection

Click the "Use this template" button below the template you want to use.

Write the newsletter

Depending in which template you’ve chosen, you have to fill a form with different fields.

You can use "%{name}" anywhere in the body or subject to be automatically replaced by the participant’s name.
Newsletter new template basic form
Table 1. New Newsletter "basic (only text)" form
Field Type Description

Subject

Required

Subject of the email.

Body

Optional

Body of the email.

Newsletter new template Image
Table 2. New Newsletter "Image, text and Call To Action button" form
Field Type Description

Subject

Required

Subject of the email.

Introduction

Optional

Introduction of the email, displayed before the CTA button.

Call To Action button text

Optional

The CTA button text.

Call To Action button URL

Optional

Where the CTA link redirects.

Body

Optional

Body of the email, displayed after the CTA button.

Main image

Optional

Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Allowed file extensions: JPG JPEG PNG WEBP

Once you wrote the newsletter, click the "Save and preview" button.

Preview the newsletter

The preview page allows you to review the look and content of the newsletter before sending it. Until you send the newsletter, you can edit it and review its preview anytime you want.

Newsletter new template basic form preview

Send a test email

If you want to review the newsletter directly in your mailbox, click the "Send me a test email" button at the top right of the page. You receive the newsletter directly at the email address registered for your participant account.

Select recipients to deliver

If you want to only communicate about a given space or neighborhood, you can choose the which participants you’re sending the newsletter to. To do so, click the "Select recipients to deliver" button.

If you don’t want to send your newsletter to a specific segment, select "Send to all users"

There, you can choose between sending the newsletter to:

  • All confirmed users

  • All confirmed users that have participated in any of the selected participatory spaces in the list

  • All confirmed users that have followed any of the selected participatory spaces in the list

  • All the participants that have selected an scope in their "My interests" settings in their account.

Even if a participant has a confirmed account and is following a space, the system don’t send them a newsletter email if they haven’t accepted it in their notifications settings.
Newsletter select recipients

If you select the "Sent do participants" or "Send to followers" of a given space, then you can choose which spaces are relevant.

Newsletter select recipients spaces

Deliver the newsletter

Finally if you click in the "Deliver newsletter" button, the newsletter is sent to all the selected recipients. Before sending it, a pop-up appears to make sure you reviewed everything and are ready to send it.

Newsletter deliver modal
Once a newsletter is sent it can’t be undone nor edited. If you have multiple languages active, be careful with reviewing all the languages well before sending.

Manage newsletters

You can find all the newsletters on the newsletter page, with:

  • Subject: subject of the newsletter, redirects to the newsletter preview.

  • Created at: date of the newsletter creation.

  • Sent at: date of the newsletter sending.

  • Sent to: the segment the newsletter was sent to.

  • Progress: the number of participants to whom the newsletter was sent, upon the total number of recipients.

Actions

Icon Name Definition Condition

Edit newsletter

Edit

To edit the newsletter.

Newsletter not sent.

Send test email

Send a test email

To send a test email to the administrator email address.

Always.

Preview newsletter

Preview

To preview the newsletter

Always.

Delete

Delete

To delete the newsletter.

Newsletter not sent.