Search Pilla

Search pages and blog articles, or ask Pilla.

Running workflows

Run and track work day to day, on mobile and the web.

Workflow templates and workflow runs

A workflow template is the playbook you build once. A workflow run is what your team actually does each time the template fires. This page explains the difference, where each lives in Pilla, and how to move between them.

What a workflow template is

A workflow template is built on the canvas, the visual builder on the web app. The template defines what staff are asked to do, in what order, and the trigger that decides when it should run. You add steps (called elements) and wire them together: input elements (text, number, photo, and so on), choice elements (checklist, choice, rating scale, user choice), guidance elements (written, photo, and video instructions), groups (collapsible containers of elements), and Pilla steps (the AI briefings, decisions, and actions).

A template needs three things before it can fire: a name, a tag, and an audience picked in the Assign to field, which is either one or more teams or one or more individual people (a person-assigned workflow runs privately for each person; see the Assigning workflows to people help page). The trigger you choose decides how the template turns into runs:

  • Manual (Run manually): a member of staff starts the workflow when needed from the mobile app
  • One-time (Run once): the workflow runs once at a specific date and time
  • Repeating (Run hourly, Run daily, Run weekly, Run monthly, or Run yearly): the workflow runs on the schedule you set
  • External (Run from external trigger): an outside service starts the workflow through an integration. This disabled option is marked Beta and is visible only on Expert

For step-by-step canvas building, see the canvas section.

What a workflow run is

A workflow run is a single execution of a template. Each time a template fires (someone taps Run on mobile, the schedule comes around, or an external trigger arrives), a new workflow run is created. The run is what your team works through and finishes. One template produces many runs over time.

A run carries everything from the template plus what staff add as they work: their answers, photos uploaded, choices ticked, the start time, the finish time, and whether it was completed on time or late.

The Workflow templates view on web

The Workflow templates view shows the live templates available to you, grouped by how they get triggered. Managers and Admins open it from the Workflow templates card on the Dashboard. Staff use Workflows and my automations in the top bar.

Starter and Pro accounts have two columns:

  • Manual triggers: templates that staff start themselves on mobile
  • Scheduled triggers: templates that start on a date or repeating schedule

Expert accounts also have an External triggers column before those two columns. It is marked Beta and holds existing templates started by an integration. You cannot set up a new external trigger yet.

Each column shows the count of templates in brackets and lists them alphabetically. Managers and Admins can see unfinished templates with a Draft badge. Click any row to open it on the canvas. Managers and Admins also get the three-dot menu with Edit workflow, Duplicate template, Share publicly, and Delete template. Staff see live workflows only, with no shared editing menu.

At the top of the view everyone can filter by team or tag and search by template name. Managers and Admins can also click New template to start a fresh canvas.

The Workflow runs view on web

The Workflow runs view is a data table where each row is a single run. Open it from the "workflow runs today" card on the Dashboard.

Each row shows:

  • Date -- the day the run is scheduled for, with the start and end times below
  • Name -- the workflow name with the team below. A run from a workflow assigned to a person shows that person's name here instead of a team name
  • Tag -- the progress (for example "5/8") with the tag name below
  • Frequency -- how often the parent template repeats (Daily, Weekly, etc.) with "Recurring" or "Single Event" below

A coloured strip on the left edge of each row tells you the status at a glance. See Filtering and status for the full meaning.

At the top of the view you can pick a date or date range, filter by team, tag, or status, and search by name. Click a row to open the run and see every element, the answers staff have entered, and a "Completed by {name} · {date} {time}" line on each finished step (when your account allows it). The three-dot button on each row opens a menu with Message team about this, DM user about this, Reset this workflow run (clear all answers and reopen the run), and Delete this workflow run. Tick the checkbox on two or more rows and the menu switches to a single Delete {count} work option for deleting them in one go.

On the mobile app

Staff complete workflow runs in the mobile app. They can use the web Workflow templates view only to open a live workflow and manage their own Pilla automations; they cannot change its shared steps. The first tab on mobile (a tick-square icon, no label) shows the work runs scheduled for the selected date as cards, sorted by time. Staff tap a card to work through the run and mark it complete. The screen header shows the date and an overall status line such as "All on track" or "Behind schedule". Tap the Info (ⓘ) button in the header to open an "About workflows" explainer. For the full mobile flow see Completing a work run on mobile.

Tips

  • One template, many runs. Edit the template on the canvas to change every future run; edit a single run to change only that one
  • A template can be assigned to individual people instead of teams. Each person then gets their own private run that only they, the manager who assigned it, and admins can see
  • The Workflow runs view is date-scoped: pick a date or range at the top to control what you see
  • The Workflow templates view is not date-scoped because templates do not have a date themselves; only their runs do
  • On the Dashboard, clicking a day on the chart opens the Workflow runs view filtered to that day
  • External triggers are still in Beta. Expert accounts see the disabled option and the External triggers column. Existing Expert templates that use it stay editable

Filtering and status

The Workflow runs view on the web app lets you narrow down what you see and tells you at a glance how each run is doing. This page covers the web filter bar, the date picker, the colour-coded status strips, and how to clear everything. The mobile app has its own, simpler set of filters on the Upcoming Work screen, covered at the end of this page, and shows the same status colours.

The date picker

The date picker is the first button on the filter bar, on the far left. It shows the current date (for example "9 Jun") or, when you pick a range, both ends ("9 Jun - 12 Jun"). It controls which workflow runs you see by date.

  1. Click the date button on the left of the filter bar
  2. Click a single day, or click one day and then another to pick a range
  3. Click anywhere outside the popup to close it -- the table updates straight away

When a range is selected the date button gets a darker outline so you can tell at a glance that the table is filtered by date.

A checkbox sits under the calendar labelled "Hide carried-over work". Tick it to hide runs that started before your date range but are still open, so the table only shows runs that actually started inside the dates you picked.

Filter by team

Click "All Teams" on the filter bar to pick the teams you want to see runs for. Tick the teams in the list and the table updates straight away. The button shows a darker outline whenever the table is filtered, which means at least one team is unticked.

The first row of the popup is "Select All" / "Deselect All". When every team is ticked the row reads "Deselect All" and the button has its plain outline; click it to clear the table down to nothing. When nothing is ticked the row reads "Select All"; click it to bring every team back and remove the filter.

Filter by tag

Click "All Tags" on the filter bar to pick the tags you want to see runs for. Tags are how you group workflow templates by purpose (cleaning, audits, opening checks, etc.). For more on tags see Workflow tags.

Tick the tags you want and untick the ones you do not. The button gets a darker outline whenever the table is filtered, which means at least one tag is unticked. The "Select All" / "Deselect All" row at the top of the popup ticks or unticks every tag at once.

Filter by status

Click "All Statuses" on the filter bar to pick which states you want to see. The options are:

  • Finished on time -- the run was completed by its end time
  • Finished late -- the run was completed after its end time
  • Overdue -- the run is unfinished and its end time has passed
  • Open / upcoming -- the run is unfinished but not overdue, or is a future virtual run that has not been created yet

Tick the states you want and untick the rest. The button gets a darker outline whenever the table is filtered, which means at least one state is unticked. The "Select All" / "Deselect All" row at the top of the popup ticks or unticks every state at once.

Search by name

There are two ways to search by run name, and they share the same search text. One is the search box on the right of the filter bar, with the placeholder "Search work...". The other is the small search icon next to the "Name" heading at the top of the table, which opens its own little search box. Type into either one and the table narrows to runs whose name contains what you typed. The match is not case sensitive and partial matches are fine. To remove the search, delete the text in the box. In the small box that opens from the "Name" heading you can also press Escape to clear it.

When Pilla shows runs for one named workflow, it puts that workflow name into the same search box.

Colour-coded status strips

Every row in the Workflow runs table carries a coloured strip on the far left edge, next to the row's tick box. The colour tells you the state of that run without having to open it.

ColourWhat it means
GreenFinished on time
OrangeFinished, but after the end time
RedNot finished and the end time has already passed (overdue)
No colourFuture run, a run in progress that is not yet overdue, or a virtual run that has not been created

Hover over any strip for a short tooltip that says the same thing in words.

On mobile. Staff and managers see the same colours in the mobile app, but on the work cards rather than in a table. Each work card carries a coloured left edge using the same rules: green for finished on time, orange for finished late, red for unfinished and overdue, and no colour for future or in-progress work. The mobile app has a built-in legend: tap the Info (i) button in the top-right of the Upcoming Work screen to open the "About workflows" explainer, which shows a "Colours show work status" key with dots labelled "Unfinished and late", "Finished late" and "Finished on time".

How filters combine

All the filters above work together: a run only shows up if it matches every filter that is narrowing the table. So if you pick one team, one tag and the "Finished on time" status, the table shows runs that belong to that team, carry that tag, and were finished by their end time.

A filter only narrows the table when at least one of its options is unticked. If every option in a filter is ticked, that filter does nothing.

Clearing filters

Each filter has its own clear behaviour:

  • Date -- click the date button and pick a single fresh day to replace the range
  • Team, Tag, Status -- open the popup and click "Select All" so every option is ticked
  • Search -- delete the text in the search box (or press Escape in the small search box that opens from the "Name" heading)

There is no single "Reset all filters" button, and the filters stay put as you move around the web app. They do not reset when you visit another view and come back, so clear each one yourself when you want a fresh start.

Filtering on the mobile app

The mobile app has its own smaller set of filters on the Upcoming Work screen, reached from the menu rather than from a filter bar. Tap the "Menu" button at the bottom-right of the screen to open the menu, where you will find these filters:

  • Filter teams -- opens the "Filter Work Teams" screen. Tap the teams to tick or untick them, or use "Select all" / "Deselect all" in the top-right. The screen narrows to runs for the ticked teams.
  • Hide carried-over workflows -- a tick toggle that hides runs which started before the selected date but are still open
  • Hide completed workflows -- a tick toggle that hides runs that are already finished
  • Show workflow runs by tag -- lets managers and admins pick a tag and see runs that carry it

When any of these filters is active the screen title shows "(filtered)" after the date. If the filters leave nothing to show, the screen reads "No workflows to see" with "Try removing a filter" underneath. To clear a filter, open the menu again and turn the toggle back off, or tap "Select all" on the team screen. Some of these menu options can be switched off for individual staff, so a staff member may not see every one.

Tips

  • A darker outline around a filter button is your signal that the table is filtered on that field; the plain outline means that filter is showing everything
  • The "Select All" / "Deselect All" row at the top of each filter popup is the quickest way to tick or untick every option at once
  • Status colours line up between the web table and the mobile work cards, so staff, managers and admins all read the same green, orange and red signals
  • Tick the "Hide carried-over work" checkbox in the date popup when you want a clean picture of work that began inside your date window, ignoring older runs that are still open

Workflow and reporting tags

Tags help you organise related workflows and steps. You add them while editing a workflow template on the web app.

Understand the two types of tag

A workflow template is the reusable workflow you set up. A workflow run is one copy that your team completes. The same list of tag names is used for two different purposes.

TagNeeded?
WorkflowRequired
ReportingOptional

You add the workflow tag at the top of the canvas. It groups the whole workflow template and its runs.

You add a reporting tag to an individual input or check step. It identifies related steps in reporting, and each step can have no more than one.

For example, you could use the workflow tag "Opening checks" for the whole template. You could then use the reporting tag "Temperature checks" on steps called "Check fridge temperature" and "Record chiller temperature". The reporting tag lets those differently named steps be treated as related.

Add a workflow tag

Managers and Admins can add a workflow tag while editing a workflow template. The canvas is the screen where you arrange the workflow steps.

  1. Go to Workflow templates in the web app and open the template.
  2. Select Tag at the top of the canvas.
  3. Enter part of a tag name in Search tags... if you need to narrow the list.
  4. Choose a tag.
  5. Select Save.

The workflow tag is saved on the template and carried into its workflow runs. The All Tags filters in the Workflow templates and Workflow runs screens use this workflow tag.

Add a reporting tag to a step

Managers and Admins can add a reporting tag to an input or check step. Guidance steps do not have this option.

  1. Go to Workflow templates in the web app and open the template.
  2. Select the input or check step you want to tag.
  3. Tick Add a reporting tag.
  4. Select Reporting tag. It shows No tag until you choose one.
  5. Enter part of a tag name in Search tags... if you need to narrow the list.
  6. Choose a tag.
  7. Select Save.

The reporting tag is saved on that step. New workflow runs created from the template carry the tag on the same step. Saving can also update runs scheduled after today when nobody has started them. It does not retag runs scheduled for today, past runs, completed runs, or runs that someone has already started.

The All Tags filter in the Workflow runs screen uses the workflow tag. A reporting tag on one step does not change which runs appear in that filter. See Filtering and status for help with the Workflow runs filters.

Remove a reporting tag from a step

Removing a reporting tag changes the template after you save it. It does not remove the tag name from your account.

  1. Open the workflow template on the web app.
  2. Select the tagged step.
  3. Untick Add a reporting tag, or open Reporting tag and choose No tag.
  4. Select Save.

New workflow runs no longer carry that reporting tag on the step. The same protection for existing runs applies: runs scheduled for today, past runs, completed runs, and runs that someone has already started are not retagged.

Create a tag

Managers and Admins can create a tag from either the workflow Tag list or the step Reporting tag list. The new name becomes available for both types of tag across your account.

  1. Open the Tag or Reporting tag list on the canvas.
  2. Enter a name in New tag.... The name is required and can contain up to 255 characters.
  3. Select Create tag, shown as a plus icon, or press Enter.

Pilla creates and selects the tag straight away. The tag remains in your account even if you leave the canvas without saving. Select Save to keep the tag assignment on the workflow template or step.

Rename or archive a tag

Managers and Admins can rename or archive tags. These changes apply across the account as soon as the action finishes.

Rename a tag

  1. Open the Tag or Reporting tag list on the canvas.
  2. Select the pencil icon beside the tag.
  3. Enter the new name.
  4. Select the tick icon to save the new name.

The new name appears anywhere the tag is already used, including on workflow templates, runs and steps.

Archive a tag

  1. Open the Tag or Reporting tag list on the canvas.
  2. Select the archive icon beside the tag.
  3. Review the Archive [tag name]? confirmation.
  4. Select Archive tag.

The tag stays on workflow templates, runs and steps that already use it. On the canvas, an existing assignment is labelled (archived). You cannot choose it for a new assignment. If you remove an archived workflow tag, choose an active tag before saving because every workflow template needs one. An individual step can have No tag.

View workflow runs for a tag on mobile

Managers and Admins can open a list of workflow runs for one workflow tag in the mobile app. Reporting tags on individual steps are separate from this list.

  1. Open the Work Items tab on mobile.
  2. Tap Menu in the bar at the bottom.
  3. Tap Show workflow runs by tag.
  4. Tap Start Date or End Date to narrow the list to a date range if needed.
  5. Tap Change Tag to choose a different workflow tag.

The list shows No work items found for this tag when no runs match the tag and dates you chose. Whether Show workflow runs by tag appears is controlled by an account setting.

Tips

  • Use short names that describe a shared purpose, such as "Opening checks" or "Temperature checks".
  • Renaming a tag changes its name everywhere it is used. Check the other templates and steps that use it before you rename it.
  • Duplicating a step or workflow template keeps an active tag. An archived tag is cleared from the duplicate because it cannot be selected for a new assignment.

Mobile app overview

The Pilla mobile app is built for doing the work. You sign in, see the work runs scheduled for you that day, and tick them off. Managers and admins get a few extra options for resetting, reopening, and deleting runs, and admins can add users, add teams, and adjust account settings from the app too.

What the mobile app is for

The mobile app is execution-only. You can't build workflow templates or canvases here; that all happens on the web app. The mobile app is where the work actually gets done:

  • See the work runs scheduled for your team today
  • Open a run and fill in each step
  • Mark a run complete when everything's filled in
  • Chat with your team about a specific run
  • Post and watch stories
  • Talk to Pilla about your day

The app runs on phones and tablets, and always stays in portrait.

The Work Items screen

The bottom of the screen has a single tab called Work Items, marked with a tick-in-a-square icon. That's where you spend almost all your time, and it's the screen you land on when you open the app.

The Work Items screen has three main areas, top to bottom:

  1. The stories row (round profile pictures)
  2. The horizontal date scroller
  3. The work list (one card per work run)

At the very top sits a header showing the selected date and a short status line, with an Info (ⓘ) button in the top-right corner that opens a quick explainer of the screen.

Stories row

The top of the Work Items screen has a horizontal row of round profile pictures. Each circle is one teammate who has posted a story.

  • Tap a circle to watch that person's stories full-screen
  • Tap the + on your own circle to record and post a new story
  • Faded circles mean you've already watched everything that person posted

For the full guide to posting and watching, see Stories.

Horizontal date scroller

Just below the stories row sits a row of dates. Today is the default. Swipe left and right to scroll through more dates, and tap a date to jump the work list to that day. How far ahead you can scroll is set by your account's look-ahead setting.

Each date shows a small count beneath it, written as "finished/total". For example "1/2" means one run out of two is done for that day. The selected date scrolls to the centre, and dates beyond your look-ahead range show in grey.

The work list

Below the date scroller is the list of work runs for the selected day. Each card represents one run, and shows the run name, the team it's for, and a small count of how many steps are done. A coloured bar down the left of the card matches the web app:

  • Green: everything's complete and on time
  • Orange: finished late
  • Red: missed, or unfinished and behind schedule

Tap a card to open the run. Once you're in, you can fill in each step. See the "Completing a work run on mobile" doc for the full flow.

You can also swipe a card sideways for quick messaging: swipe right to open the team chat for that run, swipe left to start a direct message about it.

Floating action bar

A floating bar sits above the work list with three buttons. It stays in place wherever you scroll.

  • Left, chat bubble button: opens Chats. Talk to your team, send direct messages, and read replies. See Team collaboration for the messaging guides.
  • Middle, target button: opens Pilla, the AI assistant. Ask questions about your work, your team, or your account.
  • Right, Menu: opens an action sheet with options for the screen you're on. The word "Menu" sits next to the icon.

The menu on the Work Items screen

Tap Menu to open the action sheet, titled "Menu". The options you see depend on your role and on which options your account has switched on. Everyone always sees a Log out option at the bottom.

Everyone sees these options (each can be hidden by an admin in account settings):

OptionWhat it does
Run a workflow templatePick a template you can run on demand and start it for one or more teams.
Filter teamsChoose which teams' work appears in your list.
Hide carried-over workflowsHide runs that started on an earlier day but spill over onto the day you're viewing.
Hide completed workflowsHide any run that's already been finished, so you only see what's still to do.
Log outSign out of your account.

Managers and admins see two extra options:

OptionWhat it does
Show workflow runs by tagSee every run for a single tag, with date filters.
Show workflow runs by teamSee every run for a single team, with date filters.

Admins see three more options:

OptionWhat it does
Add/Edit UsersAdd, edit, or remove users.
Add/Edit TeamsAdd, edit, or remove teams.
Adjust SettingsOpen the Settings screen to change account settings, including which menu items appear on mobile.

The two tag/team views and the three admin items can each be switched off in account settings, so an admin may choose not to show them.

Adjusting settings on mobile

Admins can open Adjust Settings from the menu to reach a Settings screen titled "Settings". Make your changes, then tap Save in the top-right corner. If you try to leave with unsaved changes, the app asks whether to discard them.

The settings here control how far ahead everyone sees work, how far back runs can be reset or reopened, chat permissions, who can see who completed each step, and which items appear on the mobile menu. The exact toggles are:

  • How many days into the future should everyone see workflows?
  • How many days into the past can everyone reset or reopen workflow runs?
  • Should everyone be allowed to mute individual chats?
  • Should everyone be allowed to block other users from DMs?
  • Should everyone see 'Run a workflow template' on mobile?
  • Should managers and admins see 'Show workflow runs by tag' and 'Show workflow runs by team' on mobile?
  • Should everyone see 'Reset this workflow run' on mobile?
  • Should managers and admins see 'Delete this workflow run' on mobile?
  • Should everyone see the 'Hide carried-over workflows' filter on mobile?
  • Should everyone see the 'Hide completed workflows' filter on mobile?
  • Should admins see 'Add/Edit Users' on mobile?
  • Should admins see 'Add/Edit Teams' on mobile?
  • Should admins see 'Adjust Settings' on mobile?
  • Should staff see who has completed workflow steps?
  • Should managers see who has completed workflow steps?

These are the same settings an admin can change on the web app, and a change saved on one shows up on the other.

The menu on a work card

Each work run card has its own menu, opened from the vertical three-dots icon down the right side of the card. The options inside depend on your role, on the state of the run, and on your account settings. The action sheet is titled "Work Options".

Everyone with access to the run can see these:

  • Message team about this workflow run: open the team chat for the run.
  • DM user about this workflow run: start a direct message about the run.
  • Reset this workflow run: clears every saved answer and reopens the run, so the team can do it again. Only shows when the run already has answers saved and is still inside its edit window, and only if your account has the reset option turned on. A confirmation appears before it clears anything.
  • Reopen this workflow run: removes the completion so a finished run goes back to in progress. Unlike Reset, your team's answers are kept. Only shows for a run that's already complete and still inside its edit window.

Managers and admins also see:

  • Delete this workflow run: removes the run entirely. Only shows if your account has the delete option turned on, and asks you to confirm first.

Help on the work screens

Two screens have an Info (ⓘ) button in the top-right of their header that opens a short explainer.

On the Work Items screen, the explainer is titled "About workflows". It shows a colour legend headed "Colours show work status" (a red dot for "Unfinished and late", an orange dot for "Finished late", and a green dot for "Finished on time") and a preview of the card menu options.

Inside a run, the help screen is titled "About workflow steps". It explains that the steps are the ones your managers built for you, shows the same colour legend, and previews the buttons at the bottom of the screen: open the team chat, chat with Pilla about the workflow, and Save your progress or mark the workflow complete.

Reading a work run

When you open a run, each step is a card. A few things on the card help you read it at a glance:

  • A step whose answer is required shows a * after its title.
  • A step that only appears once an earlier step is done shows a small arrow to its left, so you can see it was waiting on something before it.
  • A finished step shows a muted line at the bottom reading "Completed by {name} · {date} {time}". When several people ticked items on the same step, it reads "{N} people" instead, and you can tap the line to see who did what. This line only appears if your account is set to show staff or managers who completed each step; admins always see it.

Tips

  • Today's date is selected when you open the app. Scroll left to look back at earlier days.
  • The "finished/total" count under each date in the scroller tells you how much of that day's work is done before you even open it.
  • Pull down on the work list to refresh.
  • If a filter is on, the header shows "(filtered)" next to the date so you know the list isn't showing everything.
  • Running a template for a single team takes you straight to the new run. The back gesture returns you to Work Items.
  • Stories don't appear on the web app at all. They're a mobile-only feature.
  • If something looks wrong with your work list, check the menu. You might have a team filter or one of the hide filters turned on.

Filtering your work on mobile

Your main work list shows every workflow run for every team you belong to, on the date you're viewing. If you only care about one or two teams, or you want to skip work that spilled over from yesterday, you can filter the list. All the filters live in the menu on the bottom bar.

Open the filter menu

Every filter starts from the same menu. On your work list, tap the Menu button on the bottom bar (the one with the menu icon and the word "Menu" on the right-hand side). A list of options titled "Menu" slides up from the bottom.

The menu is a single list of options with no headings, and the filter options sit at the top of the list. Tapping any option closes the menu and applies your choice straight away. To change a filter again, reopen the menu; the icon next to each toggle shows whether it's currently on.

Filter by team

The team filter is the most common one. You pick which teams should appear in the list, and everything else hides.

  1. Tap Menu on the bottom bar.
  2. Tap Filter teams.
  3. The Filter Work Teams screen opens with a list of your teams.
  4. Tap a team to tick or untick it. Only ticked teams appear in your work list.
  5. To tick or untick everything at once, tap Select all or Deselect all in the top-right corner.
  6. Tap the back arrow in the top-left corner when you're done.

When you've turned some teams off, the title bar on your work list shows (filtered) next to the date so you don't forget a filter is on. The (filtered) label appears for any active filter, not just team filters. See "When the filtered label shows" below.

The team list only shows teams you belong to. You can't filter to a team you're not part of, and re-ticking every team turns the team filter back off.

Hide work that carried over from an earlier day

Some workflow runs span several days; they start on one date and finish on another. By default the work list shows you any run that's still active on the day you're viewing, even if it started earlier. If you only want to see runs that actually start on the date you're viewing, use this toggle.

  1. Tap Menu on the bottom bar.
  2. Tap Hide carried-over workflows near the top of the menu. The menu closes and the filter switches on.
  3. To turn it off again, reopen the menu and tap Hide carried-over workflows a second time.

The box next to Hide carried-over workflows shows a tick when the filter is on and an empty square when it's off, so you can always check its state when you reopen the menu. When it's on, any run that started before the date you're looking at is hidden.

Hide runs you've already finished

When a day fills up with completed runs, you can hide them so the list only shows what's still to do.

  1. Tap Menu on the bottom bar.
  2. Tap Hide completed workflows near the top of the menu. The menu closes and the filter switches on.
  3. To turn it off again, reopen the menu and tap Hide completed workflows a second time.

The box next to Hide completed workflows shows a tick when the filter is on and an empty square when it's off. When it's on, any run that's been marked complete drops off the list. Turn it off to see everything again.

Browse every run for one tag

If you group your runs by tag, like "cleaning" or "safety", there's a separate screen that shows every run for a single tag across a date range you choose. This is available to managers and admins, not to staff. It doesn't change your main work list; it opens its own screen.

  1. Tap Menu on the bottom bar.
  2. Tap Show workflow runs by tag further down the menu.
  3. The screen opens showing one tag's runs, titled with the tag name. Set a Start Date and End Date at the top to narrow the date range.
  4. To switch to a different tag, tap the dark Change Tag button on the bottom bar. The Filter tags screen opens with a list of every tag on your account.
  5. Tap the tag you want. The list narrows to that tag and you go back automatically.

There's a matching Show workflow runs by team option further down the same menu if you'd rather browse a single team's runs across a date range.

When the filtered label shows

The (filtered) label sits next to the date at the top of your work list. It appears whenever any of these is active:

  • A team filter (you've unticked at least one team)
  • Hide carried-over workflows is on
  • Hide completed workflows is on

It's the quickest way to spot that something is being hidden when your list looks emptier than expected. Browsing by tag or by team on their separate screens doesn't affect your main work list, so it doesn't turn the label on.

Where filters apply

This table covers the filters on your main work list and the two browse screens reached from the menu.

FilterWhat it changes
Filter teamsHides every team you've unticked from your work list.
Hide carried-over workflowsHides runs that started on an earlier day.
Hide completed workflowsHides runs that have already been finished.
Show workflow runs by tagOpens a separate screen listing one tag's runs across a date range (managers and admins).
Show workflow runs by teamOpens a separate screen listing one team's runs across a date range (managers and admins).

Filters only change what you see on your own device. They don't affect what other people see.

Tips

  • If your work list looks emptier than expected, open the menu and check whether a filter is on. The (filtered) label next to the date is the quickest tell.
  • The (filtered) label covers team filters, Hide carried-over workflows, and Hide completed workflows. Any of them switches it on.
  • The team filter stays on as you move around the app, and clears when you sign out. The two hide toggles reset the next time the app fully restarts.
  • Hide carried-over workflows is handy for managers; it stops long-running workflows cluttering up later days.
  • Your admin can hide the Hide carried-over workflows and Hide completed workflows toggles from the mobile menu in the account settings, so if you don't see them, they've been switched off for everyone.
  • Show workflow runs by tag and Show workflow runs by team only appear for managers and admins. Staff won't see them in the menu.

Completing a work run on mobile

Completing a work run is the main thing you do in the mobile app. You open a card, fill in each element, tap Save to send your answers to Pilla, then tap Mark Complete when everything's done.

Opening a work run

On the Work Items tab, tap any card in the work list. The card opens to the work run screen.

The work run screen shows you:

  • The title of the run at the top of the header
  • The team name as a subtitle under the title
  • A scrollable list of elements down the middle
  • A floating action bar at the bottom with three buttons

Use the back arrow in the top-left of the header to return to the work list. If you have unsaved changes, the app shows a "Discard changes?" popup with "Don't leave" and "Discard" before it lets you go.

Tap the Info (i) button in the top-right of the header to open the "About workflow steps" help screen. It explains the status colours each step uses (a red dot for "Unfinished and late", an orange dot for "Finished late", a green dot for "Finished on time") and what the buttons at the bottom of the screen do.

Filling in elements

Each element on the run is a question or instruction set up by the template author. Different element types look different on screen: a checklist has tickable items, a text element has a text box, a photo element opens your camera, and so on. For the full list of element types and how each one works, see the canvas docs on the web app side.

A required element has a small asterisk (*) after its title. On a phone almost every element is required, so you'll see the asterisk on most of them.

As you fill in elements, your answers are held on your phone until you send them. The bottom-right button changes to Save as soon as you make any change. Tap Save to send your answers to Pilla. Once they're saved, each answer you filled in moves into a "completed" state. You can fill in several elements and tap Save once for all of them.

Once a step is complete, the bottom of its card can show a muted line reading "Completed by {name} · {date} {time}", for example "Completed by Sam · 9 Jun 2026, 14:30". For a checklist that two or more people ticked, the line summarises them as "{N} people" and you can tap it to open a breakdown of who ticked each item and when. Whether you see this line depends on your account settings: admins always see it, and managers and staff see it only if your account has turned it on for them.

The Save and Mark Complete button

The bottom-right of the floating action bar holds a single button that changes label depending on the state of the run. When it's enabled it's dark navy. When it's greyed out it turns a pale grey and you can't tap it.

Button labelWhen you see itWhat it does
Starts 09:00 / Starts 31 MayBefore the run is due to start. Shows the start time for today or the date for a future day.Nothing; greyed out. You can't fill in or complete a run before it starts.
Not started yetBefore the run starts, when there's no start time to show.Nothing; greyed out.
SaveWhenever you've filled in or changed any element but haven't sent it yet. This is the normal step after filling things in.Sends your unsaved changes to Pilla.
1 step remaining / N steps remainingThe run has started but required steps are still unfilled, e.g. "3 steps remaining".Nothing; greyed out until every required step is in.
Pilla is checking...A step has a Pilla check that is still being judged.Nothing; greyed out until Pilla finishes, in case the result reveals more steps to do.
Skip the restEvery required step is done but some optional ones are still empty.Finishes the run early, leaving the optional steps blank. A "Skip the rest?" popup checks you mean it before it completes.
Mark CompleteEvery step, required and optional, has been filled in.Finishes the run.
Workflow completeThe run has already been finished.Nothing; greyed out. The run is done.

The button is greyed out until the run's start time has been reached and every required step has been filled in. Once you can tap it, it shows either Skip the rest (if optional steps remain) or Mark Complete (if everything's done). After you tap, the run closes and you go back to the work list, and the card updates to show the run is finished.

Chat about a work run from inside the run

The floating action bar on the work run screen has two round buttons to the left of the Save and Mark Complete button:

  • Chat bubble (left): opens the team thread for this run. A small number on the icon shows how many unread messages there are.
  • Crosshair (middle): opens Pilla, the AI assistant, for this run.

The team thread is the same one your manager sees, so questions, photos, and notes are kept together with the work.

See Adding workflow context to messages for the full guide to messaging about a run.

Swipe gestures on a work card

You can also start a conversation about a run without opening it. On the Work Items tab, swipe a card:

  • Swipe right: opens the team thread for this work run. Everyone on the team sees what you send.
  • Swipe left: opens a list of people so you can DM someone privately about this work.

Actions on a single run

To open the actions for a single run, tap the three-dots ellipsis icon down the right side of its card on the Work Items tab. There's no tap-and-hold. Everyone sees the icon, including Staff. The action sheet is titled "Work Options" and which options appear depends on your role, the run's state, and your account settings:

ActionWhen it showsWhat it does
Message team about this workflow runAlways, for everyone.Opens the team thread for this run so everyone on the team sees what you send.
DM user about this workflow runAlways, for everyone.Opens a list of people so you can message someone privately about this run.
Reset this workflow runThe run has at least one answer saved, is still inside its edit window, and your account has the reset option turned on.Clears every saved answer on the run and reopens it, so the team can do it again. A "Reset this workflow run?" popup checks you mean it first.
Reopen this workflow runThe run is already complete, is still inside its edit window, and your account has the reset option turned on (the same toggle as Reset).Removes the completion so the run goes back to in-progress. Your team's answers are kept, and this is the difference from Reset.
Delete this workflow runManagers and admins only, and only if your account has the delete option turned on. Staff never see this.Deletes the run completely.

You can also reset a single element from inside the run. Each completed element card has a small Reset button (a circular-arrow icon) in its top-right corner. Tapping it removes that element's saved answer, useful for fixing a wrong answer without restarting the whole run.

What happens when you tap Mark Complete

When every required element is in and you tap Mark Complete (or Skip the rest if optional steps remain):

  1. The run is marked finished in Pilla
  2. The screen closes and returns you to the work list
  3. The card colour bar updates to green (or orange if the work finished late)
  4. The status at the top of the work list updates to match

If you tap the Reset button on an element of a run that's already finished, a "Reset element and reopen workflow run?" popup warns you that clearing the answer will reopen the whole run. If that element unlocks other steps you've already answered, the popup also tells you how many of those will be reset too. Confirm and the run goes back to in-progress.

Tips

  • Your answers aren't sent to Pilla until you tap Save. The button changes to Save as soon as you make a change, so tap it to lock your work in.
  • If the Mark Complete button is greyed out, scroll up; there's probably a required element you haven't filled in yet.
  • Swiping right on a card is the fastest way to ping the team about a run.
  • The back button warns you if you have unsaved changes, so you don't lose work by accident.

Triggering a workflow manually

Some workflows appear on your work list at scheduled times. Others are set up for you to start whenever you need them. Follow these steps to start one from your phone.

When to use this

Use these steps for a workflow template, the reusable workflow your team has set up, with Run manually selected. For example:

  • A safety check you only do when an incident happens
  • A one-off opening or closing routine for a special event
  • A spot check a manager wants the team to do today

If your template runs on a schedule instead, you don't need to do anything; the run will appear in the work list automatically.

Start a workflow from your phone

You need an active trial or subscription to start a workflow. If Pilla asks your company to set up billing, ask an Admin to choose a plan in the web app. Try starting the workflow again once the subscription is active.

  1. On the Work Items screen, tap Menu at the bottom
  2. Tap Run a workflow template
  3. Choose the template you want from the list
  4. Check the team list. Every team assigned to this template starts ticked. Tap any team you do not want to include to untick it
  5. Tap Run for 1 team or Run for 3 teams, for example. The number shows how many teams you have chosen

Where you land after tapping the button depends on how many teams you picked. If you picked a single team, the app takes you straight into the new run so you can start filling it in. The back gesture returns you to the Work Items screen. If you picked two or more teams, the app drops you back on the Work Items screen and the runs appear in the work list.

One run per team

Each team you tick gets its own workflow run, a separate copy of the workflow to fill in. So if you tick three teams and tap the button, three separate runs are created, one per team. Each team then sees their run on their own work list.

If you picked two or more teams and some runs fail to create, Pilla shows a popup titled Created X of Y with the message "Some teams couldn't run this template. Please try again for the ones that are missing." The runs that succeeded still go through, so try again just for the teams that are missing a run. If you picked a single team and it fails, Pilla shows a Could not run template popup and keeps you on the team picker so you can try again.

What you can see

The list on the Run a workflow template screen only shows templates that are:

  • Set up with a manual or external trigger (scheduled-only templates don't appear)
  • Saved on the canvas (a template that's still a draft won't show up)
  • Assigned to at least one team

If you're a staff member or a manager, you only see templates assigned to a team you belong to. Admins see every saved template on the account, whatever team it's on.

If you don't see a template you think should be there, check that you're on the right team, that the template has been saved on the canvas, and that its trigger is set to manual.

When there are no templates to run

If you've got no templates set up for manual triggering, the screen shows:

No workflow templates available to run. Templates with a manual or external trigger will appear here.

That's normal; it just means no one's set up a manual template yet. Templates are built on the canvas in the web app.

Set up a workflow you can start yourself

You start the workflow from the mobile app, but build its template in the web app. On the canvas, where you arrange the workflow steps, choose Run manually as the trigger. See Manual triggers for the setup steps.

Tips

  • The Select all / Deselect all button in the top-right of the team picker only shows when the template is assigned to two or more teams. When every team is ticked it reads Deselect all; tap it to clear them all, then tick just the ones you want. A template assigned to a single team has no such button.
  • The button at the bottom always shows the count: Run for 1 team, Run for 3 teams, and so on. Quick way to double-check before you tap. While the runs are being created it briefly reads Running....
  • The new runs appear on each team's work list right away. Tell them to refresh if they don't see it.
  • Can't find Run a workflow template in the menu? An admin may have switched it off. On the web app, the setting is Should everyone see 'Run a workflow template' on mobile? under account settings.
  • Manual triggers are perfect for routines you can't predict: emergencies, spot checks, special events.