Definitions

Table of contents

  1. Icon
    1. Color
  2. Inputs & Outputs
  3. NoInput
  4. From (Workflows)
    1. Workflows
  5. Name
  6. Version

Define aspects of your Shortcut, such as the color and glyph of the icon, how it responds to no input, what it accepts as input, etc.

Icon

Define the look of your Shortcut using one of the supported colors or glyphs.

#define color red
#define glyph apple

Most glyphs are supported, but not all the newest are yet. Click here for the full list of supported glyphs .

Color

  • red
  • darkOrange
  • orange
  • yellow
  • green
  • teal
  • lightBlue
  • blue
  • darkBlue
  • violet
  • purple
  • pink
  • taupe
  • gray
  • darkGray

Inputs & Outputs

Inputs and outputs accept content item type.

Inputs will default to all types. Outputs will default to no types. This is done to be consistent with the Shortcuts file format.

#define inputs image, text
#define outputs app, file

These values must be separated by commas.

NoInput

Define how your shortcut responds to no input.

Stop and give a specific response:

#define noinput stopwith "Response"

Get the contents of the clipboard:

#define noinput getclipboard

Ask for a content item type:

#define noinput askfor text

From (Workflows)

This defines where your Shortcut shows up, quickactions, sleepmode, etc.

#define from menubar, sleepmode, onscreen

These values must be separated by commas.

Workflows

  • menubar - Menubar
  • quickactions - Quick Actions
  • sharesheet - Share Sheet
  • notifications - Notifications Center Widget
  • sleepmode - Sleep Mode
  • watch - Show on Apple Watch
  • onscreen - Receive On-Screen Content

Name

This will be used as the name of the resulting Shortcut file.

#define name My Shortcut

Cherri will ignore the name of the file and use the definition instead to create My Shortcut.shortcut.

Version

Defines the minimum version of iOS your Shortcut supports. Warnings will be printed if you use actions that are not supported in the targeted version.

#define version 16.2