# איך משתמשים בערכי \`system\_messages.welcome\_user.\*\`?

**URL:** https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659
**Category:** Support
**Created:** [16 בפברואר,‏ 2024,‏ 7:07pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659 "2024-02-16T19:07:16Z")
**Posts on this page:** 12
**Page:** 1

<div class="post-metadata">

### Author: ![ganncamp](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ganncamp/32/106199_2.png) [@ganncamp](https://meta.discourse.org/u/ganncamp)
#### Post date: [16 בפברואר,‏ 2024,‏ 7:07pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/1 "2024-02-16T19:07:16Z")

</div>

I thought the `system_messages.welcome_user.*` fields formed an email, but I signed up with my personal account and never received this welcome. (I’ve checked spam.)

Is this vestigial? If not, where should I be looking?

---

<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: [16 בפברואר,‏ 2024,‏ 7:39pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/2 "2024-02-16T19:39:42Z")

</div>

I think it is the first message you receive from discobot.

 ![Screenshot_20240216_203049_Chrome](https://global.discourse-cdn.com/meta/original/4X/1/f/8/1f853ea807fc9da31cd89b3b61cc53377cb500fd.jpeg)  
I also found

> [@Can't find discobot welcome message text](https://meta.discourse.org/t/cant-find-discobot-welcome-message-text/111034/5):
>
> The message you are looking for is made up of two parts. The first part is system\_messages.welcome\_user.text\_body\_template and the second part is system\_messages.usage\_tips.text\_body\_template. For reference, this is the notification that is sent to new users when the discourse narrative bot welcome post type Site Setting is set to ‘Send all new users a welcome message with a quick start guide.’

---

<div class="post-metadata">

### Author: ![ganncamp](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ganncamp/32/106199_2.png) [@ganncamp](https://meta.discourse.org/u/ganncamp)
#### Post date: [16 בפברואר,‏ 2024,‏ 7:46pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/3 "2024-02-16T19:46:24Z")

</div>

> [@Moin](#):
>
> I think it is the first message you receive from discobot.

They don’t match:

 ![Selection_1591](https://global.discourse-cdn.com/meta/original/4X/d/4/2/d42007fa5a4e4b3e55bd6b5f06b6b40dec2355ef.png)

 ![Selection_1592](https://global.discourse-cdn.com/meta/original/4X/a/9/d/a9d2b7687d47ab3312776f906fa6edb849c080c4.png)

Plus, [this is apparently](https://meta.discourse.org/t/what-do-macros-decode-to/295375/4) the `%{new_user_tips}`

 ![Selection_1593](https://global.discourse-cdn.com/meta/original/4X/e/b/0/eb05fbc095465430e3954d8177c08f1f9ff1722a.png)

---

<div class="post-metadata">

### Author: ![supermathie](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/supermathie/32/507518_2.png) [@supermathie](https://meta.discourse.org/u/supermathie)
#### Post date: [16 בפברואר,‏ 2024,‏ 7:59pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/4 "2024-02-16T19:59:23Z")

</div>

> [@Moin](#):
>
> the first message you receive from discobot

by default, is `discourse_narrative_bot.new_user_narrative.hello.message` [here](https://github.com/discourse/discourse/blob/main/plugins/discourse-narrative-bot/config/locales/server.en.yml#L169)

> [@ganncamp](#):
>
> I thought the `system_messages.welcome_user.*` fields formed an email

This one is used when you have `discourse_narrative_bot_welcome_post_type` set to “send all new users a welcome message” which is not the default.

---

<div class="post-metadata">

### Author: ![ganncamp](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ganncamp/32/106199_2.png) [@ganncamp](https://meta.discourse.org/u/ganncamp)
#### Post date: [19 בפברואר,‏ 2024,‏ 3:21pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/5 "2024-02-19T15:21:24Z")

</div>

Thanks @supermathie! That’s super-helpful.

Is there some sort of guide or other resource I missed on all this? Or was I supposed to “just know” that’s how it all worked? 😖

---

<div class="post-metadata">

### Author: ![supermathie](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/supermathie/32/507518_2.png) [@supermathie](https://meta.discourse.org/u/supermathie)
#### Post date: [19 בפברואר,‏ 2024,‏ 3:22pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/6 "2024-02-19T15:22:30Z")

</div>

I had to go digging through the code to find the answers; I’m flagging this for our “Admin UX” improvement project.

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [5 במרץ,‏ 2024,‏ 7:43pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/9 "2024-03-05T19:43:09Z")

</div>

I agree the UI around enabling/disabling/customizing discobot is confusing.

Discobot is a core feature, and it’s called “narrative bot” in the admin settings. We did at some point add discobot to the description so it does show up when searching for it.

![The image shows a user interface with a checkbox labeled "Enable Discourse Narrative Bot (discobot)" that is checked. (Captioned by AI)](https://global.discourse-cdn.com/meta/original/4X/3/c/4/3c4387315c88b9d4dc2a8c454dccff40d6ef9876.png)

The rest of the admin settings are only discoverable if you search for “narrative bot” and not by searching for discobot. We can fix this.

 ![The image shows a settings page for the Discourse Narrative Bot with options to enable or disable the bot, configure welcome post settings, and manage user interaction preferences. (Captioned by AI)](https://global.discourse-cdn.com/meta/original/4X/0/b/6/0b6f934ae3dd549ed88471fb88f7babe0b14d887.png)

There are three modes for discobot to help onboard new users, which I think are fairly apparent once you can see all the narrative bot settings.

1. No welcome PM at all from discobot
2. Interactive welcome PM from discobot
3. Non-interactive welcome PM from discobot

Customizing text is fairly advanced and you have to typically do a lot of digging to figure out how to change specific text. I don’t recommend sites try to edit the interactive welcome PM because it is fairly fragile and easy to break.

I can definitely see why sites would want to edit the non-interactive welcome PM, which is certainly hard to find. We could improve the discoverability. It happens here:

 ![Screenshot 2024-03-05 at 11.17.42 AM](https://global.discourse-cdn.com/meta/original/4X/3/9/4/394df7d4ba8079f7cc97627bbbc7c9638bb94a14.png)

The included `%(new_user_tips)` are furthermore editable, and are somewhat dated. We have been removing links to the blog from discourse:

 ![Screenshot 2024-03-05 at 11.20.17 AM](https://global.discourse-cdn.com/meta/original/4X/b/6/4/b64a40035ef6d7a58c21e6ceb2c8871fb9ae9cc9.png)

I think the todo here is along these lines:

1. improve narrative bot (discourse) admin setting descriptions
  - make sure they are discoverable also using “discobot” search term
  - take the opportunity to explain what the feature does and how it works
  - provide links to text customization where appropriate
  - link to documentation topic on meta (see 3)

2. improve the default text for the non-interactive welcome PM
  - update `%(new_user_tips)` text or replace it with actual text

3. write new documentation topic on meta that explains how the feature works in more detail and how it can be customized

---

<div class="post-metadata">

### Author: ![ganncamp](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ganncamp/32/106199_2.png) [@ganncamp](https://meta.discourse.org/u/ganncamp)
#### Post date: [5 במרץ,‏ 2024,‏ 8:15pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/10 "2024-03-05T20:15:49Z")

</div>

Okay, so first, I’m 1000% for normalizing Discobot vs “narrative bot”, and I’m up for your numbered list at the end.

And why do I have to choose between Discobot and sending an email? That’s what I wanted to do: send new users an email.

Discobot teaches people how to use Discourse (BTW, in surveying my two Community Management colleagues… only one of the three of us started the DB tutorial and 0 of us finished it.)

The Discobot interactions aren’t configurable, AFAIK. Sure, I can maybe edit the message about reactions to say something else, but regardless of what I make the message say, DB is still going to expect a ❤

An email would allow me to say things like, oh I don’t know

> As you participate here, we’ll get to know you and temporary new user limitations will be lifted. Over time you’ll gain trust levels that include special abilities…

Why can’t I do both?

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [5 במרץ,‏ 2024,‏ 9:04pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/11 "2024-03-05T21:04:54Z")

</div>

> [@ganncamp](#):
>
> Why can’t I do both?

Do you have Automation installed on your site? You could always create an automation to send a PM when someone signs up.

---

<div class="post-metadata">

### Author: ![ganncamp](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ganncamp/32/106199_2.png) [@ganncamp](https://meta.discourse.org/u/ganncamp)
#### Post date: [6 במרץ,‏ 2024,‏ 12:37pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/12 "2024-03-06T12:37:26Z")

</div>

It’s not in my list of Plugins. Do y’all even allow that on hosted sites?

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [6 במרץ,‏ 2024,‏ 4:10pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/13 "2024-03-06T16:10:46Z")

</div>

We do indeed. 🙂 It’s an #official one available on the Business and Enterprise plans. 👍

> [@Discourse Automation](https://meta.discourse.org/t/discourse-automation-plugin/195773):
>
> discourse2Summary Discourse Automation lets you automate actions through scripts and triggers. Customisation is made through an automatically generated UI.open_bookInstall Guide This plugin is bundled with Discourse core. There is no need to install the plugin separately. Features Easy automation of complex workflows Triggers automations at specific dates, periodically, or on specific events Provides automatically generated UIs…

Do you want me to hook you up?

---

<div class="post-metadata">

### Author: ![ganncamp](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ganncamp/32/106199_2.png) [@ganncamp](https://meta.discourse.org/u/ganncamp)
#### Post date: [6 במרץ,‏ 2024,‏ 5:23pm UTC](https://meta.discourse.org/t/how-are-system-messages-welcome-user-values-used/295659/14 "2024-03-06T17:23:44Z")

</div>

Yeah! Hook me up! 😃
