⭐️ Sofa 5 is hereCheck it out 

Shortcuts Data Model

Last Updated:

This guide outlines the structure of the data objects you can access via Shortcuts. These are the building blocks you’ll use when creating workflows.


List

PropertyDescription
ListThe List object — pass it to Open List or other actions
TitleTitle of the list
Date AddedDate the list was created
Date EditedDate the list was last modified
DeeplinkA URL that links directly to the list
ItemsAn array of List Item objects within the list

List Item

PropertyDescription
List ItemThe List Item object — pass it to other actions
TitleTitle of the item
CategoryThe item type: movie, book, TV show, podcast, etc.
Image URLThe URL for the item’s cover image
Date AddedDate the item was added
Date EditedDate the item was last modified
Sticky NoteThe contents of the item’s Sticky Note
PinnedWhether the item is pinned (true/false)
ListThe List this item belongs to
DeeplinkA URL that links directly to the item

Logbook Item

PropertyDescription
Logbook ItemThe Logbook Item object
TitleTitle of the item
Item TypeThe item type: movie, book, TV show, podcast, etc.
Image URLThe URL for the item’s cover image
Date AddedDate the item was added
Date EditedDate the item was last modified
Sticky NoteThe contents of the item’s Sticky Note
DeeplinkA URL that links directly to the item

Event

PropertyDescription
EventThe Event object
TitleTitle of the event
Start DateWhen the event starts
End DateWhen the event ends
All DayWhether this is an all-day event (true/false)
DescriptionEvent description

Task

PropertyDescription
TaskThe Task object
TitleTitle of the task
Due DateWhen the task is due
PriorityNone, Low, Medium, or High
DescriptionTask description

Note

PropertyDescription
NoteThe Note object
BodyThe note’s text content
Start DateOptional date associated with the note

Episode

PropertyDescription
EpisodeThe Episode object
TitleEpisode title
ShowThe parent TV show
Season NumberSeason number
Episode NumberEpisode number
StatusWatched, unwatched, or skipped

Checkpoint

PropertyDescription
CheckpointThe Checkpoint object
TitleCheckpoint title
CompletedWhether the checkpoint is complete (true/false)

Search Result

PropertyDescription
Search ResultThe Search Result object — pass it to Add Search Result to List
TitleTitle of the content
TypeThe content type (movie, book, TV show, etc.)
Image URLCover image URL

Tracked Item

PropertyDescription
Tracked ItemThe Tracked Item object
TitleTitle of the item being tracked
ProgressCurrent progress percentage (0-100)
Progress SummaryHuman-readable summary (e.g., “8 of 62 episodes”)
Tracking ModeCounter, Quick Log, Journal, or Checklist

Join the Community

Get help, ask questions, and see how other people are using Sofa

Start Organizing
Your Downtime

All you have to do is press that button.