Troubleshooting

Symptoms first, in the words people actually use. Every entry links to the page that explains the behaviour properly.

Almost everything here is CheckFlow working as designed. The two genuinely most common causes are a missing permission and a change made to a template after the checklist already existed.

I Cannot See Something

What you seeWhyWhat to do
No Show Menu button on an open checklistYou do not hold Checklist.MenuAsk an Administrator. See User Permissions.
The Selected button offers no archive or delete optionThose are Administrator-only bulk actionsSee Managing Checklists.
No Archived Checklists entry in Report ViewsAdministrator-only viewSee Archived Checklists.
The Library is empty, or a folder is missingNo Library permission, or Deny on that folderSee Library Roles and Permissions.
A Tag Page shows no library itemsLibrary items need Library.Viewer; without it the section is not shown at allSee Finding Tagged Items.
The activity feed is missingNot visible to Guest usersSee Activity Feed.
A permission was granted but nothing changedPermissions apply when the user's token refreshesLog out and back in. See User Permissions.

A Task Will Not Complete

What you seeWhyWhat to do
Error under a controlA required control has no valueFill it in. See Control Types.
Cells outlined in red on a tableRequired cells are emptySee Table Control.
The task is greyed outAn earlier halt task is not completeSee Enforce Task Order.
The task is greyed out, and you are not an assigneeOnly Assignees Can Complete This Task is setSee Task Assignments.
A Mail-To control blocks completionSend Mode is Required – Manual SendSend the email first. See Mail-To Control.
A pop-up error when completing from the DashboardValidation failed on a control you cannot see from thereOpen the checklist and complete it there.
Required table cells are not enforced everywhere

A Table validates its required cells only when the task is completed from inside the checklist. Completing from the Dashboard or through the API bypasses it. If a value is essential, back the table up with a required Short Text or Sub-Tasks confirmation.

My Change Did Not Take Effect

What you seeWhyWhat to do
Edited a template, existing checklists unchangedDeliberate — a checklist is a record of what happened at the timeSee Templates Overview.
Changed a template's tags, existing checklists keep the old onesSame ruleSee Tagging Templates.
Added a Data Set record, a Sub-Tasks or Table control did not updateThose two capture their list once, at creation; Dropdown and Multi-Choice read liveSee Using Data Sets in Checklists.
Changed checklist permissions and it did affect existing checklistsThe deliberate exception — access control must apply immediatelySee Checklist Permissions.
A template change did not create a new versionPermission changes are the one edit that does not versionSee Template Versioning.

Something Sent, or Did Not Send

What you seeWhyWhat to do
A Mail-To hidden by conditional logic still sentHiding affects display only; Auto Send still firesUse Optional – Manual Send and hide it. See Mail-To Control.
A Mail-To send failed with no valid recipientA dynamic value in To could not be resolved and was droppedSee Mail-To Control.
An auto-sent email has not appeared in the logAuto sends are dispatched by a background process shortly after completionWait a moment and check again.
The same Mail-To did not send twiceEach auto-sends once per checklist, even if the task is re-openedSee Mail-To Control.
No Is Completed notification when a task was skippedMarking Not Applicable does not fire itAnchor on Status Is Changed instead. See Mark a Task Not Applicable.
A user stopped receiving overdue emailsThey can unsubscribe in their own user settingsSee Task Due Dates.
A CSV import into a Data Set raised no webhooksBulk operations deliberately raise no per-record eventsSee Webhooks API.

Reports and Analytics

What you seeWhyWhat to do
A control is missing from the column listOnly ten control types can be a report columnSee Report Columns.
No Tasks & Fields columns at allThey appear only when exactly one template is selectedSelect a single template.
A saved report view cannot be sharedSharing needs Report.Creator; creating one does notSee Custom Report Views.
Reports and Analytics disagreeThey measure different things over different scopesSee the comparison at the top of Reports.

Controls Behaving Oddly

What you seeWhyWhat to do
An Embed control is blankThe target site blocks being framed — set by that site, not CheckFlowTry the service's dedicated embed URL. See Embed Control.
An embedded video will not playThe source blocks embedded playback, or the video is privateSee Video Control.
A Linked Checklist shows a message instead of the child checklistLinked Checklists cannot render inside a shared checklistSee Linked Checklist Control.
Auto Create is unavailable on a Linked ChecklistThe linked template is the template the control lives inSee Linked Checklist Control.
A tooltip icon does not appear on a SeparatorA Separator draws no label for the icon to attach toPut the tooltip on another control. See Tooltips.
Two tags look identical but behave separatelyTwo tag objects with the same nameAlways pick from the autocomplete. See Applying Tags.

Still Stuck

If the answer is not here, contact support. Include the checklist or template name and what you expected to happen — the difference between "it did not work" and "the task would not complete and there was no error" is usually the whole diagnosis.

Related Pages