# Reply Template

**URL:** https://meta.discourse.org/t/reply-template/162373
**Category:** Theme component
**Tags:** official, reply-template
**Created:** [August 28, 2020, 6:23pm UTC](https://meta.discourse.org/t/reply-template/162373 "2020-08-28T18:23:36Z")
**Posts on this page:** 1
**Showing post:** 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: [August 28, 2020, 6:23pm UTC](https://meta.discourse.org/t/reply-template/162373/1 "2020-08-28T18:23:36Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **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](https://discourse.theme-creator.io/theme/Discourse/reply-template) |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-reply-template-component](https://github.com/discourse/discourse-reply-template-component) |
| 📖 | **New to Discourse Themes?** | [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) |

Install this theme component

> [@](#):
>
> :discourse2: As this is an #official theme component maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > 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. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=reply-template "Ask for support on configuring and using Reply Template") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=reply-template "A bug report means something is broken, preventing normal/typical use of the theme component") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=reply-template "Discussion about the user interface of Reply Template, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=reply-template "Discussion about how existing Reply Template features can be improved or enhanced, and how proposed new features could work")

### Features

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

### Usage

```plaintext
[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.

 ![reply template example](https://global.discourse-cdn.com/meta/original/3X/d/0/d01db23aa5481b1a984bef0d9088ade04f1cc35b.png)

## Example

My todo list $week\_end

- task 1
- task 2

### Settings

| Translation | Default |
| --- | --- |
| discourse\_reply\_template\_component.use\_template\_reply | Use template as reply |
| discourse\_reply\_template\_component.use\_template\_create | 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]` |

  

> :discourse2: **Hosted by us?** Theme components are available to use on our Pro, Business, and Enterprise plans.

> Last edited by @Moin 2026-07-10T21:15:09Z
> 
> Last checked by @joo 2025-06-08T15:57:59Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/reply-template/162373)._