Checklists Overview

Want to get your Checklist published quickly? Check out the webinar below which will have the basics to get you up and running. For more in-depth information check out the Checklist webinar or written content below. For troubleshooting help, check out our FAQ

In this article we'll cover the following:

Creating Checklists

Head to the Checklists page to 'Create a New Checklist' or edit an existing one.

Back to top  

Checklist Styling

After you've given your list a good name:

  • Modify the primary list colors
  • Choose the position and text for the Beacon
  • Add your user facing header and description text

The "Beacon" is the button users click to open the Checklist dialog. Unlike other Appcues flows, the Checklist Beacon is persistent and stays in one place until the user completes the checklist or is no longer eligible.

You can customize the content of the list dialog, including the title and description. Keep it short, and consider preceding the Checklist with an Appcues flow like a modal or slideout if you think a deeper introduction would be valuable (see the FAQ below for more info).

The Main Heading is the title that appears in the Checklist window, as shown below.

Back to top  

Adding a Custom Font

With the font picker in the Checklist Editor, it is possible to add your very own custom font! All you have to do is scroll down to the bottom of the options list and choose "Custom..."

Once you have this custom option selected, you'll notice two additional fields pop up. These are where you can put the information for your custom font.   

These new fields will be for adding in the CSS that the checklist will use to display your new font ("Custom Font CSS") and the URL where your custom font is hosted ("Custom Font URL").

Start by adding in the CSS that the checklist will use to display your font. In this field you'll simply add in the value that would normally come after the  font-family property in your web app's CSS. For example in this case, we're trying to add in the Homemade Apple font from Google Fonts for our sister website Napcues, where family members can posts notices to others telling them when to wake them up from their nap.

The CSS to use this font in our application would normally look like this: 

font-family: 'Homemade Apple', cursive;

Don't be intimidated by this! The first part is just the portion of our CSS rule that tells the browser we want to change the  font-family we're using for the checklist and the part after the colon tells the browser what font families to actually use. 

Note that for this example, we have our awesome "Homemade Apple" font and then "cursive" specified. The "cursive" is a back up font in case our Google Font doesn't load. You don't have to include a backup font, but it is usually a good way to make sure that all your users have a good experience. 

If you are using Google Fonts, the site is super helpful and will tell you what to write for this CSS! Just add a font on the site, click on the little box that says "Family Selected" and it will give you a slide-out with lots of helpful information that looks a something like this:  

Once you've figured out what CSS to use, you can type it into the "Custom Font CSS". Your editor should now look something like this: 

When you add in the CSS rule you can leave the semicolon at the end or take it out. Either one will work.

Don't be afraid that your checklist still doesn't show your custom font. It still needs to know where to get your custom font from on the world wide web. This is the url that your font is hosted at. If you're not sure what this URL is, it will usually be in your web application somewhere as a <link> tag. 

If you're using Google Fonts, this is another place where the aforementioned helpful slide-out has your back. You can look at the  href that is in the <link> tag and copy paste that URL into the "Custom Font URL" box. 

At this point, your checklist should be showing your custom font!

Common Issues

If your font still isn't showing up the right way there are a couple of things to think about.

  • Make sure that the URL is actually serving up your font
    • The URL that you are putting in the "Custom Font URL" field actually needs to send your font over. It should be sending something that looks like code. If you paste the URL into your browser and you get something that looks like a regular website, chances are you don't have the right link to the place where the font itself is hosted.
  • Make sure that your Custom Font CSS doesn't have the font-family part of the rule
    • We take care of the font-family part for you! The checklist only needs the name of your font and a backup font if you're using one to display things the right way. You're not writing the full CSS rule, just giving us the part that goes after font-family.
  • You have a typo in the CSS or URL
    • If things still aren't displaying, go back and make sure that you don't have a typo in the CSS or the URL that you gave us. Don't worry, it happens to the best of us!


Back to top  

Add Checklist Items

Select “Add Checklist Item” to add additional items to your list:

Give each Item a name users will identify with. We recommend that the first item be checked off (ex. Create Account) to build some momentum.  Then set up what will happen when the Item is clicked:

Note: If you'd like a flow to show only when launched from the Checklist, set that flow to 'Show Manually'.

Go to a page:
 Add a URL that you'd like to redirect your users to.

Launch a Flow: select the Flow a user will see once they click the list item. If the flow needs to start on a specific page, enter the URL so Appcues will redirect users to that page before showing the flow. If the URL isn't important, just add the name of the flow to be shown.


Mark Completed When...

When the user matches: the best success criteria is the completion of an action, which can be tied to an Event. When that Event occurs the Item will be checked. You can also use the completion of a Flow, or a User Property as the success criteria.


Back to top  

Checklist Targeting

To ensure the right users will qualify to see the Checklist you can add an existing  Segment, or use normal flow targeting options. Then modify where they see the Checklist, with specific path targeting and environment/domain targeting, just like your flows.

"Which page should we show this content on?"

Here you can specify the path(s) that you want your checklist to show on. For testing, there's no need to change anything in this section. You can simply set it to the path(s) you'll want the checklist to show on for your end users. 

"On which environments?"

Here you can specify the domain(s) where you would like your checklist to appear. You can either publish this to anywhere your Appcues embed script is installed or select specific domains.

If you would only like to test your checklist on your staging site or your production site, you can select the appropriate domains at this point. 

"Who should see this content?" (for testing, this is the important one!) 

Here is where you can set your checklist to only show to users on your team (i.e. no end-users). To do this, target your checklist to your team by using the "Specific users" option. Here, you can specify specific user properties to target. For example, you could target to specific email addresses, as shown below: 

Back to top  


Once all of your checklist targeting is set up, go ahead and publish the checklist. You can then sign in to your platform, navigate to a page where you expect the checklist to appear, and test it!  

Back to top  

Testing Checklists

Because of the targeting you have set up, only the people you want to see the checklist will be able to see it. Once you test the checklist and it looks good, you can change the checklist targeting configurations so that they include your end users. 

A few things to keep in mind
  • You will be testing the checklist as it appears for the user credentials you used to sign in to your platform. If you have already completed one or more of the checklist items, they will already be marked as complete. To test it as a new user, you would need to create a new user account on your platform. 
  • If one of your checklist items is a flow and it is not working, make sure that the flow is published and live on your site. If you only want to test the flow (and don't want it to be live to your end-users), you can follow the flow testing steps.
  • The checklist should follow the below behaviors:
    1. Expand if it's the first-ever view
    2. Expand if it's the first view of the session (i.e. they've opened a new tab to the site)
    3. It will not expand in all other cases

Back to top  

Still curious how our Checklist feature works? 

In this training webinar, we'll cover how to conceptualize and plan for your Checklist, including mapping out your customer journey. We'll also include a short demo of the tool and how to build it. Lastly, we'll run through the analytics of your Checklist, how to measure success and iterate.

In this Checklist Webinar, we cover How to create an onboarding flow using Checklists.

Back to top  

Submit feedback on this doc ➤

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.