Skip to main content
Tracking Progress

Task Statuses

Learn how task statuses are determined and what each colored status tag and its day count mean.

Overview

Task statuses show you at a glance where each task stands in its lifecycle. When you look at a task, you'll see a colored tag with a number. That tag tells you:

  1. How urgent the task is (indicated by the color)

  2. How much time you have (indicated by the number)

The system automatically calculates these statuses based on today's date and when the task is due, so you always see current information.

Understanding the Status Tags

Each status appears as a colored tag on your tasks. Here's what each one means and what you should do:

🔵 Upcoming (Blue Tag)

What it means: This task isn't ready to start yet.

The number: Shows how many working days until you can start this task.

Example: A tag that says 5 means you have 5 working days before you can start.

🟠 Startable (Orange Tag)

What it means: You should start this task soon or get it scheduled.

The number: Shows how many working days you have left before the deadline passes for starting.

Example: A tag that says 2 means you need to start within the next 2 working days to finish on time.

🟢 Active (Green Tag)

What it means: This is the final working day to work on this task.

The number: Shows how many working days left until the due date. A tag that shows 0 means it is due today.

Example: A tag that says 1 means the task is due tomorrow.

⚫ Pending (Gray Tag)

What it means: This task is past its due date, and the lot was last walked on an earlier day. It's waiting for someone to walk the lot and confirm whether the work is done. If the lot is walked today and the task still isn't marked complete, it turns overdue.

The number: Shows how many days overdue it is (negative number).

Example: A tag that says -3 means it's 3 days past due.

🔴 Overdue (Red Tag)

What it means: This task is past its due date and needs immediate attention.

The number: Shows how many days overdue it is (negative number).

Example: A tag that says -5 means it's 5 days past due.


How It Works

The system looks at three pieces of information to calculate each task's status:

  1. Today's date - The current day in your builder's time zone

  2. When you can start - The earliest date work can begin

  3. When it's due - The deadline for completion

  4. How long it takes - How many working days the task requires (doesn't include weekends)

Based on these dates, the system assigns the appropriate status and counts down the working days.

Important: The system only counts working days (Monday through Friday). Weekends and holidays don't count toward your deadlines.

Example: A 3-Day Task

Let's say you have a task due Friday, June 27, and it takes 3 working days:

Date

Status

Number

What This Means

Mon, June 23

Startable: 2

2 days left

You need to start by Wednesday to finish by Friday

Wed, June 25

Today: 1

1 day left

Final working day to get it done

Thu, June 26

Overdue: -1

1 day late

Missed the deadline, needs immediate attention

FAQ

Status depends on comparing task dates to today's date. As time progresses, business days remaining decreases, eventually moving the task through the status progression.

Your builder's calendar day, in the time zone set under Settings → General. Statuses and their day counts turn over at midnight in that time zone, never earlier in the evening. It is the same day lot walks and holds use, so a lot walked today keeps its late tasks overdue rather than pending until midnight, and a task due today reads 0, not a day late. The TPTM website, reports and the trade partner portal all show the same statuses, and the field app shows them too once it has synced. See General Settings and Time Zone.

Day counts in a status ignore both weekends and holidays. If it is the Thursday before a 3-day weekend, then a task due on Tuesday will be due in two days instead of three.

No, tasks follow the progression: upcoming → startable → today → pending/overdue. Once today is reached, the next status depends on whether the lot was recently walked.

A past-due task's status depends on when the lot was last walked:

  • Walked before today: the task shows as pending until someone walks the lot and confirms whether the work is done.

  • Walked today: if the task still isn't marked complete, it shows as overdue.

  • Never walked: the task shows as overdue straight away. There is no earlier walk to wait on.

Monday through Friday. Weekends don't count. Holidays specific to your builder also don't count.

The system knows about holidays for your builder. When a schedule is built, tasks are never placed on a holiday. If a holiday is added later and work already sits on it, nothing moves on its own: Settings → Holidays shows a banner counting the affected lots, with a button to move their schedules off the holiday.

It means the task is an inspection. Inspection tasks get a small red circle with a white ! on the top-right corner of their status tag. The tag's colour and number still show the status and day count, the same as for any other task. It is the same mark shown next to Inspection in the Status legend.

You see it on a lot's task list on the TPTM website, on the On Site List you open by scanning a lot's QR code, on the Task List and Tasks by Lot reports in the trade partner portal, and in the field app on a lot's task list and when you open a task. The Community Tasks Report leaves the mark off, and a lot's printed task list shows no status tags at all.