No categories assigned


    • No status information
< Manual:Extension

About checklists

It is easy to insert simple checklists into any wiki page. When a wiki page has a checklist, any user with edit rights can update the checklist values without switching into edit mode.

Checklist examples (checkbox and select menu)
Checklist examples (checkbox and select menu)

Creating a checkbox

Checklist items can be inserted with VisualEditor:

  1. Click Insert in VisualEditor.
  2. Click More.
  3. Click Magic word.
  4. Select checklist.
  5. Choose checkbox or list in the configuration box.
    • Checkbox: creates a single checkbox. It can be pre-selected or not selected.
    • List: creates a combo box. A predefined list of options as well as the current status can be selected.

Magic word
Magic word

Multiple checkboxes/comboboxes can be added to a page.

Defining an option list

Before a combobox can be created, a template for the list items needs to be available. For example, to create a list of pizzas, you need to create a page Template:Pizza with the following content:

* Choose pizza
* Margherita
* Prosciutto
* Salami
* Fungi|#00FF00
* Hawaii
* Gamberetti|#0000FF
* Diavolo
* Siziliana|#0000FF
* Quattro Formaggi|#00FF00

After saving this page, the list "Pizza" appears in the select menu Option list.

Colors can be assigned to each option using the color's HEX code. The color value #FF8800 shows orange text.

* Quattro Formaggi|#FF8800

Without specifying the color, text inherits the text color of the wiki page.

Adding checklists in source editing mode

In addition to using VisualEditor to add and edit the checklist tag, it can also be added to a page using wikitext. The syntax for adding the tag is:

  • for checkboxes: <bs:checklist type="check" checked="true" />
  • for lists: <bs:checklist type="list" list="Template:Pizza" value="Choose pizza" />

BlueSpiceChecklist when viewing pages


Every user with edit permission can insert and edit checkboxes and select menus. Users with "checklistmodify" permission can set the value of a checkbox or select menu (by default users). The following configuration can be changed in the Config manager:

  • Mark checklist changes as minor edit: If this setting is active, changes to a checklist (for example, checking a checkbox) in view mode are logged as minor edits. If this setting is inactive, a change to the checklist is not recorded in the page history.
    minor edit
    minor edit

Related info