> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userpilot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Checklist

> Checklists are increasingly becoming a vital tool for guiding new users toward successful activation.

## Overview

Checklists are increasingly becoming a vital tool for guiding new users toward successful activation. They serve as a structured roadmap, ensuring that users stay on track and complete the key tasks necessary to derive value from your product.

By implementing checklists, you can help users navigate their journey more effectively, reduce churn, and improve product adoption. These lists can include actions like exploring features, completing a setup, or performing specific tasks within the app.

<img alt="Checklist demo" src="https://mintcdn.com/userpilot/ytmW4H3YJ6rTDu59/images/Frameeee.avif?fit=max&auto=format&n=ytmW4H3YJ6rTDu59&q=85&s=4526dea8d34733e8e02c5dbcfe5b2641" className="dark:hidden" width="1728" height="2358" data-path="images/Frameeee.avif" />

<img alt="Checklist demo" src="https://mintcdn.com/userpilot/0hCXw5eVRU6iqpYB/images/Frameeee.png?fit=max&auto=format&n=0hCXw5eVRU6iqpYB&q=85&s=80967dfe0ff88910cdcd20ff0b862c2f" className="hidden dark:block" width="1728" height="2358" data-path="images/Frameeee.png" />

## Use Cases

* **Improved User Engagement:** Checklists encourage users to interact more with your product by providing clear, actionable steps.
* **Faster Time to Value:** By guiding users through the essential steps, checklists help them achieve their goals quicker.
* **Enhanced Onboarding Experience:** They simplify the onboarding process, making it less overwhelming for new users.
* **Increased Retention:** A well-implemented checklist ensures users remain engaged and reduces the likelihood of churn.

## **How to create a checklist**

**Navigate to Engagement > Checklists** from the sidebar.

<img src="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.13.03-PM.png?fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=14ee4fccab0116bd7854916e33aa966a" alt="Navigate to Engagement > Checklist" data-og-width="534" width="534" data-og-height="854" height="854" data-path="images/Screenshot-2026-06-05-at-2.13.03-PM.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.13.03-PM.png?w=280&fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=6c04f6dadcf1cfcf21ff978727111265 280w, https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.13.03-PM.png?w=560&fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=0c19fdb8f83ed821cdb4997e61733ff9 560w, https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.13.03-PM.png?w=840&fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=6a7e23d8ea9b9e35e36c71888b39f1eb 840w, https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.13.03-PM.png?w=1100&fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=246577cba441852527873ad941d74c7c 1100w, https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.13.03-PM.png?w=1650&fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=c2e56ac396b413795588582ad6adc6d5 1650w, https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.13.03-PM.png?w=2500&fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=cbf35631760ea52ed451f7353d5734ff 2500w" />

Then, click **Create Checklist** and enter the **checklist title** in the pop-up window.

<img alt="Click Create Checklist" src="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.16.57-PM.png?fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=e0bcd9cec64a93924e7bdb54634451d4" className="dark:hidden" width="2792" height="468" data-path="images/Screenshot-2026-06-05-at-2.16.57-PM.png" />

<img alt="Click Create Checklist" src="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.16.57-PM.png?fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=e0bcd9cec64a93924e7bdb54634451d4" className="hidden dark:block" width="2792" height="468" data-path="images/Screenshot-2026-06-05-at-2.16.57-PM.png" />

### Tasks tab

The first step of **creating a checklist** is to add tasks to your Checklist. 

<img alt="Add task" src="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.20.02-PM.png?fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=8d91e40ab235bbd896b5d0eafd011718" className="dark:hidden" width="2940" height="1666" data-path="images/Screenshot-2026-06-05-at-2.20.02-PM.png" />

<img alt="Add task" src="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.20.02-PM.png?fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=8d91e40ab235bbd896b5d0eafd011718" className="hidden dark:block" width="2940" height="1666" data-path="images/Screenshot-2026-06-05-at-2.20.02-PM.png" />

After clicking the **Add Task** button, a drawer will slide out where you can enter the task details. In the **Task Action** section, specify what should happen when a user clicks on the task.

* **Do Nothing**: The task will automatically be marked as complete in this case, without prior action.
* **Go to page**: To navigate the user to a certain URL.
* **Trigger a flow**: To trigger a flow that you have created from a checklist task.
* **Run script**: To run a JavaScript function once the user clicks on the task.

<img src="https://mintcdn.com/userpilot/wmxQrQyJqRV1jwFr/images/test34.png?fit=max&auto=format&n=wmxQrQyJqRV1jwFr&q=85&s=26c6892ab7e90d83cb413b79ac6a6458" alt="Test34 Pn" width="1738" height="1010" data-path="images/test34.png" />

<Note>
  In the checklist task, you can set the task "Go to Page" or use the flow "Route to URL" to direct users to a dynamic domain by replacing the desired domain with the "hostname" property. Additionally, you can ask your development team to pass a property for any dynamic parts of the page, and then replace the dynamic part with the passed property.

  You can set an Action for the Task to follow through with, as well as advanced settings to use when needed. 

  <img src="https://mintcdn.com/userpilot/i_hL61WZW7vm9Xm1/Screenshot2025-07-08at16.51.37.png?fit=max&auto=format&n=i_hL61WZW7vm9Xm1&q=85&s=77bf1be010f80e00b3e90da5e0af2eb3" alt="Screenshot2025-03-16at11.48.06PM" style={{ width:"96%" }} width="1422" height="782" data-path="Screenshot2025-07-08at16.51.37.png" />
</Note>

### Style tab

Under the **Style** tab, you’ll find two sections: **Widget** and **Beacon**. Each has its own set of style settings to help you customize your checklist to suit your use case.

Let’s take a closer look at each section.

**Widget**

The Widget tab lets you style the overall checklist, including task appearance, text, minimize button, dismiss behavior, and completion behavior.

* **Header:** Start by setting up the Header of the checklist. You can also add a subtitle to provide extra information or context.
* **Theme:** Select from your pre-created themes and choose them from a list to quickly apply a consistent style.
* **General:** Customize colors, icons, and automatic opening to match your brand.
* **Text:** Choose the font and set the header and body text colors.
* **Minimize button:** Define the style and colors of the minimize button.
* **Dismiss content:** Customize the dismiss button text and confirmation prompts.
* **Completion:** Set the title, description, and button text shown when all tasks are completed.

<img src="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.27.36-PM.png?fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=9af410b26a0a3fbbccc7322683c2d41b" alt="Checklist widget style settings" width="2936" height="1654" data-path="images/Screenshot-2026-06-05-at-2.27.36-PM.png" />

**Beacon**

The Beacon tab controls how the checklist looks when it’s collapsed.

* **Icon style:** Choose how the beacon appears, Icon in Circle, Icon in Square, Text Only, Icon + Text.
* **Background color:** Set the background color of the beacon.
* **Beacon Icon:** Select or upload the icon that represents your checklist when collapsed.
* **Label:** Add text to appear next to the icon (e.g., “Get Started”).
* **Color:** Choose the main color for the beacon.
* **Font color:** Set the color of the label text.
* **Corner radius:** Adjust how rounded the beacon’s corners are.
* **Positioning:** Choose where on the screen the beacon will appear.
* **Z-index:** Define layering to control how the beacon stacks over other page elements.

<img src="https://mintcdn.com/userpilot/HU0H9EdFShec0G0c/images/Screenshot-2026-06-05-at-2.30.11-PM.png?fit=max&auto=format&n=HU0H9EdFShec0G0c&q=85&s=1a4d6a99ad2cf30e4260221eb7e6534c" alt="Checklist widget style settings" width="2936" height="1664" data-path="images/Screenshot-2026-06-05-at-2.30.11-PM.png" />

### FAQs

<AccordionGroup>
  <Accordion title="How many tasks can I add per Checklist? " icon="sparkles">
    The maximum number of tasks that you can add per Checklist is 15.
  </Accordion>

  <Accordion title="Can i trigger two Checklists simultaneously on the same page?" icon="sparkles">
    No, Currently only one checklist can be triggered on a page at a given point of time. However, you can add another checklist in a Resource Center Module for the users to access both of the Checklists at the same time.

    <img src="https://mintcdn.com/userpilot/AID1pCY-bQgJdWy3/in-app-engagement/checklists/assets/images/Screenshot2025-03-17at12.02.43AM.png?fit=max&auto=format&n=AID1pCY-bQgJdWy3&q=85&s=e817354eb54bb1f7bdad3a6821726f52" alt="Screenshot2025-03-17at12.02.43AM" width="1784" height="1092" data-path="in-app-engagement/checklists/assets/images/Screenshot2025-03-17at12.02.43AM.png" />
  </Accordion>
</AccordionGroup>

<Frame>
  [**For any questions or concerns, please reach out to support@userpilot.com**](mailto:support@userpilot.com)
</Frame>
