> For AI agents: the complete documentation index is available at https://docs.flashnerd.com/llms.txt, the full documentation bundle is available at https://docs.flashnerd.com/llms-full.txt.

# Japanese

Use a **Japanese** field to display Japanese text with optional furigana, romaji, and pitch-accent annotations. You can choose when the annotations appear and correct generated readings for individual cards.

## Set up reading aids

1. Add a Japanese field to the deck template and choose its side.
2. Open its gear button.
3. Choose which aids to enable: **Show Furigana**, **Show Romaji**, and **Show Pitch Accent**.
4. Choose the annotation visibility and, if using romaji, the **Romaji Type**.
5. Save the template, enter Japanese text on a card, and inspect **Full Preview**.

For example, use `学校` as the prompt, a meaning on the back, and furigana set to **Back only**. This lets you attempt the reading before revealing it.

## Annotation settings

**Hint** shows annotations on a long press. **Always** keeps them visible, **Back only** restricts them to the back, and **Off** hides them. Enabled layers follow the field's annotation settings.

**Romaji Type** offers **Ascii** and **Long Vowel** display styles. Pick the one that matches how you want to study; it does not alter the underlying Japanese text.

## Override generated readings

Enter the card's text first, then open that card's field settings. Applicable controls include:

- **Furigana Override:** change the reading for a displayed kanji run.
- **Romaji Override:** adjust the romanized reading.
- **Pitch Accent Override:** change the pitch pattern using the available controls.

The override sections depend on the text and enabled annotation layers. They are card-specific, so they are not shown while editing a blank template preset. Return to the card editor, preview the result, and save.

Generated readings can be ambiguous for names or context-dependent words. Check them against the reading you intend to learn, and recheck overrides when editing the source text.

For spoken pronunciation, add a [TTS](https://docs.flashnerd.com/reference/fields/tts.md) field with Japanese as its language and the Japanese field as its source. Text annotations and speech settings are separate controls.
