Reading what needs attention

What each warning on the Organization page means, how it is worked out, how warnings add up on a collapsed branch, and how to use the Needs attention lens.

For: People with the Executive or People manager ability · Last updated

The Organization page marks the places where work is waiting or something is missing. Each mark belongs to a Coworker or a person, with an icon, a word and a short sentence about the work, such as Alert: 3 reviews waiting, oldest 9 days. The wording is about the work, never about the person.

Who can see it#

People with the executive ability (Executive (view-only)) or the people_manager ability (People manager) see the marks and the Needs attention lens. Someone who holds only the admin ability sees the chart without them.

An Executive sees the warnings for the whole organization. A People manager sees them for their own branch only: themselves and everyone below them in the reporting lines. The count on Needs attention (4), the banner and the marks on cards cover that branch; cards above you and in other branches carry none.

Warnings and alerts#

A mark is either a Warning or an Alert (an alert is the more urgent of the two). The word is written on the mark, and each has its own icon: a circle for a warning, an octagon for an alert. Some marks only give counts and flag nothing; for example, a Coworker with a few ratings shows its thumbs-up and thumbs-down counts without a warning.

The time thresholds, for reviews waiting and feedback to review, start at 7 days for a warning and 14 days for an alert.

Where the marks appear#

  • In the Needs attention lens, in Reporting lines, a person's card shows one chip with the number of warnings in their branch, such as 3 warnings (hover over or focus it to read the whole count, such as 3 warnings, 1 of them an alert), and a Coworker's tile under its Supervisor shows a warning icon when it has a mark. The marks themselves, in full sentences, are in the person's details (select their card) and on each Coworker's row when its Supervisor's tray is shown in full. The Chart only lens shows none of these marks. In the Needs attention lens a banner under the controls reads Needs attention with the number, a one-line summary and a Show only these button.
  • Needs attention is a Reporting lines lens: it is about people and Coworkers, so its button (which shows the number, such as Needs attention (4)) is not listed under Units and roles. If you switch to Units and roles while it is chosen, the chart shows Chart only. It lists every flagged mark in the banner. Each line is a link: select it and the chart opens the branch that holds that card, selects the person or Coworker so their details open beside the chart, and moves the chart so the card sits in the middle, with a brief ring around it. Flagged branches come first among their neighbors, and cards with nothing flagged sit flat so the flagged ones stand out.
  • Show only these hides every card with nothing flagged in it; Show everyone brings them back.
  • On a phone, the outline rows show the warning count and a warning icon on each flagged Coworker, and each person's own page has the marks in full in the Warnings, use and time saved card.

Changing the thresholds for your own view#

In the Needs attention lens, the banner lists the five most urgent marks, alerts first; select Show all to list every one and Show fewer to go back. Select Change when things are flagged to open three fields: Warn when reviews or feedback wait (days), Alert when they wait (days) and Flag a branch below (% who used a Coworker). Select Apply to use them, or Reset to 7, 14 and 50% to go back to the starting values. The alert needs at least as many days as the warning. Your thresholds apply to the page while you have it open; they are not saved and do not change what anyone else sees.

The kinds of marks#

Reviews waiting#

Workflow steps waiting for someone to approve or reject them. A waiting review appears on:

  • the Coworker that started the workflow, when a Coworker started it;
  • otherwise the person named as the reviewer on that step;
  • otherwise the person the workflow was run for.

The mark shows how many are waiting and how long the oldest has waited, such as 3 reviews waiting, oldest 9 days. It becomes a warning when the oldest has waited 7 days, and an alert at 14 days. Reviews that are tied to nobody on the chart are counted in a line under the banner's list.

Feedback to review#

Feedback on a Coworker's replies that is waiting for a review decision: every thumbs-down, and every thumbs-up that carries a flag, that has no marker from the Supervisor's guided review. Once an item has a marker it no longer counts, however old it is; until then it stays on the Coworker. The mark shows how many items are waiting and how long the oldest has waited, such as 4 feedback items to review, oldest 9 days. It becomes a warning when the oldest has waited 7 days, and an alert at 14 days. The mark gives counts only: it never shows the comments or who gave the feedback. Proposed Coworkers and Coworkers in the Sunset phase have no mark.

Thumbs up and down#

The ratings people gave a Coworker's replies in the last 30 days, such as 18 up · 2 down. The counts always show. The share of thumbs-up (90% up) shows only once there are at least 5 ratings, and the mark becomes a warning when fewer than 70% are thumbs-up. With fewer than 5 ratings the counts show and nothing is flagged, because a handful of ratings says little.

No Supervisor#

A Coworker with no Supervisor assigned. This is always a warning. These Coworkers are listed in the Needs a Supervisor card under the chart.

Low use of Coworkers#

For each manager's branch (the manager and everyone who reports to them, at any depth), how many people with an account used any Coworker in the last 30 days. When fewer than half did, the manager's card gets a warning such as 1 of 3 people used a Coworker in the last 30 days. People who were invited and have not signed in are not counted, and neither are people whose access was removed. You can change the share with the thresholds above.

Collapsed branches#

A manager's card shows how many warnings and alerts are inside their branch, even when it is collapsed: their own, those of everyone below them, and those of the Coworkers those people supervise. Open the branch, or select the card to read the details, to see where each one is.

No minimum group size#

Every mark is shown whatever the size of the group, including a branch of one or two people.