Widgets

The Task Progress widget shows today’s progress outside the main app. In larger sizes, it can also show task rows and interactive controls.

Widgets use a compact shared snapshot generated by the main app. Widget interactions are queued for the app to apply, so a widget can update its display before the main database finishes processing the action.

Add the Task Progress widget

Add the Task Progress widget from the system widget gallery on supported devices.

On iPhone and iPad, supported families include:

• system small
• system medium
• system large
• system extra large
• accessory circular
• accessory rectangular
• accessory inline

On Mac, supported families include:

• system small
• system medium
• system large
• system extra large

Small and accessory layouts focus on progress or a short summary. Medium and larger layouts can show task rows.

What the widget shows

The widget is based on Today.

It counts today’s tasks, including completed tasks for progress. For display rows, it shows active incomplete tasks and can briefly keep one recently completed task visible for confirmation.

Rows can show details such as:

• task title
• overdue state
• scheduled time
• Deadline time
• completed state

The widget snapshot is intentionally compact. Pinwork may trim rows to stay within the widget data limit.

Complete or reopen from the widget

Medium and larger Task Progress widgets can complete or reopen tasks from the widget row checkbox.

Interactive widget actions require:

• Pro access
• the Interactive Widgets setting, which is on by default

The widget process does not edit the main task database directly. It updates its own snapshot optimistically, queues the action, and asks the main app to apply the real change later.

If access is locked, the main app drops pending widget mutations and refreshes the widget data.

Widget actions do not provide the normal in-app undo stack. While a completed row remains visible, the widget can show an uncomplete button.

Widget actions are queued

Completing a task from a widget can update the widget first. The main app applies the real task change when it processes the queued action.

Widget plus button

Some Task Progress widget layouts can show a plus button.

The plus button opens Pinwork to add a task for today. It does not create the task directly inside the widget.

The plus button is controlled by Show Quick Add Button and is disabled when interactive widgets are disabled.

Lock Screen widgets

On iPhone, accessory-size widgets can appear on the Lock Screen.

If you do not want task titles visible on the Lock Screen, enable title redaction in Pinwork settings.

When title redaction is on, Lock Screen surfaces can hide task titles while still showing progress or summary information.

Widget settings

Pinwork settings can control widget behavior, including:

• Interactive Widgets
• Show Quick Add Button
• Lock Screen title redaction

Interactive Widgets must be enabled for widget row actions and the quick-add button.

Why a widget may look stale

Widget refresh timing is partly controlled by the system. Pinwork can ask WidgetKit to reload timelines and refresh shared widget data, but widgets do not update like live app windows.

If a widget looks stale:

• open Pinwork so it can refresh shared widget data
• check that Pro access is active
• check that Interactive Widgets is enabled for row actions
• wait for the system widget timeline to refresh
• remove and add the widget again if the system surface appears stuck

Access lock behavior

When access is locked, the main app drops queued widget, share, or action mutations and refreshes widget data.

Widget viewing can continue, but task-changing widget actions require active Pro access.

Related

• At a glance: widgets, controls, Live Activities, menu bar, and Watch complications.
• Controls and Lock Screen: Control widgets and Lock Screen surfaces.
• Read-only recovery: what happens when access is interrupted.
• Widgets are not updating: troubleshooting steps.