Documentation
Widgets, Shortcuts, and automations
Add, create, read, export, or delete DataJot data with widgets, Shortcuts, and App Intents.
Updated on July 17, 2026
One of DataJot’s strengths is that you do not always have to enter values manually. Once the series exists, you can add measures from a widget, from a manual shortcut, or from a Shortcuts automation.
Before configuring a widget or shortcut, first create the series that will receive the measures. The Series page explains that step.
Add a measure without opening the app
The most important action is adding a measure. It receives a target series and a numeric value, then DataJot adds that value to the series history.
For a counter, the value can be fixed. For example, an “Add coffee” shortcut can add 1 to the “Coffee” series.
For a variable value, the shortcut can ask for the value before sending it to DataJot. This is better for temperature, weight, meter readings, or any measure you read manually.
Available Shortcuts actions
DataJot exposes several App Intents in the Shortcuts app. Some actions target a selected series directly, while others target the first series whose key matches. Key-based actions are useful for stable automations because they do not depend on the displayed series name.
Add values
AddMeasureIntent
Display name: Add a value
Description
Adds a new value to a selected series. Also configures the add widget.
Parameters
Required series, newValue defaults to 1.0, optional date.
Return / effect
Creates a measure. If date is empty, DataJot uses the current date. Reloads WidgetKit timelines.
AddMeasureByKeyIntent
Display name: Add a value by series key
Description
Adds a value to the first series whose key matches.
Parameters
Required seriesKey, newValue defaults to 1.0, optional date.
Return / effect
Creates a measure on the first series found by key. Reloads widgets.
Create categories and series
CreateCategoryIntent
Display name: Create a category
Description
Creates a DataJot category.
Parameters
Required name, optional key, descriptionText, color.
Return / effect
Returns a CategoryEntity. The name and key are trimmed; an empty name is refused.
CreateSeriesIntent
Display name: Create a series
Description
Creates a complete DataJot series.
Parameters
Required name, then optional key, category, descriptionText, unitLabel, iconName, color, precision, aggregationMethod, chartType, defaultView.
Return / effect
Returns a SeriesEntity. If unitLabel is provided, DataJot creates a custom 1:1 unit.
CreateSeriesFromTemplateIntent
Display name: Create a series from a template
Description
Creates a DataJot series from a template.
Parameters
Required template, optional category, nameOverride.
Return / effect
Returns a SeriesEntity. DataJot loads templates for the current locale (fr or en), reuses existing units and configs when possible, then removes the template key from the new series.
Read series and aggregates
FetchSeriesListIntent
Display name: Fetch series
Description
Fetches series, optionally filtered by category.
Parameters
Optional category.
Return / effect
Returns [SeriesEntity], sorted by name.
FetchSeriesAggregateIntent
Display name: Fetch a series aggregate
Description
Fetches the last non-empty aggregate for a series.
Parameters
Required series, optional from, to, granularity defaults to day, optional aggregationMethod.
Return / effect
Returns SeriesAggregateEntity with the series, period, granularity, method, date, value, and measure count. Default window: last 30 days if no date is provided.
FetchSeriesAggregateByKeyIntent
Display name: Fetch aggregate by series key
Description
Same logic as FetchSeriesAggregateIntent, but targets the first series matching a key.
Parameters
Required seriesKey, from, to, granularity, aggregationMethod.
Return / effect
Returns SeriesAggregateEntity.
Export and delete measures
ExportSeriesCSVIntent
Display name: Export series as CSV
Description
Exports a series as CSV.
Parameters
Required series, scope defaults to all, optional from, to.
Return / effect
Returns a CSV IntentFile. The all scope ignores dates; the period scope requires at least from or to. Single-sided bounds are accepted.
ExportSeriesCSVByKeyIntent
Display name: Export series as CSV by series key
Description
Same export as ExportSeriesCSVIntent, but by series key.
Parameters
Required seriesKey, scope, from, to.
Return / effect
Returns a CSV file for the first series whose key matches.
DeleteSeriesMeasuresIntent
Display name: Delete values from a series
Description
Deletes all values from a series or values within a period.
Parameters
Required series, scope defaults to all, from, to.
Return / effect
Returns SeriesMeasureDeletionResultEntity with the series and deleted count. The period scope requires from and to. Reloads widgets.
DeleteSeriesMeasuresByKeyIntent
Display name: Delete values by series key
Description
Same deletion as DeleteSeriesMeasuresIntent, but by series key.
Parameters
Required seriesKey, scope, from, to.
Return / effect
Deletes measures from the first series whose key matches and returns the deleted count.
Automate a measure
A Shortcuts automation can add a measure without you doing the logging at that moment.
For example, you can create an automation that runs at a fixed time, reads or asks for a value, then adds it to the right DataJot series. The goal is to reduce repetitive entry: DataJot receives the value, saves it with a date, and the history remains available in the app.
Start simple. Test the shortcut manually first, check that the measure arrives in the right series, then use it inside an automation.
Quick add widget
The add measure widget is useful for values you add often.
If you track coffee, you can configure a widget with the “Coffee” series and the value 1. Each tap adds a measure. With sum aggregation, DataJot can then display the total for the day or week.
This widget is available in small and medium sizes. It also displays the aggregated value for the current day for the configured series.
Chart widget
The chart widget lets you review a series quickly from the Home Screen.
Choose a series and range: day, week, month, six months, or year. The widget displays the corresponding chart and the latest available value.
In medium and large sizes, it can also display statistics according to the series configuration. In small size, the display is more compact.
Useful examples
A habit counter can use a fixed value of 1.
A weight measure can ask for the value when the shortcut runs.
A regularly recorded measure can be added by an automation, as long as the shortcut provides a reliable numeric value.
In all cases, keep series names explicit. That makes widgets and shortcuts easier to configure without sending values to the wrong destination.