App Shortcuts Limitations

I've been implemented App Shortcuts into my apps which are localized for a variety of languages.

The WWDC23 "Spotlight your app with App Shortcuts" has been extremely helpful in resolving my localized trigger phrases issue, but before I continue filling out all of the trigger phrases for my application I am concerned about a limitation that was mention in the video and need some additional information about it.

The limitations noted in the video at minute mark 21:26 states that:

  1. Maximum 10 App Shortcuts (OK)
  2. Maximum 1000 trigger phrases...

If I have 1 app and 10 shortcuts, and each shortcut only uses (.applicationName), this means I get to have 100 trigger phrases for each shortcut (for the sake of the discussion).

What I'm unsure about is when I begin providing localization do the localized triggered phrases count toward the trigger phrase limit? Essentially, for every language I support do I have to drop 1/2 of all of my trigger phrases to stay under the limit?

At the moment, my app is supporting 40 languages and I would like to know how localization affects the trigger phrase limit.

Thank you!

You can think of the number of phrases as in terms of the customer's selected locale, and the limits of 1,000 phrases applies within that locale, not all locales combined. For example, if you have an app with localization support for two different locales, and the first locale needs 500 localized phrases, and the second locale requires 600 localized phrases, your app is still within the phrase limit, because you're only working with 500 or 600 phrases at a time, not 1,100 phrases in total.

Keep in mind that the system offers flexible phrase matching automatically, so you don't need to include minor wording changes as separate phrases, to help you manage the amount of phrases you need to provide with your App Shortcuts. You can test out different phrase variations to see how the flexible matching works through the Product > App Shortcuts Preview menu item in Xcode.

— Ed Ford,  DTS Engineer

App Shortcuts Limitations
 
 
Q