### Author:  [@Don](https://meta.discourse.org/u/Don)
#### Post date: [August 27, 2025, 1:52pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/1 "2025-08-27T13:52:44Z")
| | | |
| --- | --- | --- |
| ℹ | **Summary** | Topic Sort Order Button |
| 👓 | **Preview** | [Theme Creator](https://discourse.theme-creator.io/theme/Don/topic-sort-order-button) |
| 🛠 | **Repository** | [GitHub - VaperinaDEV/custom-topic-sort-order-button: Add a custom topic sorting button to the topic list. · GitHub](https://github.com/VaperinaDEV/custom-topic-sort-order-button) |
| ❓ | **Install Guide** | [How to install a theme or theme component](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682) |
| 📖 | **New to Discourse Themes?** | [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) |
Install this theme component
Hello 👋
This theme component adds a new button next to the **Create Topic** button, allowing you to change the topic list order. One of the main goals was to make topic ordering easily accessible on mobile devices as well and themes where the topic list header section is hidden.
Clicking on an item will show the sort order direction (ascending or descending) on the right side of the item.
| Descending (icon) | Ascending (icon) |
| --- | --- |
|  |  |
### Settings
This component contains several settings for customization.
#### Object setting
With the object setting you can change each item’s **icon** , **label** , **action** and **order**.
- **icon** → icon name from the Discourse icon set
- **label** → translation key (see `/admin/customize/site_texts`)
- **action** → sorting action identifier
- **order** → position of the item in the dropdown
Example for `label`:
In this case the label field should be: `js.likes`
---
### Author:  [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [August 27, 2025, 2:24pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/2 "2025-08-27T14:24:12Z")
Great component! I thought about creating something similar.
I noticed you did not add a license to the GitHub repo.
Would you accept a pull request that adds more order options like `op_likes`?
>
---
### Author:  [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [August 27, 2025, 2:35pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/3 "2025-08-27T14:35:32Z")
this is a great component Don, nice work! thanks for creating this 🤩
---
### Author:  [@Don](https://meta.discourse.org/u/Don)
#### Post date: [August 27, 2025, 2:36pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/4 "2025-08-27T14:36:59Z")
Sure! PR welcome thanks @Moin 🤗
---
### Author:  [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [August 27, 2025, 2:42pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/5 "2025-08-27T14:42:23Z")
One thing I noted is that I sort of expect the drop down to disappear after I’ve clicked one of the selections. I have to click outside it after the view changes to make it go away. But maybe that is by design - I’m not sure lol.
---
### Author:  [@Don](https://meta.discourse.org/u/Don)
#### Post date: [August 27, 2025, 2:48pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/7 "2025-08-27T14:48:23Z")
Yeah this is by design — if you click the same item again the sorting direction changes.
---
### Author:  [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [August 27, 2025, 2:49pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/8 "2025-08-27T14:49:22Z")
yea i was thinking that after playing with it more. i love this component - very useful for me on my own instance. thanks again 🤗
---
### Author:  [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [August 27, 2025, 2:54pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/9 "2025-08-27T14:54:36Z")
I notice the `sort by` button appears on the categories page, but doesn’t do anything there. could probably hide it in that case.
---
### Author:  [@Don](https://meta.discourse.org/u/Don)
#### Post date: [August 27, 2025, 3:29pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/10 "2025-08-27T15:29:01Z")
Thanks Lilly 🤗 I’ve merged it: [DEV: Remove sort button on categories page · VaperinaDEV/custom-topic-sort-order-button@1325272 · GitHub](https://github.com/VaperinaDEV/custom-topic-sort-order-button/commit/1325272b827fb1572adcfbe01662d2cac4fef962)
---
### Author:  [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [September 8, 2025, 12:24pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/11 "2025-09-08T12:24:53Z")
It’s merged.
> **Icons and labels I chose for the additional order options**
>
> ```plaintext
> {
> "icon": "custom-heart-circle-one",
> "label": "js.category.sort_options.op_likes",
> "action": "op_likes"
> },
> {
> "icon": "user-group",
> "label": "js.posters",
> "action": "posters"
> },
> {
> "icon": "far-square",
> "label": "js.category.sort_options.category",
> "action": "category"
> },
> {
> "icon": "square-plus",
> "label": "js.topic_voting.vote_title_plural",
> "action": "votes"
> }
>
> ```
I did not add these to the default configuration as I think these are less common. But when you add them, you can now also order by likes on the first post, number of posters, category ID, and by number of votes when the topic voting plugin is used.
I created an icon for likes on OP so you can distinguish between likes and likes on the first post even when labels are hidden on mobile.
---
### Author:  [@eisammy](https://meta.discourse.org/u/eisammy)
#### Post date: [September 12, 2025, 2:10pm UTC](https://meta.discourse.org/t/custom-topic-sort-order-button/380530/13 "2025-09-12T14:10:28Z")
at mobile when I choose a option this modal move to top until dom loaded
It’s a UI bug?