Documentation
Widgets, Shortcuts, and automations
Add, view, or delete measures with widgets, Shortcuts, and App Intents.
Updated on September 6, 2026
Widgets and Shortcuts let you use a series without opening DataJot. First create the series that will receive the measures.
Add a measure with Shortcuts
- In the Shortcuts app, create a shortcut and add the DataJot action for adding a measure.
- Select a series or enter its key.
- Provide a numeric value and, if needed, a date.
- Run the shortcut, then check the measure in DataJot.
A fixed value such as 1 works for a counter. For a variable value, add a Shortcuts action that asks for or retrieves the value before passing it to DataJot.
An action that uses a key targets the first matching series. Keys are not necessarily unique, so check the destination before using the shortcut in an automation.
Available Shortcuts actions
Some actions target a selected series; others use its key. The catalog below lists the parameters and result of each action.
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, en, de, or es), 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
- Create and test the shortcut manually first.
- In Shortcuts, create an automation with the required trigger.
- Add the shortcut or configured DataJot action.
- Test the automation and check the target series.
The Shortcuts app determines available triggers and any confirmation requests. DataJot only receives the parameters passed to its action.
Quick add widget
The add widget records a predefined value in a series. It is available in small and medium sizes and displays the aggregate for the current day.
Add the widget from the system interface, then edit it to select the series and numeric value. Each tap adds a new measure.
Displayed content refreshes periodically, approximately every fifteen minutes. It is not a real-time display.
Chart widget
The chart widget displays a series over a day, week, month, six months, or year, along with its latest available value.
Add the widget from the system interface, then edit it to select the series and range. Medium and large sizes can also show statistics enabled in the series configuration.
Like the add widget, its content refreshes periodically rather than in real time.
Delete measures with Shortcuts
This action is destructive, and DataJot does not request confirmation in Shortcuts.
- Add the delete action by series or key.
- Choose All Measures or provide a valid period.
- Check the series and period before running the action.
The targeted measures are permanently deleted. Test this type of shortcut only with data you can afford to lose.