diff --git a/src/docs/custom-emoji.ja-JP.md b/src/docs/custom-emoji.ja-JP.md
new file mode 100644
index 0000000000000000000000000000000000000000..4e1eb5c0e28ecf55dc0c2771159920916b5be855
--- /dev/null
+++ b/src/docs/custom-emoji.ja-JP.md
@@ -0,0 +1,5 @@
+# カスタム絵文字
+カスタム絵文字は、インスタンスで用意された画像を絵文字のように使える機能です。
+ノート、リアクション、チャット、自己紹介、名前などの場所で使うことができます。
+カスタム絵文字をそれらの場所で使うには、絵文字ピッカーボタン(ある場合)を押すか、`:`を入力して絵文字サジェストを表示します。
+テキスト内に`:foo:`のような形式の文字列が見つかると、`foo`の部分がカスタム絵文字名と解釈され、表示時には対応したカスタム絵文字に置き換わります。
diff --git a/src/docs/reaction.ja-JP.md b/src/docs/reaction.ja-JP.md
index 6ae6c07ad5c62a69841715372a6b5afd7c93923a..476af64e8b1d57a6d398fc035b4b0db7a52c11dc 100644
--- a/src/docs/reaction.ja-JP.md
+++ b/src/docs/reaction.ja-JP.md
@@ -1,7 +1,7 @@
 # リアクション
 他の人のノートに、絵文字を付けて簡単にあなたの反応を伝えられる機能です。
 リアクションするには、ノートの + アイコンをクリックしてピッカーを表示し、絵文字を選択します。
-リアクションにはカスタム絵文字も使用できます。
+リアクションには[カスタム絵文字](./custom-emoji)も使用できます。
 
 ## リアクションピッカーのカスタマイズ
 ピッカーに表示される絵文字を自分好みにカスタマイズすることができます。