How to use placeholder - SeaweedbrainCY/jellyfin-newsletter GitHub Wiki
You may want to use dynamic values in your newsletter. That's what these placeholders are used for!
For every custom strings you can modify in the configuration file (config.yml), you can insert placeholders that will be replaced in the final email.
Available placeholders
Currently, the following placeholders are available :
| Placeholder | Example | Description | Version |
|---|---|---|---|
{date} |
2025-06-19 |
Date of the day. Format Y-m-d. |
>= v0.5.0 |
{day_name} |
Monday |
Today's day name, localized. | >= v0.5.0 |
{day_number} |
19 |
Today's day number of the month. | >= v0.5.0 |
{month_name} |
June |
Current month name, localized. | >= v0.5.0 |
{month_number} |
06 |
Current month number. | >= v0.5.0 |
{year} |
2025 |
Current year. | >= v0.5.0 |
{start_date} |
2025-05-18 |
First date new addition are taken into account. Depends on observed_period_days config parameter. Format Y-m-d. |
>= v0.5.0 |
{start_day_name} |
Sunday |
Day name of the first observed date. | >= v0.5.0 |
{start_day_number} |
19 |
Day number of the first observed date. | >= v0.5.0 |
{start_month_name} |
May |
Month name of the first observed date. | >= v0.5.0 |
{start_month_number} |
05 |
Month number of the first observed date. | >= v0.5.0 |
{start_year} |
2025 |
Year the first observed date. | >= v0.5.0 |
[!Note] Don't see what you are looking for? Open an issue to request a new custom value!
[!Warning] If you try using a placeholder that doesn't exist, the placeholder key
{example_placeholder}will not be replaced in the final email.
Example
Let's customize the email subject.
In config.yml :
[...]
email_template:
language: "en"
subject: "New addition of {month_name}"
[...]
Result :
[!Note] Change the
languagefield to one of the supported language to get localized date name !