> For the complete documentation index, see [llms.txt](https://rollouter.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rollouter.gitbook.io/guide/rollout-managers/setup/checklists/persistent-checklists.md).

# Persistent Checklists

## What is a Persistent Checklist?

{% hint style="info" %}
A Persistent Checklist enables you to **share Checklist steps** between **multiple, consecutive Workflow statuses**. If persistency is applied to a Checklist, a Client can progress in the Workflow without the particular Checklist being completed. The Persistent Checklist must be **completed in the status of its last consecutive occurence**.
{% endhint %}

***

## Example

An example use-case would be a **Back-up Checklist** for the **old device** which needs to be completed **by the Client user** (owner) of the device. It contains a handful of important but manual steps that need to be taken care of before the old device can be exchanged by the new one.

The following diagramm uses the "**complete**" arrows to visualize, when the Checklists need to be completed in order for the Client to move to the next status:

<figure><img src="https://750384937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIeSHc7pNZWey2rD63q9j%2Fuploads%2FljWB6E09sF5FVqRx2LAI%2Fimage.png?alt=media&amp;token=e3c70034-2934-4891-a8c2-365fb0f883e0" alt=""><figcaption><p>Since the blue <code>Back-up Checklist</code> is the Persistent one and it was added to both statuses <code>Staging</code> and <code>In Delivery</code>, it has the same state in both statuses in terms of the Checklist steps values.</p></figcaption></figure>

The corresponding Workflow would look like this:

<figure><img src="https://750384937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIeSHc7pNZWey2rD63q9j%2Fuploads%2FoHrhUAcM1z5yuOp6OxdL%2Fimage.png?alt=media&amp;token=6c687be8-621c-4228-9d1e-93a3f8a1334b" alt=""><figcaption><p>In the Workflow editor, the Persistent Checklists are highlighted if the persistency is applied.</p></figcaption></figure>

{% hint style="success" %}
Like this, the **Back-up Checklist** will

* **not block the Rollout crew** from moving the Client from `Staging` to `In Delivery`
* **occur in both of the statuses** to be worked on

Because the **Client user has time until the Client should advance** from `In Delivery` to `Done` to complete the Back-up Checklist.
{% endhint %}

***

## Edge Case behaviour

If a Persistent Checklist is added to multiple Workflow statuses except for one in between, the persistency is not applied to the individual occurence:

<figure><img src="https://750384937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIeSHc7pNZWey2rD63q9j%2Fuploads%2F9njQTjNJmpodbKe2E1d8%2Fimage.png?alt=media&amp;token=47c1d227-906a-49cc-8a0e-ab8248346d7b" alt=""><figcaption></figcaption></figure>

***

## Summary

{% hint style="success" %}
A Persistent Checklist should be used **when you have work steps** that

* can or should **be worked on throughout multiple statuses**
* should **not block these statuses** from completion until the work steps definitely need to be finished
  {% endhint %}
