Definitions

Table of contents

  1. Icon
    1. Color
    2. Glyph
  2. Accepted Input & Output Types
  3. No Input
    1. Stop and Respond
    2. Get Clipboard Contents
    3. Ask for a content item type:
  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 types it accepts as input and outputs, etc.

Icon

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

Color 

#define color red
  • red
  • darkorange
  • orange
  • yellow
  • green
  • teal
  • lightblue
  • blue
  • darkblue
  • violet
  • purple
  • pink
  • taupe
  • gray
  • darkgray

Glyph 

#define glyph apple

You can find all of the identifiers for each Shortcut glyph at glyphs.cherrilang.org.

Accepted Input & Output Types

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

Commas must separate these values.

No Input

Define how your shortcut responds to no input.

Stop and Respond 

#define noinput stopwith "Response"

Get Clipboard Contents 

#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