> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging-docs-5625.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 電子メールテンプレートでLiquid構文を使用

> 電子メールテンプレートでLiquid構文を使用する方法について説明します。

<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=auth0-dashboard" tip="Auth0 Dashboard: サービスを構成するためのAuth0の主製品。" cta="用語集の表示">Auth0 dashboard</Tooltip>で利用可能な[電子メールテンプレート](https://manage.auth0.com/#/branding/email_templates)を使用する場合、Liquidテンプレート言語を使用して適切なデータを選択し、電子メールを書式設定するオプションがあります。Liquidは、さまざまな情報を含む電子メールを動的に生成するために使用できるHTMLの機能を拡張するオープンソースのテンプレート言語です。詳細については、Githubの[［Liquid for Designers（デザイナー向けLiquid）］](https://github.com/Shopify/liquid/wiki/Liquid-for-Designers)に関するページをお読みください。

Liquidを使用して、特定の値をハードコードするのではなく、電子メールの`［Subject（件名）］`を構成して適切なアプリケーション名を表示できます。

`{{application.name}}です!`

Liquid構文を使用したHTMLは、検証、パスワード変更確認、およびブロックされたアカウントの電子メールテンプレートのすべてのフィールド (`URLLifetime`を除く) でサポートされています。サポートされている出力属性とその使用方法の詳細については、[［Customize Email Templates（電子メールテンプレートのカスタマイズ）］](/docs/ja-jp/customize/email/email-templates)を参照してください。

Liquidには、出力とタグの2種類のマークアップがあります。

### 出力マークアップ

**［Output（出力）］** マークアップはテキストに変換され、2組の対応する波括弧で囲まれます。

`こんにちは {{ name }}!`

シンプルな方法であるフィルターを使用して、出力の外観をさらにカスタマイズできます。たとえば、`upcase`フィルターは、フィルターに渡されるテキストを大文字に変換します。

`こんにちは {{ name | upcase }}!`

複数のフィルターは`|`で区切られ、左から右の順に処理され、前のフィルターの結果に次のフィルターが適用されます。テンプレートは最終結果をレンダリングします

以下のフィルターがサポートされています。

| フィルター | 説明 | 例 |
| - | - | - |
| `append` | 文字列を追加します | `{{ 'foo' \| append:'bar' }} #=&gt; 'foobar'` |
| `capitalize` | 入力文の文字を大文字にします | `{{ "my great title" \| capitalize }} #=&gt; My great title` |
| `date` | 日付を再フォーマットします ([syntax reference](http://docs.shopify.com/themes/liquid-documentation/filters/additional-filters#date)) | |
| `default` | 提供された値を返すnullまたは空の文字列でない限り、提供された変数を返します | `{{ undefined_variable \| default: "Default value" }} #=&gt; "Default value"` |
| `divided_by` | 整数除算 | `{{ 10 \| divided_by:3 }} #=&gt; 3` |
| `downcase` | 入力文字列を小文字に変換します | `{{ "Parker Moore" \| downcase }} #=&gt; parker moore` |
| `escape` | 文字列のHTMLエスケープ | `{{ "Have you read 'James &amp; the Giant Peach'?"\| escape }} #=&gt; Have you read 'James &amp; the Giant Peach'?` |
| `escape_once` | 既存のエスケープされたエンティティに影響を与えることなくHTMLのエスケープされたバージョンを返します | `{{ "1 &lt; 2 &amp; 3" \| escape_once }} #=&gt; 1 &lt; 2 &amp; 3` |
| `first` | 渡された配列の最初の要素を取得します | |
| `join` | 配列の要素を、特定の文字を間に使用して結合します | |
| `last` | 渡された配列の最初の要素を取得します | |
| `map` | 提供されたプロパティの配列をマップ/収集します | |
| `minus` | 減算 | `{{ 4 \| minus:2 }} #=&gt; 2` |
| `modulo` | 剰余 | `{{ 3 \| modulo:2 }} #=&gt; 1` |
| `newline_to_br` | 各改行(\n)をHTML改行に置き換えます | |
| `plus` | 加算 | `{{ '1' \| plus:'1' }} #=&gt; 2`, `{{ 1 \| plus:1 }} #=&gt; 2` |
| `prepend` | 文字列をプリペンドします | `{{ 'bar' \| prepend:'foo' }} #=&gt; 'foobar'` |
| `remove` | 各出現を削除します | `{{ 'foobarfoobar' \| remove:'foo' }} #=&gt; 'barbar'` |
| `remove_first` | 最初の出現を削除します | `{{ 'barbar' \| remove_first:'bar' }} #=&gt; 'bar'` |
| `replace` | 各出現を置き換えます | `{{ 'foofoo' \| replace:'foo','bar' }} #=&gt; 'barbar'` |
| `replace_first` | 最初の出現を置き換えます | `{{ 'barbar' \| replace_first:'bar','foo' }} #=&gt; 'foobar'` |
| `round` | 出力を最も近い整数か、指定された小数点以下の桁数に丸めます | `{{ 4.5612 \| round: 2 }} #=&gt; 4.56` |
| `size` | 配列または文字列のサイズを返します | `{{ "Ground control to Major Tom."\| size }} #=&gt; 28` |
| `sort` | 配列の要素をソートします | |
| `split` | 一致するパターンで文字列を分割します | `{{ "a~b" \| split:"~" }} #=&gt; ['a','b']` |
| `strip_html` | 文字列からHTMLを削除します | `{{ "How &lt;em&gt;are&lt;/em&gt; you?"\| strip_html }} #=&gt; How are you?` |
| `strip_newlines` | 文字列からすべての改行(\n)を削除します | |
| `times` | 乗算 | `{{ 5 \| times:4 }} #=&gt; 20` |
| `truncate` | 文字列をx文字まで切り詰めますまた文字列に追加する2番目のパラメーターを受け入れます | `{{ 'foobarfoobar' \| truncate: 5, '.' }} #=&gt; 'foob.'` |
| `truncatewords` | 文字列をx文字まで切り詰めます | |
| `upcase` | 入力文字列を大文字に変換します | `{{ "Parker Moore" \| upcase }} #=&gt; PARKER MOORE` |

### タグマークアップ

**［Tag（タグ）］** マークアップはテキストに解決されず、対応する一対の波括弧とパーセント記号で囲まれます。

`{％これはテキスト％に解決されません}`

通常、タグはテンプレートにロジックを適用するために使用されます。Liquidで[サポートされているタグ](https://github.com/Shopify/liquid/wiki/Liquid-for-Designers#tags)を使用すると、1つのテンプレートで複数のニーズを満たすことができます。

タグを使用して`if/else`ステートメントを実行し、1つのテンプレートで複数の言語で電子メールを送信することができます。

例：

```liquid wrap lines theme={null}
{% if user.user_metadata.lang == 'en' %} [email body in English] {% elsif user.user_metadata.lang == 'de' %} [email body in German] {% endif %}
```

追加の条件を使用する必要がある場合は、caseステートメントの使用を検討してください。caseステートメントの詳細については、Githubの[［Liquid for Designers（デザイナー向けLiquid）］](https://github.com/Shopify/liquid/wiki/Liquid-for-Designers#case-statement)を参照してください。

#### タグコメント

`{% comment %}`タグと`{% endcomment %}`タグの間のコンテンツはレンダリングされません。

`これは表示されます。{% comment %}これは表示されません。{% endcomment %}`

#### タグraw

Liquidマークアップの処理を一時的に無効にするには、`{% raw %}`と`{% endraw %}`を使用します。これは、Liquidと競合する構文を使用している場合に便利です。

たとえば、次の`Mustache.js`行を次のようにエスケープできます。

```liquid wrap lines theme={null}
{% raw %} var clients = "Clients:<ul>{{#client}}<li>{{fn}} {{ln}}" + {{phone}}</li>{{/client}}</ul>"; {% endraw %}
```

## デバッグ変数

テンプレートの開発を支援するために、カスタム`{% debug %}` liquidタグが追加されました。このタグは、テンプレートが表示されたときにテンプレートで使用できるテンプレート変数の概要を出力します。このタグは、「ライブ」のテンプレートから必ず削除してください。

## もっと詳しく

* [メールテンプレートをカスタマイズする](/docs/ja-jp/customize/email/email-templates)
* [メールテンプレートの説明](/docs/ja-jp/customize/email/email-templates/email-template-descriptions)
* [アカウントのブロック通知メールをカスタマイズする](/docs/ja-jp/customize/email/customize-blocked-account-emails)