---
title: Widgets and sharing (Android)
description: Put today's tasks and appointments on the Android home screen, act on a task from the widget, capture a new task with one tap, and share text from other apps into today's note.
reviewed: 2026-10-28
---

## Android only {#android-only}

Everything in this chapter exists in the Android app only - in the Google Play version and in the
version without Google. Windows and Linux have no widgets and no share target.

tagwerk brings two home-screen widgets:

| Widget | Size | What it does |
|---|---|---|
| *tagwerk - Today* | 4 x 2 cells, resizable | Lists overdue tasks, today's appointments and today's tasks. A tap on a row opens a card for that task or appointment. |
| *tagwerk - New task* | 1 x 1 cell | One tap opens today's note with a new task line. |

The plain *Today* widget, the card, *New task* and sharing are free. Setting up what a *Today*
widget shows is part of [tagwerk Pro](../pro/index.md).

## Adding a widget {#add}

1. Long-press an empty spot on the home screen and choose the launcher's widgets.
2. Find tagwerk and drag *tagwerk - Today* or *tagwerk - New task* onto the home screen.
3. Depending on the launcher, tagwerk opens the new widget's settings right away. Without Pro you
   only close them again; the widget shows its default view.

Two settings apply to all widgets and are in *Settings → Home screen & system*:

- *Appearance*: *System*, *Light* or *Dark*, independent of the app's own appearance. With
  *System* the widgets follow a switch of the phone's dark theme a few seconds later when it is
  switched by hand, and at the start and end of a custom schedule; with *Sunset to sunrise* they
  follow at their next redraw, or when tagwerk is opened.
- *On the home screen* lists every placed *Today* widget with a short summary. Tap one to set it
  up. *No widgets yet. Place one from the home screen, then it can be set up here.* means there
  is none.

## The Today widget {#today}

Without any setup, the widget shows the profile that is open in the app, in this order:

1. **Overdue tasks** from earlier days, in amber.
2. **Today's appointments**, time first. Appointments whose time has passed drop off.
3. **Today's open tasks**, high priority first, then normal, then low.

A fine line separates these blocks. The title row names the day and, on the right, counts the
overdue tasks (`▲ 3`).

What a row shows:

- A task starts with an empty box; a task in progress (`[/]`) with a half-filled one. The box is
  amber for high priority, green for normal and blue for low.
- A task with sub-tasks shows how far its checklist has come, such as `2/4`.
- Tags and contacts are coloured as in the app. Bold, code and struck-through text are drawn, not
  spelled out.

With nothing left to do, the widget says *No open tasks.*

On Android 12 and newer the list scrolls. On older versions the widget shows a fixed number of
rows and ends with `+n` for the rest.

**Where a tap leads:** a row opens the [card](#card) for that task or appointment. The title row
and empty space open the app on today - on a widget set to a profile, in that profile.

**How it stays current:** the widget is updated whenever a note changes and again at midnight. If
the app has not been opened for a while and the widget has no data for the current day, it says
*Open the app to refresh*. Overdue tasks are still shown, because they stay overdue whatever the
day.

**Several days:** a widget set up to show more than one day, or to start on a later day, puts a
heading over each day with its date and how far off it is, such as *in 2 days*. The overdue tasks
stand under *Overdue*.

## The card behind a row {#card}

A tap on a task row opens a card over the home screen. You can finish the task there without
opening the app.

- At the top: the task as the row showed it, its day, and the first lines of its description. The
  arrow unfolds the full description; a long press copies it. Links in it can be tapped.
- *Done*, *Drop* and *In progress* set the task's state in the note. Where two tags or more wait
  for a reading, *Enter readings only* joins them, and the four stand two by two
  ([Readings](../tags-and-search/index.md#readings)).
- *Move to day* offers *Today*, *Tomorrow*, *Day after tomorrow* and the same weekday next week.
  *Another day* opens every day of the coming week, then *14 days*, *1 month*, *3 months*,
  *6 months* and *1 year*, and *Another date...* for any date. *Back* returns to the card.
- *Open in app* opens the task's day in the app.

The card writes the note directly. If the task was changed or moved in the meantime, the card
says so and changes nothing, for example *This task has already been done.* If only the wording
changed, it shows the new text and offers *Continue with this task*.

Ticking off, dropping, moving and repeating follow the same rules as in the app; see
[Tasks](../tasks/index.md#ticking).

### Sub-tasks on the card

A task's checklist stands on the card under the description. Tap a sub-task to tick it off, tap
again to open it again. The card stays open, so you can work through the whole list. Finished
sub-tasks fold away behind *Show 2 settled*; *Hide settled sub-tasks* folds them again.

### Readings on the card

If a tag of the task is waiting for a reading, such as `#weight:`, *Done* asks *Enter readings*
first, with one field per tag and the last value as a hint. *Save* writes the values and finishes
the task; *Cancel* returns to the card and the task stays open. The rules are in
[Tags and search](../tags-and-search/index.md#readings).

### Appointments on the card

A tap on an appointment row opens a card for that one occurrence:

- *Another time* moves it to another hour.
- *This one is off* calls it off.
- *Move to day* and *Another day* move it to another day.

How this works with repeating appointments is described in
[Appointments](../appointments/index.md#widget). An occurrence that is already called off opens
the app instead.

## Setting up a Today widget {#configure}

Each *Today* widget has its own settings. Open them from *Settings → Home screen & system → On the
home screen*, or from the launcher's widget settings where it offers them. Change what you need and
tap *Save*.

> [!PRO]
> Widget settings need tagwerk Pro. Without it the screen says *Configuring widgets: time range,
> filters, title, font. Without Pro the widget shows today's tasks.* A widget set up earlier keeps
> its settings and uses them again as soon as Pro is active.

| Section | What you set |
|---|---|
| *Time range* | How many days the list covers: *Today*, `2d`, `7d`, `14d`, `30d`, or *Other* for any number up to 365. *Overdue tasks always appear, whatever is set here.* |
| *Show from* | The first day of the list: *Today*, *Tomorrow*, *Day after tomorrow*, `7d`, or *Other*. A list that starts later leaves the overdue tasks out - a widget for the days ahead. |
| *Profile* | From the second profile on: which profile the widget shows. *The widget keeps showing this profile, whichever one the app has open.* |
| *Title* | *Date*, *Own title* (for example "Office") or *No title*. Without a title there is room for one more row; the overdue counter goes with the title row. |
| *Font* | *Sans-serif* or *Monospace*. Rows do not wrap, so monospace shows less of each line. |
| *Background* | How solid the widget's background is, from 0 to 100 %. The text keeps its colours. |
| *Filter* | Tags and contacts. One tap selects a tag, a second excludes it, a third clears it. Without a filter the widget shows everything. |
| *Content* | *Show appointments*, *Show tasks* (at least one of the two stays on), *Hide appointments that have passed*, *Show cancelled appointments*, *Colour box at the start of the row*, *Tags in their own colour*, *Divide the blocks with a line*, *Show tags*, *Show contacts*. |
| *Sub-tasks* | *Show sub-tasks* puts a task's sub-tasks into the list as indented rows of their own. The `▲` counter does not count them. |

A sub-task counts for the filter with the tags and contacts of the tasks it is indented under, as
in the [task list](../tasks/index.md): excluding a tag removes a task together with its sub-tasks.

The filter also applies to appointments: an appointment matches when its line contains the tag or
the contact. If your appointments carry no tags, switch on *Show appointments regardless of the
filter*, which appears under *Content* while a filter is set. The colour box needs Android 12 or
newer; the coloured tags work everywhere. Both use the
[tag colours](../tags-and-search/index.md#colours) of the profile.

## Quick capture {#capture}

A tap on *tagwerk - New task* opens today's note with a new empty task line, `- [ ] `, and the
cursor behind it. Type the task and leave the app.

- If today's note has headings, or would get them from its
  [day template](../day-notes/index.md#templates), tagwerk first asks *Under which heading?*. Pick
  one, or *At the end of the note*.
- If an empty task line is already waiting there, the cursor goes to it instead of writing a
  second one. A tap by mistake leaves nothing behind.

The new line goes into the profile that is open in the app.

## Sharing text into tagwerk {#share}

In another app, choose *Share* and pick tagwerk. The text goes into **today's note** of the
profile that is open:

- It is written as it arrived, at the end of the note, and the cursor stands on its first line.
  tagwerk does not turn it into a task and adds no tag or date - that is one keystroke away if you
  want it.
- If the day has headings, or would get them from its template, tagwerk asks *Where should this
  go?* with a preview of the text. Pick a heading or *At the end of the note*.
- A web address shared together with a page title, as browsers do, arrives as a link with the
  title as its text.

Only text can be shared in. Pictures and files have no place in a note and are not offered.

### Add to tagwerk from a selection {#selection}

When you select text in another app, the selection menu offers *Add to tagwerk*. It does the same
as sharing the selection: the text goes into today's note. The entry is on by default; switch it
off in *Settings → Home screen & system → Offer "Add to tagwerk"*.