Customizing section titles in the Shortcuts app (Favorites / Recents style)

Hi everyone,

I’m currently experimenting with App Intents and I’m trying to customize the section titles that appear at the top of groups of intents inside the Shortcuts app UI.

For example, in the Phone shortcut, there are built-in sections such as “Call Favorite Contacts” and “Call Recent Contacts” (see screenshot attached).

Apple’s own system apps such as Phone, Notes, and FaceTime seem to have fully custom section headers inside Shortcuts with icon.

My question is:

👉 Is there an API available that allows third-party apps to define these titles (or sections) programmatically?

I went through the AppIntents and Shortcuts documentation but couldn’t find anything.

From what I can tell, this might be private / Apple-only behavior, but I’d be happy to know if anybody has found a supported solution or a recommended alternative.

Has anyone dealt with this before?

Thanks!

Mickaël 🇫🇷

Answered by DTS Engineer in 868737022

There is API for this — take a look at this older thread for screenshots and code.

— Ed Ford,  DTS Engineer

Accepted Answer

There is API for this — take a look at this older thread for screenshots and code.

— Ed Ford,  DTS Engineer

Thanks a lot @DTS Engineer for your response — that solved my issue!

I was able to implement it successfully, and everything works as expected now.

I’m also sharing a small code example along with a screenshot in case it helps others who come across the same question.

AppShortcut(
                intent: ResumePlaybackIntent(),
                phrases: [
                    "Reprendre la lecture de \(\.$resumeVideo) avec \(.applicationName)",
                ],
                shortTitle: "Reprendre la lecture",
                systemImageName: "play.circle",
                parameterPresentation: .init(
                    for: \.$resumeVideo,
                    summary: Summary("Reprendre la lecture de \(\.$resumeVideo)"),
                    optionsCollections: {
                        OptionsCollection(
                            ResumeVideoQuery(),
                            title: "Reprendre la lecture",
                            systemImageName: "play.circle"
                        )
                    }
                )
            )

Really appreciate your help!

Customizing section titles in the Shortcuts app (Favorites / Recents style)
 
 
Q