Can I use a template image for quick actions?

Hey Team,

System-provided quick actions in Finder sport a template image that adapts correctly to light and dark modes.

However when I add a quick action extension in my app, the icon I refer to in the Info.plist renders in full color, even if it is defined in the asset catalog as a template image.

This forces me to either use my app icon or a gray icon that will work in either appearance.

How can I get the system-provided quick actions treatment?

Thanks, Ari

Answered by Frameworks Engineer in 892503022

This sounds like a bug. If you could file a feedback request reporting it, that would be appreciated.

This sounds like a bug. If you could file a feedback request reporting it, that would be appreciated.

[Submitted as FB25597933]

I'm seeing the same thing on macOS 27.2.1 (26B131) with Xcode 27.2 (27B52), and filed a feedback with a sample project. In Finder's Quick Actions menu, an Action extension icon set with NSExtensionServiceFinderPreviewIconName doesn't get template rendering, even though the docs say it should be a template image.

The sample has four Action extensions that share one Info.plist and differ only in the icon asset:

  • A custom SF Symbol with template rendering and an image set with Render As Template Image both draw black in every state: light mode, dark mode, and on a highlighted row.
  • An image set with separate Any and Dark appearance images (Render As Default) follows light and dark mode. But in light mode its icon stays dark on a highlighted row while the text turns white.
  • An image larger than the menu's icon slot is cropped to its center, not scaled.

The built-in Quick Actions follow the appearance and turn white when highlighted.