# \#docs **URL:** https://meta.discourse.org/tag/docs/251.md [Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md) --- ## [Discourse Docs](https://meta.discourse.org/t/discourse-docs/130172)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 23\ **Last updated:** [September 16, 2025, 12:41pm UTC](https://meta.discourse.org/t/discourse-docs/130172 "2025-09-16T12:41:24Z")
:warning: This plugin is being retired in favour of the experimental Doc Categories plugin. We will still support Docs until the new plugin is no longer considered experimental. :discourse2: Summary Discou… --- ## [Custom topic ordering](https://meta.discourse.org/t/custom-topic-ordering/366644)
**Author:** [@meglio](https://meta.discourse.org/u/meglio)\ **Replies:** 8\ **Last updated:** [September 17, 2025, 8:48pm UTC](https://meta.discourse.org/t/custom-topic-ordering/366644 "2025-09-17T20:48:59Z")
In some categories, the stakeholders of a project would like to manually drag&drop topics to reorder them. Is there such a theme component or plugin that would allow for custom topic ordering? --- ## [Discourse Docs Plugin – Topics Not Updating in Docs Page](https://meta.discourse.org/t/discourse-docs-plugin-topics-not-updating-in-docs-page/362076)
**Author:** [@thaidb](https://meta.discourse.org/u/thaidb)\ **Replies:** 6\ **Last updated:** [April 16, 2025, 9:44pm UTC](https://meta.discourse.org/t/discourse-docs-plugin-topics-not-updating-in-docs-page/362076 "2025-04-16T21:44:35Z")
I’m currently using the Discourse Docs plugin and I’ve run into an issue where new topics posted in certain categories no longer appear in the Docs page. For example, in this category: :link: https ://sitet0r dot com/c/… --- ## [Discourse docs search error, 500 error](https://meta.discourse.org/t/discourse-docs-search-error-500-error/336450)
**Author:** [@Jun](https://meta.discourse.org/u/Jun)\ **Replies:** 5\ **Last updated:** [November 16, 2024, 10:59am UTC](https://meta.discourse.org/t/discourse-docs-search-error-500-error/336450 "2024-11-16T10:59:13Z")
When searching docs using Plugin:Discourse Docs, 500 internal error occurs. Search word like “上”. Discourse version: 3.4.0.beta3-dev Request url in browser: docs.json?search=%E4%B8%8A discourse/logs(part 1): /va… --- ## [The "Docs" section doesn't show all available categories & articles](https://meta.discourse.org/t/the-docs-section-doesnt-show-all-available-categories-articles/319783)
**Author:** [@m.fanega](https://meta.discourse.org/u/m.fanega)\ **Replies:** 6\ **Last updated:** [August 2, 2024, 9:19am UTC](https://meta.discourse.org/t/the-docs-section-doesnt-show-all-available-categories-articles/319783 "2024-08-02T09:19:05Z")
Hi everyone! First time posting here :slight\_smile: We recently moved our Knowledge Base to the Discourse forum we’ve had for a while. However, the “Docs” section does not show all the available categories nor articles… --- ## [Tag group disappears from docs filter after renaming it](https://meta.discourse.org/t/tag-group-disappears-from-docs-filter-after-renaming-it/313187)
**Author:** [@jrgong](https://meta.discourse.org/u/jrgong)\ **Replies:** 0\ **Last updated:** [June 22, 2024, 11:47am UTC](https://meta.discourse.org/t/tag-group-disappears-from-docs-filter-after-renaming-it/313187 "2024-06-22T11:47:05Z")
When tag group is added to docs and then renamed, they disappear from docs filter. To repro: Enable show tags by group Add a tag group to docs tag groups Rename the tag group Tags disappear from docs filter while in t… --- ## [When clicking Docs Thumbnail, user is redirected to regular post, not docs post](https://meta.discourse.org/t/when-clicking-docs-thumbnail-user-is-redirected-to-regular-post-not-docs-post/306733)
**Author:** [@jrgong](https://meta.discourse.org/u/jrgong)\ **Replies:** 1\ **Last updated:** [June 20, 2024, 11:26am UTC](https://meta.discourse.org/t/when-clicking-docs-thumbnail-user-is-redirected-to-regular-post-not-docs-post/306733 "2024-06-20T11:26:55Z")
Hey guys Happening on 3.2! When I enable any thumbnail layout for Docs plugin, the thumbnail in the docs list always points to the regular topic URL, not the Docs URL. Seems like a bug. --- ## [Bug in docs plugin: Pinned topics are not at the top](https://meta.discourse.org/t/bug-in-docs-plugin-pinned-topics-are-not-at-the-top/220254)
**Author:** [@jrgong](https://meta.discourse.org/u/jrgong)\ **Replies:** 5\ **Last updated:** [June 3, 2024, 7:34pm UTC](https://meta.discourse.org/t/bug-in-docs-plugin-pinned-topics-are-not-at-the-top/220254 "2024-06-03T19:34:31Z")
Whenever a topic is pinned in a category, it’s not pinned to the top in docs You can see the behaviour in action here: https://forum.cannabisanbauen.net/docs?tags=01-grundlagen Is that expected behaviour or a bug? Dis… --- ## [Duplicate Categories with Docs](https://meta.discourse.org/t/duplicate-categories-with-docs/293292)
**Author:** [@jordantrizz](https://meta.discourse.org/u/jordantrizz)\ **Replies:** 3\ **Last updated:** [February 2, 2024, 11:54pm UTC](https://meta.discourse.org/t/duplicate-categories-with-docs/293292 "2024-02-02T23:54:31Z")
I’m going to try and explain this the best possible way, I might not get it correct the first time around. I’m trying to build out a massive Wiki using Discourse Docs plugin, the Discourse instance isn’t dedicated to be… --- ## [Docs search form triggers full page reload on every keystroke](https://meta.discourse.org/t/docs-search-form-triggers-full-page-reload-on-every-keystroke/283717)
**Author:** [@simon](https://meta.discourse.org/u/simon)\ **Replies:** 2\ **Last updated:** [December 4, 2023, 2:16pm UTC](https://meta.discourse.org/t/docs-search-form-triggers-full-page-reload-on-every-keystroke/283717 "2023-12-04T14:16:13Z")
With the latest Chrome browser on Ubuntu, entering three characters into the docs search form triggers a full page reload: After the initial three characters have been entered, every subsequent keystroke in the searc… --- ## [Customize docs plugin text link](https://meta.discourse.org/t/customize-docs-plugin-text-link/278644)
**Author:** [@Hyan](https://meta.discourse.org/u/Hyan)\ **Replies:** 9\ **Last updated:** [November 30, 2023, 12:19am UTC](https://meta.discourse.org/t/customize-docs-plugin-text-link/278644 "2023-11-30T00:19:39Z")
Hi Discourse community, I enabled discourse-docs plugin and add it to top menu. By default, its link is for example, www.example.com/docs, how can I change it to something like www.example.com/my-docs? --- ## [How can I get a table of contents for my docs?](https://meta.discourse.org/t/how-can-i-get-a-table-of-contents-for-my-docs/286586)
**Author:** [@savas](https://meta.discourse.org/u/savas)\ **Replies:** 2\ **Last updated:** [November 25, 2023, 12:08pm UTC](https://meta.discourse.org/t/how-can-i-get-a-table-of-contents-for-my-docs/286586 "2023-11-25T12:08:02Z")
Hey, nice Documentations plugin i :heart: it! But can you give little bit more info i got one problem with it i try to do documentations articles and missing in my articles this … I thought H1 H2 tags trigger it, bu… --- ## [Can I change the name of the '/docs' url?](https://meta.discourse.org/t/can-i-change-the-name-of-the-docs-url/286362)
**Author:** [@thaidb](https://meta.discourse.org/u/thaidb)\ **Replies:** 1\ **Last updated:** [November 22, 2023, 3:59pm UTC](https://meta.discourse.org/t/can-i-change-the-name-of-the-docs-url/286362 "2023-11-22T15:59:26Z")
Can i change url “docs” to “booking” Example: https://meta.discourse.org/docs become https://meta.discourse.org/booking --- ## [Is it possible to restrict certain “docs” to appear based on the user’s groups?](https://meta.discourse.org/t/is-it-possible-to-restrict-certain-docs-to-appear-based-on-the-user-s-groups/286363)
**Author:** [@alehandrof](https://meta.discourse.org/u/alehandrof)\ **Replies:** 3\ **Last updated:** [November 22, 2023, 3:52pm UTC](https://meta.discourse.org/t/is-it-possible-to-restrict-certain-docs-to-appear-based-on-the-user-s-groups/286363 "2023-11-22T15:52:47Z")
Is it possible to restrict certain “docs” to appear based on the user’s groups? Use case: In our private Discourse, many users belong to committees or working group. They need to have access to specific documents, but d… --- ## [Docs endpoint doesn't use appropriate image for articles in opengraph tags](https://meta.discourse.org/t/docs-endpoint-doesnt-use-appropriate-image-for-articles-in-opengraph-tags/279993)
**Author:** [@CubeCoders](https://meta.discourse.org/u/CubeCoders)\ **Replies:** 0\ **Last updated:** [September 25, 2023, 12:33pm UTC](https://meta.discourse.org/t/docs-endpoint-doesnt-use-appropriate-image-for-articles-in-opengraph-tags/279993 "2023-09-25T12:33:22Z")
Where I have a discussion thread, if the thread starts with a single - large image, then that image is used as the opengraph image for use by social networks/other sharing when posting a link to the thread. If the same … --- ## [Can I hide these blocks using a plugin setting?](https://meta.discourse.org/t/can-i-hide-these-blocks-using-a-plugin-setting/286364)
**Author:** [@Aizada\_M](https://meta.discourse.org/u/Aizada_M)\ **Replies:** 1\ **Last updated:** [September 16, 2023, 10:06pm UTC](https://meta.discourse.org/t/can-i-hide-these-blocks-using-a-plugin-setting/286364 "2023-09-16T22:06:26Z")
Hello! I am planning to install this plugin. Is there an option in the plugin settings to hide the top blocks of categories or is this solved through CSS? --- ## [Discourse Docs Card Filter](https://meta.discourse.org/t/discourse-docs-card-filter/187947)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 42\ **Last updated:** [September 12, 2023, 2:49pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947 "2023-09-12T14:49:44Z")
:discourse2: Summary Discourse Docs Card Filter is to be used with the Discourse Docs Plugin and allows you to place “Cards” that act as a clickable filter for quicker filter results upon entering the /docs p… --- ## [Docs on starting page](https://meta.discourse.org/t/docs-on-starting-page/277335)
**Author:** [@OsaIsacson](https://meta.discourse.org/u/OsaIsacson)\ **Replies:** 2\ **Last updated:** [August 31, 2023, 11:15am UTC](https://meta.discourse.org/t/docs-on-starting-page/277335 "2023-08-31T11:15:42Z")
We love docs so much we’d like it to be on our starting page. Is this possible? I am looking to replace the default feed with docs. In the best of worlds I would be able to simply hide the current feed with css and plo… --- ## [Is there support for adding subcategories from a parent category?](https://meta.discourse.org/t/is-there-support-for-adding-subcategories-from-a-parent-category/276780)
**Author:** [@TechnoFox](https://meta.discourse.org/u/TechnoFox)\ **Replies:** 1\ **Last updated:** [August 25, 2023, 8:15pm UTC](https://meta.discourse.org/t/is-there-support-for-adding-subcategories-from-a-parent-category/276780 "2023-08-25T20:15:02Z")
Is there support for adding subcategories from a parent category? Currently when a parent category is added to Docs, the child categories are not added automatically. --- ## [How can I disable the docs item in the 'more' section?](https://meta.discourse.org/t/how-can-i-disable-the-docs-item-in-the-more-section/274904)
**Author:** [@AquaL1te](https://meta.discourse.org/u/AquaL1te)\ **Replies:** 2\ **Last updated:** [August 12, 2023, 4:41pm UTC](https://meta.discourse.org/t/how-can-i-disable-the-docs-item-in-the-more-section/274904 "2023-08-12T16:41:12Z")
How can I disable the menu item in the sidebar (in the ‘more’ section)? I can only disable it in the drop menu where the links to the categories and latest topics are included. --- ## [Back button behavior on docs](https://meta.discourse.org/t/back-button-behavior-on-docs/273046)
**Author:** [@MarcP](https://meta.discourse.org/u/MarcP)\ **Replies:** 2\ **Last updated:** [July 28, 2023, 10:49am UTC](https://meta.discourse.org/t/back-button-behavior-on-docs/273046 "2023-07-28T10:49:05Z")
Continuing the discussion from Discourse Docs (Documentation Management) On the docs page: Click a cat/tag filter Go to a topic Click the go back hyperlink Now the tag filter is reset I think this behavior is not exp… --- ## [Docs plugin does not filter tags after selecting category](https://meta.discourse.org/t/docs-plugin-does-not-filter-tags-after-selecting-category/267433)
**Author:** [@Simon\_Manning](https://meta.discourse.org/u/Simon_Manning)\ **Replies:** 0\ **Last updated:** [June 6, 2023, 7:54pm UTC](https://meta.discourse.org/t/docs-plugin-does-not-filter-tags-after-selecting-category/267433 "2023-06-06T19:54:45Z")
Priority/Severity: Low/Low Platform: Desktop, macOS, Ventura 13.4, Safari 16.5 Description: Available tags are not filtered by selected category in docs plugin. In the inverse, available categories are filtered out … --- ## [Need to click twice to de-select a category filter in Docs](https://meta.discourse.org/t/need-to-click-twice-to-de-select-a-category-filter-in-docs/264789)
**Author:** [@manuel](https://meta.discourse.org/u/manuel)\ **Replies:** 4\ **Last updated:** [May 25, 2023, 12:35am UTC](https://meta.discourse.org/t/need-to-click-twice-to-de-select-a-category-filter-in-docs/264789 "2023-05-25T00:35:44Z")
Just as the title says. First click on a selected category filter causes no action. On tags it works. --- ## [Using multiple sidebar links to the Docs page](https://meta.discourse.org/t/using-multiple-sidebar-links-to-the-docs-page/264791)
**Author:** [@manuel](https://meta.discourse.org/u/manuel)\ **Replies:** 0\ **Last updated:** [May 12, 2023, 10:09am UTC](https://meta.discourse.org/t/using-multiple-sidebar-links-to-the-docs-page/264791 "2023-05-12T10:09:57Z")
Took me a while to figure this out in detail, so briefly sharing the setup how to make this work. The idea is to offer various shortcuts to the Docs page on a custom sidebar section. E.g. here I use three tag filters (is… --- ## [Discourse docs topic's edit history modal does not open on click](https://meta.discourse.org/t/discourse-docs-topics-edit-history-modal-does-not-open-on-click/260285)
**Author:** [@Arkshine](https://meta.discourse.org/u/Arkshine)\ **Replies:** 1\ **Last updated:** [April 3, 2023, 6:45pm UTC](https://meta.discourse.org/t/discourse-docs-topics-edit-history-modal-does-not-open-on-click/260285 "2023-04-03T18:45:21Z")
Priority/Severity: Low Platform: All Description: Nothing happens when clicking on the icon to open a topic’s edit history. No error was spotted in the console. Reproducible steps: Go to Documentation - Discou… --- ## [Subcategories and tag groups layout](https://meta.discourse.org/t/subcategories-and-tag-groups-layout/255822)
**Author:** [@Frankz](https://meta.discourse.org/u/Frankz)\ **Replies:** 3\ **Last updated:** [February 21, 2023, 8:37pm UTC](https://meta.discourse.org/t/subcategories-and-tag-groups-layout/255822 "2023-02-21T20:37:39Z")
https://meta.discourse.org/docs?tags= Hi, I plan to build an online auto parts community. I like the layout of your docs categories and tags of above webpage. But can I add subcategories to the category and tag groups… --- ## [Table of Contents sometimes cut off on smaller screens](https://meta.discourse.org/t/table-of-contents-sometimes-cut-off-on-smaller-screens/276600)
**Author:** [@debryc](https://meta.discourse.org/u/debryc)\ **Replies:** 4\ **Last updated:** [February 6, 2023, 5:29am UTC](https://meta.discourse.org/t/table-of-contents-sometimes-cut-off-on-smaller-screens/276600 "2023-02-06T05:29:08Z")
Unfortunately, the table of contents runs off the screen in Docs. Which doesn’t happen on the regular topic view. --- ## [Layout of Docs is way too wide](https://meta.discourse.org/t/layout-of-docs-is-way-too-wide/253381)
**Author:** [@Jagster](https://meta.discourse.org/u/Jagster)\ **Replies:** 3\ **Last updated:** [January 30, 2023, 11:00pm UTC](https://meta.discourse.org/t/layout-of-docs-is-way-too-wide/253381 "2023-01-30T23:00:54Z")
Images vs. thousand words… At Docs: Versus forum and what i would expect: iPad, Discourse is really fresh, and that has been this way a long time now Perhaps hiding timeline/toc would be enough because filteri… --- ## [trackStatus error in docs topics](https://meta.discourse.org/t/trackstatus-error-in-docs-topics/248717)
**Author:** [@Don](https://meta.discourse.org/u/Don)\ **Replies:** 9\ **Last updated:** [December 26, 2022, 12:30pm UTC](https://meta.discourse.org/t/trackstatus-error-in-docs-topics/248717 "2022-12-26T12:30:18Z")
Hello, I’ve noticed in docs some topics content not load, only the topic title. To repro it go for example this topic Configure an S3 compatible object storage provider for uploads and check the console. Thanks … --- ## [Docs view broken for admins](https://meta.discourse.org/t/docs-view-broken-for-admins/240597)
**Author:** [@denvergeeks](https://meta.discourse.org/u/denvergeeks)\ **Replies:** 3\ **Last updated:** [December 16, 2022, 3:01pm UTC](https://meta.discourse.org/t/docs-view-broken-for-admins/240597 "2022-12-16T15:01:09Z")
Anyone seen anything like this before? I tried removing all of my custom CSS and clearing my browser cache with no change… When I am logged in (but only while I am logged in), the DOCS filtering page is all whacked out … [Next page](https://meta.discourse.org/tag/docs/251.md?match_all_tags=true&page=1&tags%5B%5D=docs)