Icon type theme setting in objects type settings

Moin · September 6, 2026, 11:09am

FEATURE: Support `icon` properties in objects settings schemas (#42632)

main ← feature/objects-icon-property

Zusammengeführt am 02:08PM - 21 Aug 26 UTC

Follow-up to #42626. Previously, the `icon` setting type was only available a…s a top-level site/theme setting type — properties inside an `objects` setting schema could not use it, and icon names stored in objects values were never added to the SVG sprite sheet. This change allows `objects` type site and theme settings to declare schema properties with `type: icon`, rendering the icon grid picker in the schema editor and automatically including the selected icons (nested `objects` included) in the sprite sheet. Note one adjacent change: sprite cache invalidation in `014-track-setting-changes.rb` was gated on the setting *name* containing `_icon`, so changing an `icon` or `objects` typed site setting left a stale sprite. It now also expires for those types, which fixes that latent gap for top-level `icon` site settings from 802fa4c3562 as well. Example: ```yaml Example: type: objects default: "" schema: name: link identifier: title properties: title: type: string required: true icon: type: icon ````

Thanks for the update, much appreciated!

Topic		Replies	Views
Icon type SiteSetting Development	9	370	March 26, 2026
Objects type for theme setting Developer Guides how-to , theme-guides	32	2556	April 13, 2026
Brand Header links and icons settings now Object setting type Feature completed , brand-header	4	220	April 26, 2024
Add settings to your Discourse theme Developer Guides how-to , theme-guides	6	17567	July 8, 2025
SVG icon missing error with dropdown settings in theme object settings when max input is reached UX completed	1	125	December 19, 2025

Icon type theme setting in objects type settings

Related topics