# iOS Widgets

Ellie supports 3 different types of widgets on iOS so you can quickly see things like tasks/calendar events at a glance. They work on both iPhone and iPad!

## The task widget

<figure><img src="/files/1TfwATaijahmqvzCTIRN" alt=""><figcaption><p>The task widget</p></figcaption></figure>

The task widget lets you quickly see your incomplete tasks. You can choose to show tasks from:

1. Today
2. The Braindump
3. Any list

To switch which between lists, hold down the widget -> click edit and you should see a dropdown of different lists to choose from.

<figure><img src="/files/JBF9RPmjWu2LPfxnAMyb" alt=""><figcaption><p>iOS widget list settings</p></figcaption></figure>

## The calendar widget

The calendar widget shows you upcoming events from your timebox/calendar on your homescreen.

We pull both calendar events and timeboxed tasks into the widget!

<figure><img src="/files/KtBxaHWRHa9HyZucaHH8" alt=""><figcaption><p>The Ellie calendar iOS widget</p></figcaption></figure>

## The "Todos left" widget

This is a small fun widget meant to give you a gentle reminder about how many tasks you have left for the day.

As the day goes on, the widget and Ellie (the hamster the app is named after) slowly change depending on how many tasks and time there are left in the day.

<figure><img src="/files/dHblAodWhm7qUqAskEq1" alt=""><figcaption><p>The "Todos Left" widget</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.ellieplanner.com/features/iphone-ipad-app/ios-widgets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
