# Show categories in e-mail notifications

**URL:** https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814
**Category:** Feature
**Created:** [Março 17, 2014, 7:45pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814 "2014-03-17T19:45:54Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![downey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/downey/32/166878_2.png) [@downey](https://meta.discourse.org/u/downey)
#### Post date: [Março 17, 2014, 7:45pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/1 "2014-03-17T19:45:54Z")

</div>

As a standard Discourse user, I want to see standardized indication of the category assigned to a post when I receive e-mail notifications, so I can better prioritize what I reply to and when.

**Rationale:** We’re working really hard to migrate people from a series of several mailing lists over to Discourse, and **being able to specify categories in notifications somehow is pretty important to attracting those people who still want to live in their inbox.** If the category were specified in the subject line or an e-mail header, those people, could then automatically filter and sort notifications.

If the e-mail subject were used, perhaps the site name could be moved to the “From” field in a manner such as `"downey via My Discourse Instance <discourse-REPLYKEY@example.com>"`. The subject could then read something like “`[feature] Show categories in e-mail notifications`”.

Alternative: I know that as of today we can now customize the `email_prefix` which is a step in the right direction. 👍 Maybe it could be something as simple as the user entering a variable name in the `email_prefix` setting, so people could still use a “generic” prefix if they wish.

---

<div class="post-metadata">

### Author: ![paully21](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/paully21/32/72673_2.png) [@paully21](https://meta.discourse.org/u/paully21)
#### Post date: [Maio 7, 2014, 6:00pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/2 "2014-05-07T18:00:45Z")

</div>

This would especially be useful for Discourse implementations that are replacing mailing lists. This “feature” of mailing lists is fairly common and will be missed.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [Maio 7, 2014, 10:15pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/3 "2014-05-07T22:15:28Z")

</div>

Sorry, should have updated – this has been in for a week or two already, at least for digest emails.

---

<div class="post-metadata">

### Author: ![paully21](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/paully21/32/72673_2.png) [@paully21](https://meta.discourse.org/u/paully21)
#### Post date: [Maio 7, 2014, 11:09pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/4 "2014-05-07T23:09:57Z")

</div>

@codinghorror I just went through the git commits looking for this feature. I saw this

[https://github.com/discourse/discourse/commit/64faee09356b15d3a090b508ded4b2eddb8d6759](https://github.com/discourse/discourse/commit/64faee09356b15d3a090b508ded4b2eddb8d6759)

But, that’s not exactly what we are suggesting. As @downey indicates…The subject for the email notification of THIS post would be

> [@downey](#):
>
> [feature] Show categories in e-mail notifications

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [Maio 7, 2014, 11:19pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/5 "2014-05-07T23:19:13Z")

</div>

Would make the subject awfully noisy. I’m referring to the _body_ of the email – and the digest email in this case. Here’s a screenshot:

 ![](https://global.discourse-cdn.com/meta/original/2X/1/1987429621be11e75d05de3639c57cdcdafb1bee.png)

---

<div class="post-metadata">

### Author: ![downey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/downey/32/166878_2.png) [@downey](https://meta.discourse.org/u/downey)
#### Post date: [Maio 8, 2014, 1:09pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/6 "2014-05-08T13:09:53Z")

</div>

FWIW, my original story related to **e-mail notifications** for watched items, and **not** the digest e-mail.

There’s already a tag in the subject line. It’s just the same (e.g. installed system name) regardless of the category. My proposal would simply make it more precise.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [Maio 8, 2014, 9:31pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/7 "2014-05-08T21:31:21Z")

</div>

It’s [burying the lede](http://en.wiktionary.org/wiki/bury_the_lede) hard though:

So we go from email titles in the form of

> [sitename] Topic title

to

> [sitename] [category] Topic title

I just think category can be present in the body – pushing the real, actual title of the topic that far over will make it invisible on mobile mail clients, for example..

---

<div class="post-metadata">

### Author: ![downey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/downey/32/166878_2.png) [@downey](https://meta.discourse.org/u/downey)
#### Post date: [Maio 9, 2014, 1:09am UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/8 "2014-05-09T01:09:33Z")

</div>

Actually if you re-read my first post, you’ll see that I suggested **only category** in subject, and possibly site name in “From” field, and/or use of headers. People need a standardized way to know what a notification is about because the post title (subject line) is not in a structured format.

No one’s going to open an e-mail to see the category and determine whether or not to read it. By that point, the damage is done and the time is wasted. 😉

---

<div class="post-metadata">

### Author: ![piecritic](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/piecritic/32/31278_2.png) [@piecritic](https://meta.discourse.org/u/piecritic)
#### Post date: [Maio 29, 2014, 12:10pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/9 "2014-05-29T12:10:45Z")

</div>

I agree with @downey, it’s a useful feature and something we need to allow replacing mailing lists in our organisation for people who don’t want to use digests exclusively or at all.

If you make email prefix accept flags for %sitename% and %category%, then you can let the admin determine what works best. I know in our case it’d end up being something like [foo-%category%] so it’d end up being like:

> [foo-general] Amazing thing happens!

Not verbose, and makes it clear that it’s a category related to that organisation. People can then mute the categories they have no interest in seeing in their preferences and bam, you’ve fully emulated a mailing list.

This is a killer feature for us, basically.

---

<div class="post-metadata">

### Author: ![downey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/downey/32/166878_2.png) [@downey](https://meta.discourse.org/u/downey)
#### Post date: [Maio 29, 2014, 1:27pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/10 "2014-05-29T13:27:20Z")

</div>

> [@piecritic](#):
>
> Not verbose, and makes it clear that it’s a category related to that organisation. People can then mute the categories they have no interest in seeing in their preferences and bam, you’ve fully emulated a mailing list.
> 
> This is a killer feature for us, basically.

This is a top – if not the #1 – limiter of people moving from our lists to Discourse in our project (1000+ people). If we don’t have a comfortable migration path for people who prefer to live in their e-mail inbox (I’m not one of them) we’re never going to reach critical mass of uptake for Discourse.

---

<div class="post-metadata">

### Author: ![ida](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ida/32/114322_2.png) [@ida](https://meta.discourse.org/u/ida)
#### Post date: [Junho 3, 2014, 4:37pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/11 "2014-06-03T16:37:37Z")

</div>

I am a member of the Plone community and we are right in the process to switch of the former mailinglists to Discourse. There’s just this culprit left to solve, to get it going.  
Filtering mails by categories is uttermost crucial for us, we are already facing huge acceptance problems because of this, and it would be really sad, if all the done work of the people setting up Discourse for us, would have been useless only because of this single issue, besides of missing all the awesome additional features Discourse offers.

Will it be possible soon, to include the category somewhere in mails (preferably in the subject) ?

---

<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: [Junho 3, 2014, 5:20pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/12 "2014-06-03T17:20:48Z")

</div>

> [@downey](#):
>
> This is a top – if not the #1 – limiter of people moving from our lists to Discourse in our project (1000+ people). If we don’t have a comfortable migration path for people who prefer to live in their e-mail inbox (I’m not one of them) we’re never going to reach critical mass of uptake for Discourse.

I could have quoted a number of posts in this topic for this, but my impression so far of Discourse is that when migrating mailman lists to discourse, each mailman list with its own already email-connected community and established list owners/moderators should get its own discourse install, not just one category in a big discourse install with lots of categories. That way you can let them have full freedom within that community to create whatever categories to organize their discussions and to manage their community rather than forcing them to be part of something bigger and see things from other migrated lists that they potentially have nothing to do with.

The architecture of discourse doesn’t really support the traditional setup where one organization hosts dozens or hundreds of mailman lists, and I’m not sure it’s going to ever make those people happy who just want to live in their email. We can tinker around the edges to make the subject line more customizable, but the tension between what forums need vs what lists need will always be there and I for one would hope that the forum will always win. 🙂

> [@piecritic](#):
>
> People can then mute the categories they have no interest in seeing in their preferences and bam, you’ve fully emulated a mailing list.

This is a bit optimistic - there are other big differences that people who favor email will not be happy with, like the fact that quoted text and forwarded emails get filtered out and don’t get distributed/make it to the forum. You can’t manage your subscription by email, query mailman servers by email to get info, you can’t deduce the email address to reach the moderator etc.

> [@ida](#):
>
> Will it be possible soon, to include the category somewhere in mails (preferably in the subject) ?

Is it not already in the body of the message, right next to the post title?

---

<div class="post-metadata">

### Author: ![downey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/downey/32/166878_2.png) [@downey](https://meta.discourse.org/u/downey)
#### Post date: [Junho 3, 2014, 6:27pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/13 "2014-06-03T18:27:58Z")

</div>

> [@tobiaseigen](#):
>
> I could have quoted a number of posts in this topic for this, but my impression so far of Discourse is that when migrating mailman lists to discourse, each mailman list with its own already email-connected community and established list owners/moderators should get its own discourse install, not just one category in a big discourse install with lots of categories. That way you can let them have full freedom within that community to create whatever categories to organize their discussions and to manage their community rather than forcing them to be part of something bigger and see things from other migrated lists that they potentially have nothing to do with.

This is not an accurate representation of large projects with multiple lists. In such projects, lists _are_ the categories. Discourse email integration has recognized this allowing unique incoming email addresses per category. Now we’re just asking for parity on the outbound side by allowing users to filter notifications per category using a subject line or email header, just like lists afford.

There is immense cross-pollination value in keeping all the conversation in a project in one place. Identifying email notifications by category helps make that happen for people who want email notifications from Discourse. Splitting lists/categories into multiple installations would be a giant step in the wrong direction.

---

<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: [Junho 3, 2014, 6:40pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/14 "2014-06-03T18:40:00Z")

</div>

Thanks for taking the time to explain. Each community has its own internal logic and culture, so I shouldn’t be making any assumptions about yours. 🙂 But be prepared to start managing expectations as users start to realize all the things they miss from mailman!

I agree that having the subject line customizable along the lines suggested by @piecritic:

> [@piecritic](#):
>
> If you make email prefix accept flags for %sitename% and %category%, then you can let the admin determine what works best.

I like this suggestion. If I had this option I would also only put the category in the email subject in square brackets, e.g. [volunteers] for notifications form the volunteers category. If there are no categories, the subject prefix would be left out altogether.

… but for my community what’s on the subject line is not a deal killer, since the categories are highlighted very nicely inside the message.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [Junho 4, 2014, 3:49am UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/15 "2014-06-04T03:49:26Z")

</div>

@eviltrout can you implement a configurable substitution scheme string for email titles this week including {category}, {sitename}, {topictitle}, etc? Just the title of notification emails should be configurable in this manner.

---

<div class="post-metadata">

### Author: ![piecritic](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/piecritic/32/31278_2.png) [@piecritic](https://meta.discourse.org/u/piecritic)
#### Post date: [Junho 10, 2014, 3:08pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/16 "2014-06-10T15:08:21Z")

</div>

Thanks so much for this. 🙂

---

<div class="post-metadata">

### Author: ![peternlewis](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/peternlewis/32/108888_2.png) [@peternlewis](https://meta.discourse.org/u/peternlewis)
#### Post date: [Junho 14, 2014, 2:47pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/17 "2014-06-14T14:47:42Z")

</div>

OK, clearly @eviltrout has this in hand, so I’ll leave this alone for now (contact me if I can help). Hopefully my comments at [Email subject configuration options](https://meta.discourse.org/t/email-subject-configuration-options/16530) and/or my pull request code with adding the “Re:” are useful.

I would add to please include with the configurable subject lines the option to include the “Re:” in replies, which I am pretty sure is part of the requirement for Mail.app to thread properly (stupid though that may be).

Also, with the addition of a List-Id header, there is no real necessity for the [Site Title] in the subject line, which makes the option of just using a subject with just the [category] much more appealing.

Thanks!

---

<div class="post-metadata">

### Author: ![downey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/downey/32/166878_2.png) [@downey](https://meta.discourse.org/u/downey)
#### Post date: [Junho 19, 2014, 3:08pm UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/18 "2014-06-19T15:08:54Z")

</div>

> [@peternlewis](#):
>
> I would add to please include with the configurable subject lines the option to include the “Re:” in replies, which I am pretty sure is part of the requirement for Mail.app to thread properly (stupid though that may be).

I suppose that’s a worthy goal, but keep in mind [Mail.app has only a 7% market share](http://emailclientmarketshare.com/). I don’t know how the other clients handle threading but it’d be worth trying to get it right wherever possible.

> [@peternlewis](#):
>
> Also, with the addition of a List-Id header, there is no real necessity for the [Site Title] in the subject line, which makes the option of just using a subject with just the [category] much more appealing.

That’s true, but it also makes the category unnecessary as well. As I understand [RFC 2919](http://www.ietf.org/rfc/rfc2919.txt) the List-Id should be as specific as possible, e.g. `List-Id: <category.discourse.example.com>`. This becomes especially true since the system allows unique email addresses for each category. At least that’s how I process it in my mind.

---

<div class="post-metadata">

### Author: ![peternlewis](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/peternlewis/32/108888_2.png) [@peternlewis](https://meta.discourse.org/u/peternlewis)
#### Post date: [Junho 20, 2014, 3:15am UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/19 "2014-06-20T03:15:28Z")

</div>

> [@downey](#):
>
> I suppose that’s a worthy goal, but keep in mind Mail.app has only a 7% market share

In general, perhaps. For my mailing list, its probably more like 90+%.

> [@downey](#):
>
> As I understand RFC 2919 the List-Id should be as specific as possible, e.g. List-Id: \<category.discourse.example.com\>

Given there are definitely people who have said that they are using or plan to use Discourse in a way where each category is conceptually a separate mailing list, I completely agree that should be an option.

It should be possible to configure Discourse such that it behaves as:

- A single community, a single mailing list, with a single list ID.
- A group of communities, a group of mailing lists, each with their own list ID.

In either case, optionally including the category in the subject may be desirable, and optionally not including the site title in the subject may be desirable.

---

<div class="post-metadata">

### Author: ![ida](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ida/32/114322_2.png) [@ida](https://meta.discourse.org/u/ida)
#### Post date: [Junho 26, 2014, 7:02am UTC](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814/20 "2014-06-26T07:02:36Z")

</div>

Thanks for getting this started! Has there been some progress by now, can we start to open the champagne-bottles? We’re really eager to kick it off, and tell every Plone-nut about it ☀

[Próxima página](https://meta.discourse.org/t/show-categories-in-e-mail-notifications/13814.md?page=2)
