# Customize text in Discourse

**URL:** https://meta.discourse.org/t/customize-text-in-discourse/36092
**Category:** Site Management
**Tags:** configuring, how-to, customization
**Created:** [November 27, 2015, 5:01pm UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092 "2015-11-27T17:01:54Z")
**Posts on this page:** 13
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [November 27, 2015, 5:01pm UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/1 "2015-11-27T17:01:54Z")

</div>

> 🔖 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. In the sidebar, scroll to the **Appearance** section and click **Site texts**.  
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.

 ![Screenshot 2024-07-12 customize text interface](https://global.discourse-cdn.com/meta/original/4X/f/6/4/f640ed9d2605e208c0023101de42ca5c4d9ac3c2.jpeg)

## 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:

 ![2024-07-12_customize-text-orig](https://global.discourse-cdn.com/meta/original/4X/e/d/2/ed2002893259da8ef80314e9f809198645d8f789.png)

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

 ![2024-07-12_customized-text](https://global.discourse-cdn.com/meta/original/4X/2/c/0/2c03a8bb509e2d2989db8120c055c5fb29ffe93f.png)

## Identifying translation keys

If you need help identifying the strings to translate, refer to this guide: [Find a translation key with verbose localization](https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651)

## 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:

---

<div class="post-metadata">

### Author: ![Earnie\_Baird](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/earnie_baird/32/380079_2.png) [@Earnie\_Baird](https://meta.discourse.org/u/Earnie_Baird)
#### Post date: [May 16, 2024, 5:43pm UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/75 "2024-05-16T17:43:56Z")

</div>

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

---

<div class="post-metadata">

### Author: ![Firepup650](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/firepup650/32/465200_2.png) [@Firepup650](https://meta.discourse.org/u/Firepup650)
#### Post date: [May 16, 2024, 7:57pm UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/76 "2024-05-16T19:57:13Z")

</div>

Yes, you can do so by using markdown links, eg:  
This is a [link](https://google.com) to Google!  
Which is (raw):

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

```

---

<div class="post-metadata">

### Author: ![Earnie\_Baird](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/earnie_baird/32/380079_2.png) [@Earnie\_Baird](https://meta.discourse.org/u/Earnie_Baird)
#### Post date: [May 16, 2024, 10:10pm UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/77 "2024-05-16T22:10:00Z")

</div>

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?

 ![Screenshot 2024-05-16 at 6.05.36 PM](https://global.discourse-cdn.com/meta/original/4X/4/c/3/4c34af0f817f164e66e7789681bd2c41c3d79fa4.png)

I was trying to update user\_notifications.chat\_summary.unsubscribe\_no\_link

---

<div class="post-metadata">

### Author: ![Firepup650](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/firepup650/32/465200_2.png) [@Firepup650](https://meta.discourse.org/u/Firepup650)
#### Post date: [May 16, 2024, 10:25pm UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/78 "2024-05-16T22:25:46Z")

</div>

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

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

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

```

---

<div class="post-metadata">

### Author: ![Earnie\_Baird](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/earnie_baird/32/380079_2.png) [@Earnie\_Baird](https://meta.discourse.org/u/Earnie_Baird)
#### Post date: [May 17, 2024, 2:35am UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/79 "2024-05-17T02:35:08Z")

</div>

That worked! Thank you.

---

<div class="post-metadata">

### Author: ![Firepup650](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/firepup650/32/465200_2.png) [@Firepup650](https://meta.discourse.org/u/Firepup650)
#### Post date: [May 17, 2024, 2:40am UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/80 "2024-05-17T02:40:24Z")

</div>

> [@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… 🙃

---

<div class="post-metadata">

### Author: ![CAKE\_NICE](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/cake_nice/32/400517_2.png) [@CAKE\_NICE](https://meta.discourse.org/u/CAKE_NICE)
#### Post date: [July 22, 2024, 4:31am UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/81 "2024-07-22T04:31:54Z")

</div>

We need to batch modify these records

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [July 22, 2024, 6:14am UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/82 "2024-07-22T06:14:13Z")

</div>

There is [Globally replace translations](https://meta.discourse.org/t/globally-replace-translations/315695) to replace a word everywhere.

---

<div class="post-metadata">

### Author: ![CAKE\_NICE](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/cake_nice/32/400517_2.png) [@CAKE\_NICE](https://meta.discourse.org/u/CAKE_NICE)
#### Post date: [July 22, 2024, 8:18am UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/83 "2024-07-22T08:18:27Z")

</div>

Thank you, this author is also from my country!!

---

<div class="post-metadata">

### Author: ![Isambard](https://avatars.discourse-cdn.com/v4/letter/i/858c86/32.png) [@Isambard](https://meta.discourse.org/u/Isambard)
#### Post date: [April 13, 2025, 7:01am UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/84 "2025-04-13T07:01:22Z")

</div>

![The image is a webpage error message stating "Please log-in to view this page" in English (UK) language, with options to "Save Changes" and "Back to Search." (Captioned by AI)](https://global.discourse-cdn.com/meta/original/4X/b/0/a/b0a5571ed49c51377ac817398dfcd61855c7aaaf.png)

I tried to change the text, but the ‘save changes’ button is grayed out.

---

<div class="post-metadata">

### Author: ![PCPal](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pcpal/32/455064_2.png) [@PCPal](https://meta.discourse.org/u/PCPal)
#### Post date: [April 24, 2025, 12:41pm UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/85 "2025-04-24T12:41:05Z")

</div>

I’m having trouble applying this on our Login Required welcome page. Seems it’s in a div or something, but the link seems not clickable as to be expected. How would I escape to the current window as target for the link? (Right clicking and selecting “Open this link in a new tab…” will work ofc.)

✅ Fixed:  
I used an anchor pointing to target=“\_blank” 🙂

---

<div class="post-metadata">

### Author: ![one1](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/one1/32/493591_2.png) [@one1](https://meta.discourse.org/u/one1)
#### Post date: [July 25, 2026, 11:38am UTC](https://meta.discourse.org/t/customize-text-in-discourse/36092/86 "2026-07-25T11:38:54Z")

</div>

Adding links are not working for me in `js.topics.none.education.new`. Neither markdown nor html works. They both just display the code instead of converting to a link.

Are there some strings that allow links and some that don’t? Any way that this one could?

The use case is instead of saying “check back soon!” I want to say “Go do the think that our forum is all about!” and link to that.

Obviously this is a low stakes thing, but if there is a way to easily do it, I’d like to.
