Doc Categories - Sidebar titles revert to URL when editing index

nat · December 23, 2025, 4:40am

The bug is probably not to do with the base URL like I thought, but probably related to topic URL resolution.

I’ve a fix here

github.com/discourse/discourse-doc-categories

FIX: Do not show urls in sidebar but show topic titles instead

main ← sidebar-url-title

merged 04:58AM - 23 Dec 25 UTC

nattsw

+13 -2

A user has reported the following: <img width="1380" height="518" alt="image" s…rc="https://github.com/user-attachments/assets/c72f0040-c8db-40bf-9188-3ec8c8ffa52e" /> This is generally hard to reproduce locally, but the fix involves checking if the link text is the same as the href and falling back to the topic title from the database instead. The `IndexStructureRefresher` takes in `post.cooked`, so there's a chance there's some race condition with `ProcessPost` which updates the topic URL, regardless, the fix above would work. Report here: https://meta.discourse.org/t/doc-categories-sidebar-titles-revert-to-url-when-editing-index/388592

Topic		Replies	Views
Sidebar item title not updated after linked topic title in Index is edited Support doc-categories	4	83	August 27, 2024
Documentation Plugin - Index Topic not working after Restore Support doc-categories	8	50	December 27, 2025
Sidebar activation issues after recent Doc Categories update Bug doc-categories , horizon-theme , bug	5	88	September 29, 2025
Discourse Doc Categories links not rendering Bug doc-categories	8	110	January 29, 2025
Translate sidebar documentation links Feature doc-categories , dynaloc , content-localization	0	57	August 21, 2025

Doc Categories - Sidebar titles revert to URL when editing index

Related topics