I am trying to add a SiteSetting to my plugin that can control the icons displayed for some components. The component itself was already going to be user customizable, so I wanted to add the SiteSetting as a way for staff to define the default icon. I know there is emoji_list type for SiteSettings, but there doesn’t seem to be one for SVG icons? From what I can see, most plugins/TC use either image upload or plain string for icon settings. Am I missing a type/validator I can use? It feels weird to tell people to look up the styleguide and type the name of the icon.

There is now an icon type site setting. https://github.com/discourse/discourse/pull/38779

I think it’s a case where we don’t have any icon based site settings, so we haven’t added a type for it. We have an icon picker component that’s made its way into other parts of the app, but nothing currently in site settings.

That makes sense. I can’t really imagine any specific scenario where core would require it, as probably only Themes/TCs and plugins would have a use for an extremely UI focused setting. I am using the icon picker component in other places more easily accessible for ordinary users, but the specific use case I have in mind would be for stuff like setting a default icon. Combined with the object SiteSetting type, it would make templating certain features easier for admins. Would the team be open to adding an icon_type type to SiteSettings in core, even without any core site settings using it? I don’t mind reopening this topic as a #feature request if need be.

Any update on this? I noticed that reactions will be added to core, and that plugin currently has the Discourse reactions like icon setting where you need to enter the icon name manually.

No plans at the moment, but maybe that’s a good opportunity for it. I’ll pass the idea along.

yea it would be great to be able to use this in component settings, especially object type settings - can this be added please? [image] similar request also mentioned here: [image] Using a placeholder for FontAwesome links in descriptions of settings Development FA6 had a lot of renames, which is why it was so painful. I don’t think FA7 had any - just new/improved icons. I think in an ideal world, theme/site settings would be able to make use of our icon dropdown. [SCR-20260114-txbb] But yeah, we don’t have that available at the moment… so you’re right that the version number may still be useful.

I am not sure that’s the case. There is no icon type here discourse/lib/theme_settings_manager at main · discourse/discourse main/lib/theme_settings_manager A platform for community discussion. Free, open, simple. - discourse/discourse I think you cannot use the emoji setting type from site settings like Emoji deny list in themes either

[image] NateDhaliwal: This is great! I’m assuming it can be used for TCs as well? Time to start updating some with this! i don’t think it is yet (at least i couldn’t get it to work). are there any plans for supporting type: icon inside object schemas for theme components, like this? links: type: objects schema: name: menu_link identifier: text properties: icon: type: icon required: true text: type: string required: true validations: min_length: 1 max_length: 100 url: type: string required: true validations: min_length: 1 max_length: 500 ...

Icon type SiteSetting

Development

NateDhaliwal (Nate Dhaliwal) March 26, 2026, 10:59am 8

This is great! I’m assuming it can be used for TCs as well? Time to start updating some with this!

Icon type theme setting in objects type settings

Topic		Replies	Views
Icon type theme setting in objects type settings Feature	1	152	September 6, 2026
Using a placeholder for FontAwesome links in descriptions of settings Development	9	467	March 26, 2026
Custom Header Links (icons) Theme component official , custom-header-icons	117	34212	August 4, 2025
Introducing Font Awesome 5 and SVG icons Announcements new-feature	131	45229	December 1, 2023
Add settings to your Discourse theme Developer Guides how-to , theme-guides	6	17902	July 8, 2025

Icon type SiteSetting

Related topics