Custome RichText: Pick an icon from Icons ref

[adriendupuis]

Question	Answer
JIRA Ticket
Versions
Edition

Link to Icons reference to help picking an out of the box icon.

Discovered while working with Copilot to create a custom tag, without a link, it improvised an icon ID "bookmark" which doesn't exist. After telling him "you should find a Icons reference table somewhere in the doc", it was able to propose existing icons.

It doesn't thought by itself that a link is the missing solution but it agreed that it could help.

User

What could have helped you to not use non-existing "bookmark" icon in the first place?

---

_{82m 21s}

Copilot

Looking at the icon reference table in the documentation — which I actually found and used to fix the issue — I should have consulted it before choosing the icon name, not after. The table at vendor/ibexa/documentation-developer/developer/templating/twig_function_reference/icon_twig_functions/index.md lists all valid icon IDs, and a quick grep for bookmark there would have immediately shown that bookmark alone doesn't exist, while bookmark-filled, bookmark-outline, and bookmarks do.

Additionally, grepping directly against the SVG sprite (all-icons.svg) for id="bookmark" would have caught the mismatch before writing the config.

---

_{83m 43s}

User

Would a link to available icons in the doc you used to create the custom tag would have help? If yes, which doc page?

---

_{83m 46s}

Copilot

Yes, a direct link would have helped. The "Extend Online Editor" page (vendor/ibexa/documentation-developer/developer/content_management/rich_text/extend_online_editor/index.md) mentions an icon key in the custom tag config examples, but never links to the available icon names.

Adding a reference there to the icon reference table at:

developer/templating/twig_function_reference/icon_twig_functions/index.md#icons-reference

— the same link already present in the custom icons page — would have prompted me to look up the exact ID before using a guessed name.

Checklist

• Text renders correctly
• Text has been checked with vale
• Description metadata is up to date
• Redirects cover removed/moved pages
• Code samples are working
• PHP code samples have been fixed with PHP CS fixer
• Added link to this PR in relevant JIRA ticket or code PR

[github-actions]

Preview of modified files

Preview of modified Markdown:

• docs/content_management/rich_text/extend_online_editor.md

[github-actions]

Summary

Status	Count
🔍 Total	736641
🔗 Unique	14760
✅ Successful	6190
⏳ Timeouts	0
🔀 Redirected	3
👻 Excluded	730450
❓ Unknown	0
🚫 Errors	1
⛔ Unsupported	0

Errors per input

Errors in site/resources/new_in_doc/index.html

• [ERROR] file:///home/runner/work/documentation-developer/documentation-developer/repositories/userdoc-4.6/site/content_management/block_reference/index.html#bestsellers-block (at 19441:14) | Cannot find fragment

Redirects per input

Redirects in site/ai/mcp/mcp_guide/index.html

• https://modelcontextprotocol.io/docs/getting-started/intro --[307]--> https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro
• https://modelcontextprotocol.io/docs/learn/server-concepts --[307]--> https://modelcontextprotocol.io/docs/2026-07-28/learn/server-concepts

Redirects in site/ai/mcp/mcp_usage/index.html

• https://modelcontextprotocol.io/docs/tools/inspector --[307]--> https://modelcontextprotocol.io/docs/2026-07-28/tools/inspector

Full Github Actions output