Record a Break for a Team Member

Changelog:

• v3 (April 24, Turn 27): Flag 24 enrichment. Full three-state color semantics (Red/Green/Blue) with explicit Blue-means-completed behavior. Added the second tracking method (On the Layout via name press, in addition to the existing On the Lineup via Break Manager). Default rule added to Before You Start (5+ hour shift gets one 30-minute break). New gotcha for "no break indicator showing at all." Source: kb.oneclickapp.com Breaks article uploaded Turn 26.
• v2 (April 24, earlier): Upgraded from scaffold to Alpha-verified for in-shift indicators; April 23 walkthrough resolved red-to-green toggle behavior and button-press-to-button-press timing.
• v1: Initial scaffold.

---

At a glance

Recording a break marks the time a team member is off the floor during their shift. OneClick uses a three-state color system (Red, Green, Blue) with matching indicators on both the Shifts layout and the Lineup, so leaders can scan the team and advance breaks with one press. For reviewing or editing breaks after the shift, see Use the Break Report.

Before you start

1. You need a role with permission to record breaks. [VERIFY: exact permission label.]
2. The team member must be clocked in or scheduled for a shift in progress.
3. Know your store's break rules. The default rule OneClick applies is a single 30-minute break for any shift of five or more hours. Stores can customize shift length, multiple breaks, break length, and rest periods through support tickets. Break rules in OneClick are configured per your store's request rather than enforced automatically by the product, so your store's policy is the governing rule. See Understand Break Rules and Compliance.
4. For team members under 18 or otherwise subject to labor-law break requirements, OneClick tracks what it has been configured to track, but compliance itself is your responsibility. See Understand Break Rules for Complex States for templates covering CA, CO, FL, OR, NJ, NY, UT, and WA.
5. Estimated time: under thirty seconds per break.

The three-state color system

Before the steps, the color system: every team member's break indicator follows a three-state cycle.

1. Red. Has not taken break. Indicator appears as a red bar or a red-background icon on the layout card; on the Lineup, time-stamp badges (like "30m" or "10m") appear with a red background.
2. Green. On break. Indicator turns green with a running-man icon and starts a countdown timer showing elapsed break time.
3. Blue. Break taken. Indicator turns blue once the break is complete.

Clicking the indicator advances through the sequence in order. For team members with multiple breaks configured, the sequence cycles to the next break after completing the first.

Steps

You can record a break in one of two places. Both produce the same result; pick whichever surface is closer to what you are already looking at.

Option A: On the Layout

1. Open the current shift on the Shifts screen.
2. Find the team member on the layout view. A team member due for a break shows a red indicator on their name card.
3. Click or tap the team member's name. The indicator advances from red to green; the countdown timer starts.
4. When the team member returns from break, click the name again. The indicator advances to blue (break complete) or to the next red segment if another break is configured.
5. You should now see the team member's card reflect the current state on the Shifts layout.

Option B: On the Lineup

1. Open the current shift on the Shifts screen.
2. Click Break Manager on top of the right lineup column. The lineup reorganizes to show break progress for every team member.
3. Find the team member's card. Each card shows up to three time-stamped break boxes (for example, 10m, 30m, 10m) colored red, green, or blue according to current state.
4. Press the break box to advance. Red boxes press forward to green (starting the break); green boxes press to blue (ending the break).
5. You should now see the team member's card reflect the current state on the Lineup, and the same state is visible on the layout view.

Video

Video coming soon.

Common gotchas

The break duration recorded is different from how long the team member was actually on break.

Break duration is measured from the moment the break button is pressed to the moment it is pressed again, not from clock-out to clock-in. If a team member took a full 30-minute break but the end-break button was pressed 29 minutes in, the system records 29 minutes. If you need to correct the recorded time after the fact, use the Edit function in the Break Report. See Use the Break Report.

I forgot to end a break and now the team member shows a huge amount of break time.

The timer keeps running until the break is ended, so a forgotten end can produce hundreds or thousands of minutes of recorded break time. Open the team member's profile, click Breaks, expand the shift in question, and Edit the break duration to the correct number of minutes.

I forgot to start a break that the team member actually took.

The in-shift break indicators are for real-time use. If a break was missed entirely, record it retroactively through the team member's profile. Go to their profile, click Breaks, expand the shift, and add or edit the break.

A team member's card shows no break indicator at all.

This usually means the team member's scheduled shift is shorter than the configured break threshold. The default rule is a single 30-minute break for shifts of five or more hours; shorter shifts do not display an indicator because no break is due. If the shift is long enough and the indicator is still missing, check the team member's break-rule configuration (some stores customize by age, position, or shift pattern).

A team member decided not to take a break. How do I record that?

You can advance their indicator through the stages anyway (red to green to blue) to close out the break without it actually happening, if the store cares about break reporting staying clean. Or you can skip them entirely; the next shift reload resets the indicator.

I accidentally started a break for the wrong team member.

If break reporting is important for your store, open the team member's profile, go to Breaks, expand the shift, and Edit to remove or correct the record. If break reporting is not crucial, you can cycle the indicator through its stages (green to blue, then click again to reset to red).

Do team members clock in and out with the breaks?

No. Clock-in and clock-out use your regular clocking system (HotSchedules, a POS clock, or similar). OneClick Breaks are leader-tracked only; team members can view their own break status if they download and sign into the OneClick App.

A team member has multiple breaks in their shift and I am not sure which one I just recorded.

For team members with multiple breaks configured, clicking the indicator cycles through each break in order. If you are unsure which one you just started or ended, open the Break Manager on the Lineup to see all three time-stamped boxes at once and which one is currently green.

A minor team member's required break was not flagged by the system.

OneClick tracks break rules that have been configured per your store's request. It does not automatically enforce labor-law break requirements for minors unless the rules for that store have been set up to track age-based requirements. Your store's scheduling and management practice should carry the compliance responsibility. See Understand Break Rules and Compliance.

Two team members went on break at the same time and coverage is thin.

The Shifts screen shows current break status across the team via the indicators. Watch for multiple green (on-break) indicators at once on key positions, and stagger breaks to maintain coverage. OneClick does not automatically prevent coverage gaps.

Related articles

1. Understand Break Rules and Compliance (Reference)
2. Use the Break Report (How-To). Post-shift review, edits, filtering, and export.
3. Understand Break Rules for Complex States (Reference). Templates for CA, CO, FL, OR, NJ, NY, UT, WA.
4. Understand the Shifts Screen (Reference)
5. Understand Permission Levels (Reference)
6. Request a Permission Change (How-To). Use this if you need break-recording permission and do not have it.

Still stuck

If the break indicator does not respond, a break cannot be started or ended, or recorded breaks do not appear in the Break Report, submit a support ticket with your store number, the date and shift, the team member's name, and a screenshot of what you are seeing.

Support typically responds within one business day.

---

Pre-publish checklist status

76 b8710865-f5e6-4aad-b54b-6c383e99952c complete All seven sections filled.

77 3c4d02b3-5135-4232-a5b5-615882dc6460 complete At a glance within template spec.

78 01657a41-4dae-4f8f-9089-9ddff973075b complete Final step is a confirmation step (per option).

79 19bd281b-f5ba-4463-9ed2-daabeb7a5ff0 complete No em dashes, no hedge words, permission-based role references.

80 713a144a-e9f8-491f-9ddb-d229db7fa064 complete Voice: leader as actor; operator phrasing absent.

81 09c0c9b6-eebf-4278-acb6-b993294eb968 complete In-shift indicator behavior verified against April 23 walkthrough (v2) and cross-checked against kb.oneclickapp.com source (v3).

82 2ec2f644-795f-4fe2-8fe0-c1f108d6bb24 complete Flag 24 enrichment: three-state color system (Red/Green/Blue) documented explicitly; two tracking methods (Layout and Lineup) both covered; default rule (5+ hour shift = 30-min break) in Before You Start; "no indicator" gotcha added.

83 6b43dc81-6646-4de1-b836-1eded6c86d59 complete Related article links activated.

84 4c03cf37-d3f9-4996-81ed-a3e9a6eb3873 incomplete UI verified against Production.

85 4ce0a635-efe2-4432-aa62-e2aa7e5295d9 incomplete Screenshots to be inserted at decision points (Red/Green/Blue states on both Layout and Lineup, Break Manager toggle on Lineup, team member profile Breaks tab for edit path).

86 7079cdd7-8a67-4e52-9796-cfe94381a1ce incomplete Remaining VERIFY block resolved (exact permission label).

87 8fe05dfa-6fbc-4bfe-9d04-7604b40536e4 incomplete Reviewed by Jared and Kevin.