Blog :: Decidim Docs

Understand the basics

The Blog component allows administrators to post news about a participatory space, that participants can read to get updates.

All blog posts are available in the posts list, and participants can click each blog post to learn more about what’s new.

Configuration

To create a Blog component, first go in the participatory space where you want to create it.

Then:

Click on the "Components" item in the secondary menu
Click the "Add component" button
Select "Blog"
Fill the component creation form

You can still update this form and the configuration after creating the component, by clicking the Configure icon icon in the components list.

Table 1. Add component: Blog form
Field	Type	Description
Name	Required	The title of this component. For instance, "Blogs" or "Latest news"
Order position	Optional	Which order it has in relation to the other components. Having a lower number means a higher priority.

Table 2. Blog form - Global settings
Field	Type	Description
Announcement	Optional	A general announcement visible on the Blog component landing page.
Comments enabled	Optional	Whether you want participants to be able to comment on the blog posts.
Comments max length	Optional	The characters limit that participants have when making comments. Leave 0 for default value.

Table 3. Step settings
Field	Type	Description
Announcement	Optional	A general announcement that’ll be visible on the general blog landing page.
Comments blocked	Optional	Whether you want to enable comments creation for this phase.
Endorsements enabled	Optional	Whether you want to enable endorsements for this phase.
Endorsements blocked	Optional	Whether you want to enable adding new endorsements for this phase.

Manage posts

To start creating and managing posts, click in the component title in the navigation bar or in the component list, or click in the Manage component icon icon on the components list.

Manage posts table

Create a post

To create a post, click the "New post" button on the top right of the page.

New post form

Table 4. New post form
Field	Type	Description
Author	Required	Participant account or user group authoring the post.
Title	Required	What is the title of this post.
Body	Required	What is the description of this post.
Publish time	Optional	Publication date for the post. If in the future, the post is not published until this date.

Actions

Table 5. Actions
Icon	Name	Definition
	Edit	To edit this post.
	Folder	For classifying attachments.
	Attachments	To add documents related to the post.
	Preview	To see how it’s shown in the frontend to participants.
	Permissions	To handle the authorizations needed to comment or endorse this specific blog post.
	Delete	To delete this post.

Examples

Below, you can find some links to examples blog components: