Customize text in Discourse

[Discourse]

This is a guide for customizing text in Discourse via the admin interface, enabling changes to various UI elements.

Required user level: Administrator

In Discourse, you can customize all of the text via the admin interface. This can be useful for tailoring the user experience to better fit the particular tone or branding of your community.

Summary

This guide will cover:

• Accessing the text customization interface
• Editing text strings
• Identifying translation keys

Accessing the text customization interface

To customize the text in Discourse, navigate to the text customization page:

1. Go to Admin.
2. Search for site text in the sidebar search.
   OR
   Enter the URL of the screen directly https://discourse.example.com/admin/customize/site_texts

You will be presented with a page where you can search for specific text strings to edit.

Editing text strings

To edit a text string:

1. Search for the text you want to customize.
2. Click Edit.
3. Enter the new value.

For example, you might want to personalize the “About Your Site” link:

After making changes and refreshing the page, the text will be updated:

Identifying translation keys

If you need help identifying the strings to translate, refer to this guide: Find a translation key with verbose localization

FAQs

Can I customize all text in Discourse including system messages?
Yes, you can customize almost all text strings, including system messages, notifications, and UI elements.

Do I need to refresh the page to see changes?
Yes, after making changes, you’ll need to refresh the page for the updated text to appear.

Last edited by @Moin 2024-07-22T06:11:29Z

Check document

Perform check on document:

[Earnie_Baird]

is there any way to add a hyperlink to custom text?

[Firepup650 (Firepup Sixfifty)]

Yes, you can do so by using markdown links, eg:
This is a link to Google!
Which is (raw):

This is a [link](https://google.com) to Google!

[Earnie_Baird]

Thank you @Firepup650. I’m trying to update some footer text in one of the emails and when I cut and paste your line it displays like below. Maybe these markdown links don’t work on the emails?

I was trying to update user_notifications.chat_summary.unsubscribe_no_link

[Firepup650 (Firepup Sixfifty)]

Hm. Perhaps the email templates are different. Could you try raw HTML instead?

This is a link to Google!
Which is (raw):

This is a <a href="https://google.com/">link</a> to Google!

[Earnie_Baird]

That worked! Thank you.

[Firepup650 (Firepup Sixfifty)]

@Discourse

I changed the “Dashboard” link to say “Evil Trout” here on Meta

I wonder if that was still the case until the new admin sidebar…

[CAKE_NICE]

We need to batch modify these records

[Moin]

There is Globally replace translations to replace a word everywhere.

[CAKE_NICE]

谢谢，这个作者还是来自我的国家！！