Reply Template

[Discourse]

	Summary	Reply Template will let you easily reuse part of a post in a reply or a new topic.
	Preview	Preview on Discourse Theme Creator
	Repository Link	https://github.com/discourse/discourse-reply-template-component
	New to Discourse Themes?	Beginner’s guide to using Discourse Themes

Install this theme component

As this is an official theme component maintained by the Discourse team, Support, Bug, UX, and 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  Bug  UX  Feature

Features

Reply Template will let you easily reuse part of a post in a reply or a new topic.

Usage

[wrap=template key="template-name"]
My reusable content

- [ ] task 1
- [ ] task 2
[/wrap]

Note that if a user is not logged in, clicking the button will display the login modal.

key is mandatory

Other options

• action="create" this will make the button open a composer to create a new topic
• action="create_pm" this will make the button open a composer to create a new PM
• categoryId="2" only usable with action="create", will set the category of the opened composer
• title="some title" only usable with create and create_pm, title of the topic/pm
• recipients="a@example.com" only usable with create_pm, people this will be sent to
• usernames=sam only usable with create_pm
• label="My button text" The button text

Placeholders

You can have special keys in your template which will get replaced:

• $week_start → date at the beginning of the week
• $week_end → date at the end of the week
• $prev_week_start → date at the start of previous week
• $prev_week_end → date at the end of previous week
• $today
• $tomorrow
• $username → username of current user
• $name → name of current user

Note that this will be replaced by local dates.

Special placeholders are also interpolated in title

Tags list

tagsList=":heart:,foo,#bar" will show a least of checkboxes at the end of the template so people can tag their post easily.

Example

My todo list $week_end

• task 1
• task 2

Settings

Translation	Default
discourse_reply_template_component	Use template as reply
discourse_reply_template_component	Use template as new topic
discourse_reply_template_component.use_template_create_pm	Use template as new PM
discourse_reply_template_component.needs_key	Each template needs a key attribute. eg: [wrap=template key="weekly_status"][/wrap]

Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.

Last edited by @cmdntd 2025-09-30T08:41:20Z

Last checked by @joo 2025-06-08T15:57:59Z

Check document

Perform check on document:

[Heliosurge (Dan DeMontmorency)]

I was wondering can this be used in a specific category/sub?

Ie bug reporting form?

[dax (Daniela)]

@Heliosurge

I was wondering can this be used in a specific category/sub?

Yes

@joffreyjaffeux

categoryId="2" only usable with action="create" , will set the category of the opened composer

E.g.
[wrap=template key="bug-report" action="create" categoryId="your-bug-category-id"]

[Heliosurge (Dan DeMontmorency)]

Thank you will need to explore this more.

[debryc (Deborah Chang)]

This is the best. Thank you!! I use this to create checklist templates that can be created anytime we’re doing a repetitive project. Before, our instructions would have been “copy and paste everything below” instead of having this very elegant button to create a topic for people.

[debryc (Deborah Chang)]

Is there a plan to make this functionality accessible in the composer window? To me the most logical place being where things like Hide Details and Build Poll live.

[j.jaffeux (Joffrey Jaffeux)]

I just updated the component, see OP for usage but a quick note:

• placeholder dates are now replaced by local dates
• you can now define a tagsList

[Ed_Bobkov (Ed)]

Thank you for a great component!

It’s impossible to add a poll in the wrap. Can you add this functionality?

[wrap=template key="template-name"]

[poll type=regular results=on_vote chartType=bar]
# Who will join?
* 1
* 2
* 3
[/poll]

[/wrap]

[Ed_Bobkov (Ed)]

I added more locales to your component and created a PR. Please, check.

[nobodyfrm]

How can i install this component?

In my opinion it’d be more helpful to have an example for the reply case (without action=create) because this is probably the reason, the majority is searching for since creating a topic is already possible via URL

My try:

• ok
• fail

[debryc (Deborah Chang)]

Would it be possible to use a template to create a new personal message?

Also, when someone is not signed in, clicking on “Use template as reply” does not result in any action. Could you add functionality where if a user is not logged in, something happens to nudge them to log in or create a new account?

[j.jaffeux (Joffrey Jaffeux)]

Great suggestion, it’s done, I updated the OP.

[debryc (Deborah Chang)]

Is there a way to pre-populate the title of a new topic?

Is there a way to automatically add tags instead of having just the tag list?

[j.jaffeux (Joffrey Jaffeux)]

No, but that’s reasonable feature request for sure. I’m kinda full ATM but making a note of this, thanks.

[jrgong]

Is there any possible way to modify the stock reply button in a topic with such a template?
That would be a gamechanger for specific structured conversations in the forum. Especially for contests etc where users have to submit content in a structured manner.

[j.jaffeux (Joffrey Jaffeux)]

Hi, sorry I don’t understand your request, can you be more specific please ?

[jrgong]

Currently the user can access the reply template only via the button in the first post generated by the theme component.
What I would like to achieve is to enable the template for the stock reply buttons in the topic as well (reply button below the timeline and reply button below the last post)

Edit: One prolific use case is a topic where users can leave feedback like bug reports etc. If we could add per-topic post templates just like for per-category templates for new topics, that would lead to less incomplete reports and hence save our staff a lot of time.

[Sugarhouse (Mitch Sabine)]

Hallo,

Ich habe einige Probleme bei der Installation dieser Komponente. Ich bin neu bei Discourse und hoffe, dass jemand bestätigen kann, ob die von mir unternommenen Schritte korrekt sind.

Ich habe die Anleitung hier Installing a theme or theme component befolgt, um die Komponente zu installieren. Ich habe die Komponente in allen unseren Themes enthalten.

Wenn ich jedoch ein neues Thema erstelle und Folgendes einfüge:

Mein wiederverwendbarer Inhalt

• Aufgabe 1
• Aufgabe 2

Gibt es keine Schaltfläche für “Vorlage als Antwort verwenden”. Beispiel:

Es wird nur der Wrapper um die Vorlage angezeigt. Habe ich einen Schritt übersehen? Muss ich etwas im Code anpassen?

Außerdem meldet Discourse, dass das Theme Fehler in CSS, HTML oder YAML hat. Ich bin mir nicht sicher, ob das etwas damit zu tun hat, warum die Schaltfläche nicht angezeigt wird?

Vielen Dank für jede Hilfe.

[j.jaffeux (Joffrey Jaffeux)]

Ich werde es mir morgen ansehen

[Sugarhouse (Mitch Sabine)]

Danke. Mir wurde mitgeteilt, dass es sich auch um ein Problem mit der von uns verwendeten Discourse-Version handeln könnte, aber ich werde mich dazu noch einmal melden.