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

# Mobile Home Screen Widgets

> Add the Rootly on-call widget to your iPhone or Android home screen to see your on-call status, shift times, and schedules at a glance.

## Overview

The Rootly mobile app includes a home screen widget that shows your on-call status without opening the app. At a glance you can see whether you're on call right now, when your current shift ends or your next one starts, and which schedules you're covering.

The widget is available on **both iOS and Android**, in several sizes.

<Note>
  This page covers the widget you add to your phone's home screen. For the on-call status card in the Rootly web app's sidebar, see [On-Call Widget](/on-call/on-call-widget).
</Note>

<Frame caption="The small widget while you're on call">
  <img className="mx-auto" style={{ width:"38%" }} alt="Rootly home screen widget with a green background reading You're on-call, showing an avatar and a Shift ends at time" src="https://mintcdn.com/rootly/eargET4fnjvDVa-H/images/on-call/mobile-widget-small.webp?fit=max&auto=format&n=eargET4fnjvDVa-H&q=85&s=1d44a2ec04e5271f28ec847e23c91ba4" width="473" height="533" data-path="images/on-call/mobile-widget-small.webp" />
</Frame>

***

## What the widget shows

The widget always reflects **your own** on-call status — not your team's. It has three states:

| State                      | Appearance | When you see it                                 |
| -------------------------- | ---------- | ----------------------------------------------- |
| **You're on-call.**        | Green      | You're currently on a shift                     |
| **You're always on-call.** | Green      | You're on an escalation policy with no rotation |
| **Not on-call.**           | Grey       | You have no active shift                        |

Alongside the status, the widget shows:

* Your Rootly avatar
* **Shift ends at** when you're on call, or **Shift starts at** for your next upcoming shift
* **Always on-call for N Escalation Policies** when that applies
* The names of the schedules you're on call for, and an **N more shifts** row when there are more than fit

<Frame caption="The widget when you're not on call">
  <img className="mx-auto" style={{ width:"38%" }} alt="Rootly home screen widget with a grey background reading Not on-call, showing an avatar and a Shift starts at time for the next shift" src="https://mintcdn.com/rootly/eargET4fnjvDVa-H/images/on-call/mobile-widget-off-call.webp?fit=max&auto=format&n=eargET4fnjvDVa-H&q=85&s=d14c6d7d051ef631e6615ed1888b1e23" width="473" height="532" data-path="images/on-call/mobile-widget-off-call.webp" />
</Frame>

***

## Widget sizes

All three sizes show your status and either a shift time or, when you're always on call, the **Always on-call for N Escalation Policies** summary. The larger sizes add a list of schedules — the ones you're currently on call for, or the ones your upcoming shifts are on when you're off call — and anything that doesn't fit collapses into an **N more shifts** row.

| Size       | What it shows                                                                        |
| ---------- | ------------------------------------------------------------------------------------ |
| **Small**  | Your status and a single shift time or always-on-call summary, with no schedule list |
| **Medium** | Adds the schedule list                                                               |
| **Large**  | The same list, with room for more entries before they collapse                       |

On iOS you pick the size when you add the widget, and you can add more than one. On Android there's a single widget you can resize on the home screen — it switches between the layouts above as you make it bigger or smaller.

<Frame caption="A larger widget listing the schedules you're on call for">
  <img className="mx-auto" style={{ width:"70%" }} alt="Rootly home screen widget showing a shift end time, the schedules Platform Team, DevOps Team, and Payments On-Call, and a 2 more shifts row" src="https://mintcdn.com/rootly/eargET4fnjvDVa-H/images/on-call/mobile-widget-schedules.webp?fit=max&auto=format&n=eargET4fnjvDVa-H&q=85&s=47dd676bb7a015dda3f6992885f3b069" width="900" height="745" data-path="images/on-call/mobile-widget-schedules.webp" />
</Frame>

When you're off call, the same space lists the schedules your upcoming shifts are on instead.

<Frame caption="A larger widget while you're off call, listing upcoming shifts">
  <img className="mx-auto" style={{ width:"70%" }} alt="Rootly home screen widget with a grey background showing a shift start time, upcoming schedules Platform Team, DevOps Team, and Payments On-Call, and a 7 more shifts row" src="https://mintcdn.com/rootly/eargET4fnjvDVa-H/images/on-call/mobile-widget-upcoming.webp?fit=max&auto=format&n=eargET4fnjvDVa-H&q=85&s=4dc98078946b379e675a8cbbbbd5f544" width="900" height="745" data-path="images/on-call/mobile-widget-upcoming.webp" />
</Frame>

***

## Add the widget

<Tabs>
  <Tab title="iOS">
    <Steps>
      <Step title="Enter edit mode">
        Touch and hold an empty area of your home screen until the app icons jiggle, then tap **+** — or **Edit → Add Widget** on newer iOS versions — in the top-left corner.
      </Step>

      <Step title="Find Rootly">
        Search for **Rootly** and select it. The widget is listed as **On-Call Widget**.
      </Step>

      <Step title="Choose a size and place it">
        Swipe between the small, medium, and large previews, tap **Add Widget**, then drag it where you want it and tap **Done**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Android">
    <Steps>
      <Step title="Open the widget picker">
        Touch and hold an empty area of your home screen, then tap **Widgets**.
      </Step>

      <Step title="Find Rootly">
        Scroll to **Rootly** and touch and hold the widget preview.
      </Step>

      <Step title="Place and resize it">
        Drag the widget onto your home screen. Touch and hold it, then drag the handles to resize — the layout adapts as it grows.
      </Step>
    </Steps>

    Steps vary slightly between Android manufacturers and launchers.
  </Tab>
</Tabs>

***

## Requirements

* Rootly mobile app **2.0.0 or later** — see [Mobile App](/on-call/mobile-app) for download links and supported operating systems.
* You must be signed in to the app. Open Rootly at least once after adding the widget so it has your schedule data — until then it appears empty.
* An on-call seat, like all mobile app functionality.

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I choose which organization the widget shows?">
    No. The widget follows whichever organization is currently selected in the app. If you switch organizations, the widget shows the one you switched to.
  </Accordion>

  <Accordion title="My widget is empty. What's wrong?">
    The widget needs data from the app. Make sure you're signed in, then open Rootly and go to the home screen. If it stays empty, remove the widget and add it again.
  </Accordion>

  <Accordion title="Can I make the widget open a specific screen?">
    No. Tapping the widget opens the Rootly app. There are no buttons or tappable areas within the widget itself.
  </Accordion>

  <Accordion title="Is there a Lock Screen widget?">
    No — the widget is for your home screen only. While your alert notifications are muted, Rootly does show a countdown outside the app — a Lock Screen Live Activity on iOS, an ongoing notification on Android — but that's a separate feature. See [Alert Muting](/on-call/alert-muting).
  </Accordion>

  <Accordion title="Can I add more than one widget?">
    Yes. You can add several widgets in different sizes, but they all show the same account and the same on-call status.
  </Accordion>

  <Accordion title="Does the widget show alerts, incidents, or when I've been paged?">
    No. It shows your on-call status and shifts only — it doesn't change when a page arrives. For alerts and incidents, open the app, where you'll also see a **You've been paged** card. The [On-Call Widget](/on-call/on-call-widget) in the web sidebar does show a paged state.
  </Accordion>
</AccordionGroup>

***

## Related Pages

<CardGroup cols={3}>
  <Card title="Mobile App" icon="mobile-screen" href="/on-call/mobile-app">
    Download, sign in, and set up push notifications for on-call responders.
  </Card>

  <Card title="On-Call Widget" icon="table-columns" href="/on-call/on-call-widget">
    The equivalent status card in the Rootly web app's sidebar.
  </Card>

  <Card title="On-Call Shifts" icon="clock" href="/on-call/on-call-shifts">
    How shifts, rotations, and overrides determine what the widget shows.
  </Card>
</CardGroup>
