# Customize new topic button text
**URL:** https://meta.discourse.org/t/customize-new-topic-button-text/269086
**Category:** Theme component
**Tags:** official, topic-button-text
**Created:** [June 20, 2023, 9:11pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086 "2023-06-20T21:11:06Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [June 20, 2023, 9:11pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/1 "2023-06-20T21:11:06Z")
| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | Customize the new topic button per category or tag |
| š | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/customize-new-topic-button) |
| š | **Repository** | [https://github.com/discourse/discourse-customize-new-topic-button-text](https://github.com/discourse/discourse-customize-new-topic-button-text) |
| ā | **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
> [@](#):
>
> :discourse2: As this is an #official theme component maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate theme component tag. Click on a link below to get one started. š
>
> [ā **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=topic-button-text "Ask for support on configuring and using this theme component") [š **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=topic-button-text "A bug report means something is broken, preventing normal/typical use of the theme component") [š **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=topic-button-text "Discussion about the user interface of this theme component, and how features are presented (including language and UI elements)") [š” **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=topic-button-text "Discussion about how existing features of this theme component can be improved or enhanced, and how proposed new features could work")
### Features
This theme component allows you to customize the New Topic button on a category or tag topic list as well as the action name and button in the composer (highlighted below). If you have a #Contribute > Bug category, for example, you can update these texts to say āReport Bugā:
(Some icons may need to be added to your `svg icon subset` admin setting)
You can also customize the reply button text, this will replace the `reply` text in the composer and within topics:
### Settings
| Name | Description |
| --- | --- |
| custom new topic text | This is where you enter the details for each customized button |
| inherit parent category | When disabled, subcategories will not automatically inherit the parent category text |
There are two settings, the primary being `custom new topic text`:
This setting allows you to set the filter (tag or category name), the icon for the āNew Topicā button (this doesnāt change the icons in the composer), as well as the action name at the top of the composer, and the composerās āCreate Topicā button.
Thereās an additional setting, enabled by default, called `inherit parent category`. When this is enabled all child categories will also have their text changed (unless otherwise specified in the settings).
> ā¹ Note that if you set up a tag it will override the selected category.
### š” Ideas for future enhancements
- Localizable text for different languages
- Support for category and tag combinations, and multiple tags
> :discourse2: **Hosted by us?** Theme components are available to use on our Standard, Business, and Enterprise plans.
> Last edited by @JammyDodger 2024-06-11T22:21:54Z
>
> > **Check document**
> >
> > Perform check on document:
---
### Author:  [@inj3ct0r](https://meta.discourse.org/u/inj3ct0r)
#### Post date: [June 20, 2023, 9:35pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/2 "2023-06-20T21:35:55Z")
Thaāts really good, Thanks alot \<3
---
### Author:  [@gormus](https://meta.discourse.org/u/gormus)
#### Post date: [July 6, 2023, 8:42pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/3 "2023-07-06T20:42:52Z")
Today, I was working on a much simpler version of this using `api.customizeComposerText()` š
This is a so much better solution. Thank you @awesomerobot!
In my experiments, I was never able to override the Composer button label for the categories using the [discourse-post-voting](https://meta.discourse.org/t/discourse-post-voting/227808) plugin. This becomes a bigger issue when multiple categories are enabled for post voting.
> [@awesomerobot](#):
>
> Ideas for future enhancement:
If I may suggest; enabling support for overriding `discourse-post-voting` labels, would be a great enhancement. ( :
---
### Author:  [@jordan-violet](https://meta.discourse.org/u/jordan-violet)
#### Post date: [July 10, 2023, 4:55pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/4 "2023-07-10T16:55:07Z")
This is a great theme component! An idea to take it a step further could be this:
If you are renaming the button because you effectively want to change what the type of topic is, then you should change the naming throughout the entire \*category.
For example:
You have a category called `Events`. You would effectively change the word ātopicā in the entire category to āeventsā. Itās not āNew Topicā its āNew Eventā, instead of a Topics list youād have an Events list, etc.
You see this in other tools where you change the primary use case of something. Here is what AirTable does when you create a new table. Tables, by default, have ārecordsā.
But letās say I want to create a table called āUsersā, then I can change each record to be called Users:
Treating the theme component this way would allow us to easily, effectively rebrand a category as a more specific entity. Support Requests, Events, etc.
I found this theme component when searching, because I wanted to change this word for āTopicā to āEventsā:
---
### Author:  [@jordan-violet](https://meta.discourse.org/u/jordan-violet)
#### Post date: [August 2, 2023, 11:49pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/5 "2023-08-02T23:49:09Z")
@awesomerobot this theme component is seriously incredible, thank you so much for it!
Iām noticing that this theme component seems to cause some odd behavior with the css for the New Topic button.
Theme component disabled:
Theme component enabled:
* * *
Iāve also noticed that while it changes the āCreate Topicā button in the composer, which is awesomeā¦
It also changes the _Reply_ button text to that same string, which is less than ideal because itās not creating another bug report, itās a reply š
What are the chances another field could be added to the editor to change the reply button text (or leave it blank to leave it as `Reply`?
---
### Author:  [@jordan-violet](https://meta.discourse.org/u/jordan-violet)
#### Post date: [August 3, 2023, 12:53am UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/6 "2023-08-03T00:53:17Z")
Sorry, one last thing: this also does not seem to respect the case where two subcategories (each of a different parent) have the same slug. e.g.:
- parent1
- sub1
- parent2
- sub1
In this case, I cannot get the theme component to differentiate between the two subcategories, and they both share the same configuration from the editor.
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [September 11, 2023, 8:14pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/7 "2023-09-11T20:14:37Z")
Thanks for the feedback, Iāve made some updates! [FIX: action, switch category to ID, ignore replies by awesomerobot Ā· Pull Request #5 Ā· discourse/discourse-customize-new-topic-button-text Ā· GitHub](https://github.com/discourse/discourse-customize-new-topic-button-text/pull/5)
> [@jordan-violet](#):
>
> It also changes the _Reply_ button text to that same string, which is less than ideal because itās not creating another bug report, itās a reply š
I completely overlooked the reply button! For now Iāve just kept it as `reply`, but a separate setting to change its text would make sense.
> [@jordan-violet](#):
>
> In this case, I cannot get the theme component to differentiate between the two subcategories, and they both share the same configuration from the editor.
Good point, it seems like utilizing the category ID rather than the category name in the settings would be the best way to avoid this. So this means any existing settings you have in place will need to be updated.
---
### Author:  [@jordan-violet](https://meta.discourse.org/u/jordan-violet)
#### Post date: [November 1, 2023, 3:23am UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/8 "2023-11-01T03:23:29Z")
It seems thereās a new bug. When this plugin is enabled, it creates two topic buttons:
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [November 1, 2023, 4:44pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/9 "2023-11-01T16:44:56Z")
Yes, thanks for reporting it, some connectors changed in Discourse ā should be fixed now if you update:
[https://github.com/discourse/discourse-customize-new-topic-button-text/pull/8](https://github.com/discourse/discourse-customize-new-topic-button-text/pull/8)
---
### Author:  [@jordan-violet](https://meta.discourse.org/u/jordan-violet)
#### Post date: [November 1, 2023, 7:50pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/10 "2023-11-01T19:50:18Z")
Is it possible to fix the button size difference? (old screenshot, your newest update fixed the double-button issue)
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [November 2, 2023, 8:09pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/11 "2023-11-02T20:09:20Z")
Yes, this button should be the correct height now
---
### Author:  [@sunjam](https://meta.discourse.org/u/sunjam)
#### Post date: [November 3, 2023, 4:46pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/12 "2023-11-03T16:46:01Z")
> **Hmm attempting to use this component unsuccessfully and seeing a lot of warnings in my logs like this one.**
>
> Message (4 copies reported)
>
> [DiscourseJsProcessor] DEPRECATION: Using {{attrs}} to reference named arguments has been deprecated. {{attrs.canCreateTopic}} should be updated to {{@canCreateTopic}}. (ādiscourse/components/custom-new-topic-button.hbsā @ L2:C8) [deprecation id: attrs-arg-access] See [Ember.js - Deprecations](https://deprecations.emberjs.com/v3.x/#toc_attrs-arg-access) for more details.
> at theme-transpiler.js:3164:26752
> at j. (theme-transpiler.js:3168:1693)
> at theme-transpiler.js:3168:161
> at j. (theme-transpiler.js:3168:1693)
> at D (theme-transpiler.js:3168:1754)
> at te (theme-transpiler.js:3168:1318)
> at PathExpression (theme-transpiler.js:3198:21763)
> at yo (theme-transpiler.js:3187:2776)
> at Al (theme-transpiler.js:3187:3513)
> at Ml (theme-transpiler.js:3187:3309)
> at yo (theme-transpiler.js:3187:3013)
> at Al (theme-transpiler.js:3187:3513)
> at Ml (theme-transpiler.js:3187:3309)
> at yo (theme-transpiler.js:3187:3013)
> at Ml (theme-transpiler.js:3187:3350)
> at yo (theme-transpiler.js:3187:3013)
> at Al (theme-transpiler.js:3187:3513)
> at Ml (theme-transpiler.js:3187:3309)
> at yo (theme-transpiler.js:3187:3013)
> at Bi (theme-transpiler.js:3187:3879)
> at PA (theme-transpiler.js:3190:3002)
> at Cf (theme-transpiler.js:3190:9856)
> at Al (theme-transpiler.js:3176:35353)
> at gf (theme-transpiler.js:3176:35600)
> at D (theme-transpiler.js:3198:42250)
> at Sft.o.precompile (theme-transpiler.js:3281:3078)
> at dDe (theme-transpiler.js:3161:1003)
> at e.CallExpression (theme-transpiler.js:3159:33796)
> at h (theme-transpiler.js:10:111797)
> at e.uPe [as \_call] (theme-transpiler.js:59:16906)
> at e.oPe [as call] (theme-transpiler.js:59:16726)
> at e.lPe [as visit] (theme-transpiler.js:59:17700)
> at t.visitQueue (theme-transpiler.js:59:40645)
> at t.visitSingle (theme-trā¦
>
> Backtrace
>
> /var/www/discourse/lib/discourse\_js\_processor.rb:133:in `block in create_new_context' mini_racer-0.8.0/lib/mini_racer.rb:273:in `block in attachā
> mini\_racer-0.8.0/lib/mini\_racer.rb:242:in `call_unsafe' mini_racer-0.8.0/lib/mini_racer.rb:242:in `block (2 levels) in callā
> mini\_racer-0.8.0/lib/mini\_racer.rb:369:in `timeout' mini_racer-0.8.0/lib/mini_racer.rb:241:in `block in callā
> mini\_racer-0.8.0/lib/mini\_racer.rb:240:in `synchronize' mini_racer-0.8.0/lib/mini_racer.rb:240:in `callā
> /var/www/discourse/lib/discourse\_js\_processor.rb:168:in `block in v8_call' /var/www/discourse/lib/discourse_js_processor.rb:167:in `synchronizeā
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [November 3, 2023, 5:45pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/13 "2023-11-03T17:45:30Z")
Hmm strange, I tested it on the latest Discourse and everythingās working fine ā Iāve just merged an update to the component that will solve that deprecation issue, can you update and try again?
---
### Author:  [@Rahul\_Deshpande1](https://meta.discourse.org/u/Rahul_Deshpande1)
#### Post date: [November 8, 2023, 10:21am UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/14 "2023-11-08T10:21:28Z")
Same here, its not showing up after multiple trys.
---
### Author:  [@kinetiksoft](https://meta.discourse.org/u/kinetiksoft)
#### Post date: [November 8, 2023, 2:02pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/15 "2023-11-08T14:02:18Z")
Unfortunately, this wonderful theme component does not seem to work along nicely with [Custom Wizard Plugin š§](https://meta.discourse.org/t/custom-wizard-plugin/73345)
The Wizard plugin is able to hook to the category button via Category settings:
When using your Component, the button changes itās name, but pressing it no longer launches Wizard selected in the category settings. We would be glad to use your component in big production website, but unable now. Hope it could be fixed. No pressure š
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [November 9, 2023, 1:52am UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/16 "2023-11-09T01:52:14Z")
> [@kinetiksoft](#):
>
> Unfortunately, this wonderful theme component does not seem to work along nicely with [Custom Wizard Plugin](https://meta.discourse.org/t/custom-wizard-plugin/73345)
Iām not seeing this, I have the same setup and my buttons work. You may need to look at other plugins or TCās. Iām on the latest builds FYI.
---
### Author:  [@mattdm](https://meta.discourse.org/u/mattdm)
#### Post date: [December 6, 2023, 3:11pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/17 "2023-12-06T15:11:15Z")
This is a nice little component that can add some nice attention-to-detail polish to a site.
---
### Author:  [@Stephane\_Roy](https://meta.discourse.org/u/Stephane_Roy)
#### Post date: [January 5, 2024, 5:54pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/18 "2024-01-05T17:54:56Z")
Hello
I think I have a bug.
The text of the āNew Topicā button can no longer be modified.
The modification is effective for the other buttons.
Version: 3.2.0.beta4-dev([4886c1fddc]
> **[Conventions JdR](https://forums.ffjdr.org/c/e-irl/14/l/latest)**
>
> Ā« Carte Ā» pour une carte de France des conventionsā¦
> Ā« Agenda Ā» pour une liste chronologique.
> ..Ajoutez les conventions de votre rƩgion !!
> ProcƩdure et conseils via:
Thank you for your help (and for these functions!)
---
### Author:  [@Arkshine](https://meta.discourse.org/u/Arkshine)
#### Post date: [January 5, 2024, 7:46pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/19 "2024-01-05T19:46:09Z")
Thanks for the report!
It looks like there is a regression from the latest PR:
[https://github.com/discourse/discourse-customize-new-topic-button-text/commit/15954ca84422a1a4f97b4df2ab88e58fa4b1fea1#diff-d1de88ab81683e5f2b5734cdd274610d0281672f788757cf889c7d39039b4452](https://github.com/discourse/discourse-customize-new-topic-button-text/commit/15954ca84422a1a4f97b4df2ab88e58fa4b1fea1#diff-d1de88ab81683e5f2b5734cdd274610d0281672f788757cf889c7d39039b4452)
It converts from the `this.args..` to `@` syntax; however, the former is required since we are inside a plugin outlet.
EDIT: I made a PR š
[https://github.com/discourse/discourse-customize-new-topic-button-text/pull/11](https://github.com/discourse/discourse-customize-new-topic-button-text/pull/11)
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [January 5, 2024, 9:55pm UTC](https://meta.discourse.org/t/customize-new-topic-button-text/269086/20 "2024-01-05T21:55:04Z")
Thanks for the PR @Arkshine! this should be fixed on update
> [@jordan-violet](#):
>
> What are the chances another field could be added to the editor to change the reply button text (or leave it blank to leave it as `Reply`?
This will also be included on update: [FEATURE: add ability to customize "Reply" text by 3-w-c Ā· Pull Request #7 Ā· discourse/discourse-customize-new-topic-button-text Ā· GitHub](https://github.com/discourse/discourse-customize-new-topic-button-text/pull/7)
So now the option to also customize the reply button text in the composer and on posts (still based on tag and category) will be included.
[Next page](https://meta.discourse.org/t/customize-new-topic-button-text/269086.md?page=2)