Scopes

Scopes are the set of territories or subjects that an Organization has. A scope may have child scopes.

For instance, in the case of the city of Barcelona the scopes are its districts, and the children of a district are its neighborhoods. They can also have types, so it can be configured, for example, by thematic and also territorial scopes.

Most of the components and spaces in Decidim allow you to configure Scopes in one way or another. There are mainly three ways of using Scopes:

To configure Scope on the Decidim platform, go to menu:Settings[Scopes] in the admin sidebar menu. A list will appear with the existing scopes if there are any:

Scopes list

If you need so, you need to first configure the Scope type.

Form

New scope type form

Table 1. Admin New Scope Type form
Field Type Description

Singular

Required

Name of the scope type in singular.

Plural

Required

Name of the scope type in plural.

New scope form

Table 2. Admin New Scope Form
Field Type Description

Name

Required

Name of the scope.

Code

Required

(Internal) name of the scope.

Scope type

Required

Which type of scope it’s.

Actions

You have 3 possible actions in this list after a Scope is created:

Icon Name Definition

Browse icon

Browse

See and configure the children scopes for this Scope.

Edit icon

Edit

Edit form for a Scope. It’s the same form as "Create a new scope".

Delete icon

Delete

To delete this scope.

Features

The main features related with scopes are:

  1. Filtering

  2. User interests and Newsletters

Filtering

For filtering. Most of the spaces and components allows an administrator or a participant to associate them to a scope. This allows to filter by scopes when exploring them.

Initiatives scopes filtering

Processes scopes filtering

Some examples:

  • With Accountability module, so it’s possible to filter Results

  • Assemblies and Processes can have Scopes. It’s used for filtering multiple assemblies in the main listing page (/assemblies or /processes). These can be hidden by unchecking the "Enable participatory space filters" in the admin’s configuration page.

  • Filtering in the sidebar is possible in Budgets Projects, Initiatives and Proposals. In some of these components you can control if these filters are shown with the "Scopes enabled" checkbox in the component settings. This will also enable or disable the scope selector in the resource creation form.

You can also configure a participatory space so the filtering will only concern one scope and its children scopes. For example, let’s imagine your organization have 3 different scopes for 3 cities, each of them having children scopes for the cities neighbourhoods. On a participatory space which concerns only one of the cities, you will be able to select only this scope and its children so that users do not see the scopes of other cities in the filter options.

User interests and Newsletters

A Participant can choose which Scopes they want to follow in its account.

Account: my interests

This is used by the Newsletters, in the "Select recipients to deliver" step, "Filter for users having activated any selected scope in their account’s My Interests settings." section.

Newsletter: select recipients