Study Japanese 101

How to Set Up Yomitan for Japanese Browser Reading

A documentation-based desktop setup for one Japanese dictionary, one lookup and a short reading session, with fixes to check when no popup appears.

5 min read

Yomitan puts a dictionary lookup beside Japanese text in a browser. To make the first lookup work, install the extension, add and enable at least one dictionary, then try the default scan gesture on selectable text. This guide walks through that small setup and what to check when the popup does not appear.

This is a documentation-based guide, not a hands-on product test. Yomitan is a lookup tool, not a course or a translation of the whole sentence. If you are still learning kana or only need to search one word, a search box may be a simpler starting point. See our Yomitan profile for its fit and limits.

Before you install: choose the reading job

Use this route when you have a Japanese web page you want to read and repeated copying into a dictionary interrupts you. The instructions below focus on a desktop browser and an ordinary page with selectable text. Keep the source page open so you can return to its context after each lookup.

For a quick search instead, our dictionary shortlist separates search-box, phone and in-page lookup jobs. You do not need a popup extension just because another learner uses one.

1. Install the extension from its official guide

Open Yomitan's getting-started page and follow the stable installation link for your desktop browser. The project lists Chrome, Firefox and Edge. Check the store page and permissions before installing an extension. Yomitan's guide also lists supported Android browsers, but says mobile Chrome and iOS are not supported. This walkthrough does not assume that a desktop extension will work in an iPhone browser.

After installation, the guide says a welcome page should appear. If it does not, open the Yomitan button in the browser toolbar and choose Settings from Quick Actions. Browser menus can change, so use the current project instructions if the labels differ.

2. Add one Japanese dictionary

An extension without an enabled dictionary cannot provide definitions. On the welcome or settings page, choose Japanese in the language dropdown and open Get recommended dictionaries. Start with one dictionary that gives definitions in a language you can use. Wait for its installation to finish and check that it is enabled in the dictionary configuration.

For English definitions, Yomitan's dictionary documentation recommends Jitendex, a version of JMdict adapted for Yomitan. Its list also includes other resources with different roles, such as names and individual kanji information. A frequency list is not a substitute for a definition dictionary. You can add specialized material later if a real lookup needs it.

If you already have a compatible dictionary file, the guide describes Configure installed and enabled dictionaries, then Import. Obtain files from sources you trust and follow their terms. This is a separate action from importing an entire saved dictionary collection.

3. Try one lookup and return to the sentence

Open a normal web page where you can select the Japanese text. With the default desktop setting, hold Shift and move the cursor over a word. If the dictionary finds an entry, a popup appears. The modifier key is configurable, so your own setting may differ.

Try a word such as 本, read here as ほん for a book. The Japan Foundation's vocabulary index lists that form and reading. A dictionary may show more than one entry or sense for the same written form. Use the surrounding sentence to decide which one fits; do not assume the first gloss is the intended meaning.

In a real passage, read the sentence once, check only the word that blocks the point, and read it again without the popup. If several words and the grammar remain unclear, choose an easier passage or a course explanation. For help interpreting a result, see how to read a Japanese dictionary entry. Our guide to reading without looking up every word offers a way to limit interruptions.

If the popup does not appear

  1. Check the dictionary. Return to Settings and confirm that a Japanese definition dictionary finished installing and is enabled. An orange exclamation mark on the icon can indicate that no dictionaries are enabled.
  2. Check the gesture. Try Shift while moving over a word, unless you changed the modifier. Test on ordinary selectable text in a different web page as well.
  3. Check the browser's access. The official support page says Firefox users may need to enable recommended permissions on Yomitan's welcome page. Review what access is requested before allowing it.
  4. Check the material. Text inside a picture is not selectable page text. A local file is a different case: Yomitan's guide says Chrome needs file-URL access for local files, and directs local PDF readers to the Yomitan PDF Viewer. Do not assume every ebook, image or site works like a normal web page.

If a dictionary will not import, use the project's current support page for its browser-specific checks. Avoid changing browser privacy settings or resetting a profile without understanding the effect. Until the issue is resolved, copy a word into a regular dictionary and continue reading.

Keep the setup small

After a short passage, ask whether the popup helped you return to the text. If the answer is yes, keep one definition dictionary and use it on the next passage. If the setup took over the session, a search box may fit better today. You can postpone audio, extra dictionaries and flashcard integration until you have a specific reason to configure them.

For the next session, choose one page, look up a few blocking words and note one sentence you understood better. This is an editorial practice suggestion, not a measured claim that the extension improves learning. Neither a popup nor a dictionary entry checks whether your interpretation is correct in every context.

Sources

Prepared by our editorial team with AI assistance. Product details are checked against the sources below.

Related posts

Back to all posts