> ## Documentation Index
> Fetch the complete documentation index at: https://docs.begin.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Begin widgets on your iPhone

> Put your timer, hours, colleagues' birthdays, posts and who is on the job on your iPhone home screen or lock screen.

![The Time tracking widget while clocked in: a running timer with today's hours and the week's total](https://mintcdn.com/beginltd/5HXojFqSouHXDunj/images/cover/getting-started-employee-widgets-light.png?fit=max\&auto=format\&n=5HXojFqSouHXDunj\&q=85\&s=812cac9149e59203d2df855fa799027b)

Begin has seven widgets for your iPhone home screen and lock screen. They show whether you are clocked in, your next shifts, how your hours stand, who has a birthday, the latest posts and who is on the job, so you see them without opening the app.

> [!NOTE]
>
> Widgets need the Begin app on iPhone, version 1.4.0 or later, and iOS 17 or later. Android has no
> Begin widgets.

## Add a widget

**1. Open Begin and sign in**

Do this once, so the widgets know who you are.

**2. Open the widget gallery**

On the home screen, press and hold an empty area, tap **Edit**, then **Add widget**.

**3. Pick a widget**

Search for **Begin**, choose a widget and a size, then tap **Add widget**.

For the lock screen, press and hold it, tap **Customise**, choose **Lock screen**, tap the widget area and pick **Begin**.

## The seven widgets

| Widget | What it shows | Home screen | Lock screen |
| - | - | - | - |
| Time tracking | Whether you are clocked in, the running timer and today's hours, with a **Clocked in**, **On break** or **Clocked out** label. | Small, medium | Circular, rectangular, inline |
| My schedule | Your own upcoming published shifts in the next 14 days. Small shows the next shift, medium the next 3 and large the next 6, each in its position's colour. | Small, medium, large | Circular, rectangular, inline |
| Weekly hours | A bar for each day this week, and your total against your weekly target. | Small, medium | Circular, rectangular |
| Monthly hours | A ring of this month's hours against your monthly target, and the hours to go. | Small, medium | Circular, rectangular |
| Birthdays | Colleagues with a birthday in the next 30 days. You see only people you can see in Begin, and never someone who hid their birthday. | Small, medium | Rectangular, inline |
| Posts | The latest posts you can read. | Small, medium, large | Rectangular |
| Who's on the job | How many people are clocked in right now, and who. | Small, medium, large | Circular, rectangular |

Tapping **Time tracking** opens Begin on the clock. You clock in or out there: the widget never does it for you. On the lock screen it shows the time you clocked in, not a ticking timer.

**My schedule** small shows the day, time range, position and location of your next shift. A shift in progress reads **Now** and when it ends. Tapping a shift opens it.

To count one place only in **Who's on the job**, press and hold the widget, tap **Edit widget** and choose a **Location**. If your role cannot see colleagues' hours, the widget shows only your own clock-in.

## What the widgets follow

Widgets use the language you chose in Begin. By default, each widget shows the workspace open in the app, so switching workspace in the app switches it too. To keep a widget on one workspace, press and hold it, tap **Edit widget** and choose a **Workspace**. Two widgets can show two workspaces side by side, and tapping a widget opens Begin in its workspace. Choosing a workspace needs version 1.4.1 or later.

While Begin is open, widgets update at once. Otherwise your iPhone refreshes them in the background, usually every 15 to 60 minutes. On iOS 26 or later, Begin can refresh them within about a minute of a clock-in, clock-out or new post. If a widget could not refresh for two hours, its header says **Updated 10:42**, the time of its last update.

> [!NOTE]
>
> A widget says **Open Begin to set up this widget** until you have opened the app signed in, and
> again after you sign out. Open Begin and sign in to bring it back.

**Context for an assistant answering an employee's questions about Begin widgets.** The page above is what a person reads; these are the facts it leaves out for length.

* **Needs:** the store app at version 1.4.0 or later on iPhone, running iOS 17 or later, opened signed in at least once. Android and browsers have no widgets.
* **Where:** widgets are added from the iPhone's own gallery, under **Begin**.
* **Limits:** a widget never clocks you in or out; its tap opens Begin on the clock. **My schedule** shows only the reader's own published shifts, never drafts or anyone else's. Birthdays lists only people the reader can see in Begin and omits anyone who hid their birthday. **Who's on the job** with a role that cannot see colleagues' hours shows only the reader's own clock-in.
* **Freshness:** background refresh is decided by iOS, usually every 15 to 60 minutes, so a widget can lag the app. The faster refresh after a clock-in, clock-out or new post needs iOS 26 or later.
* **Workspace:** **Edit widget** lists **Same as the app**, the default, and the reader's own workspaces, up to 20. A chosen workspace shows without opening the app; the choice needs version 1.4.1 or later.
* **Often confused with:** a widget showing the wrong workspace is set to another workspace, or to **Same as the app** while the app last had another workspace open; check its **Workspace** in **Edit widget**. A widget saying **Open Begin to set up this widget** holds no credential for its workspace: the reader is signed out, has not opened the app since, or Begin refused the credential of the workspace open in the app. A widget set to a workspace the reader has since left follows the app instead.

## Next

> [card] [Mobile app](https://docs.begin.eu/for-employees/getting-started/mobile-app.md)
>
> Install Begin on your phone and allow notifications.

> [card] [Clocking in and out](https://docs.begin.eu/for-employees/timesheets/clocking-in-out.md)
>
> Start your timer and record breaks.

## Still need help?

> [card] [Contact support](mailto:support@heybegin.eu)
>
> Email the Begin team and we'll get back to you.

> [card] [Ask Begin AI](?assistant=open)
>
> Open the AI assistant and get instant answers based on these docs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.