# Discourse Checklist

**URL:** https://meta.discourse.org/t/discourse-checklist/36362
**Category:** Plugin
**Tags:** official, checklist, included-in-core
**Created:** [December 5, 2015, 11:57pm UTC](https://meta.discourse.org/t/discourse-checklist/36362 "2015-12-05T23:57:25Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [December 5, 2015, 11:57pm UTC](https://meta.discourse.org/t/discourse-checklist/36362/1 "2015-12-05T23:57:25Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Discourse Checklist** allows checkboxes to be added to posts with simple Markdown |
| 📖 | **Install Guide** | **This plugin is bundled with Discourse core**. There is no need to install the plugin separately. |

> [@](#):
>
> :discourse2: As this is an #official plugin maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=checklist "Ask for support on configuring and using Discourse Checklist") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=checklist "A bug report means something is broken, preventing normal/typical use of the plugin") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=checklist "Discussion about the user interface of Discourse Checklist, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=checklist "Discussion about how existing Discourse Checklist features can be improved or enhanced, and how proposed new features could work")

### Enabling Checklist

The Checklist plugin is enabled by default but can be disabled/enabled from its settings, accessed from your `admin/plugins` page:

![Checklist settings](https://global.discourse-cdn.com/meta/original/4X/8/5/e/85ed808908f8875dd4fc75b9a9a077bce116a26f.png)

### Features

Once enabled, you can add checklists to your posts by typing them in like this:

- `[]` or `[]` for an unchecked box
- `[x]` for checked box (no fill)
- `[X]` for a checked box (with fill) - Permanent option, which can no longer be toggled

 ![checklists example](https://global.discourse-cdn.com/meta/original/4X/6/b/0/6b045659b23e3840dbfda965853e50132e03e437.png)

You can also keep checking/unchecking boxes on the same post without having to refresh the page.

### Settings

| Name | Description |
| --- | --- |
| checklist enabled | Enable checklist plugin? |

> :discourse2: Hosted by us? This plugin is available on all of our hosting tiers [Checklist | Discourse - Civilized Discussion](https://www.discourse.org/plugins/checklist.html)

* * *

### Development History

Special thanks to:

- @lightyear for creating the initial version
- @cpradio for porting it to our new patterns and maintaining it for years!

> Last edited by @tobiaseigen 2025-07-16T20:46:11Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/discourse-checklist/36362)._