FAQ

Security Related ​

1. The floating ball in the Andriod App has disappeared ​

Old version add-ons are disabled.

Please uninstall and reinstall the latest version from official website .

Installation Related ​

1. How to update the extension ​

In general, extensions installed from the browser store will automatically update within a day after a new version is released.

If you'd like to update immediately, go to the browser's Manage Extensions page, enable Developer Mode , and click Update at the top. This will fetch the latest version from the store right away.

2. Tampermonkey Supported Browsers for Immersive Translate Userscript ​

Android:

Browsers known to be unsupported due to lack of required Tampermonkey APIs:

3. Error when installing the extension package on Chrome ​

If you see the error invalid value for web_accessible_resource[0]

Make sure your Chromium version is above 88, as manifest_version 3 requires it.

4. How to Install the Extension on 360 Browser ​

Immersive Translate only supports 360 Extreme Browser X (the product name must include "X").

You can install the extension from the Chrome Web Store, or install it manually .

5. Extension does not work on Opera browser ​

It doesn't work on google.com and other search pages, the plugin displays Please refresh the current page before starting the translation and refreshing the page still shows this message: You need to find "Immersive Translate" in the Opera plugin settings and enable the "Allow access to search page results" option.

If the extension doesn't work on search pages like google.com and shows
"Please refresh the page before starting translation" even after refreshing,
go to Opera's extension settings, find Immersive Translate , and enable
Allow access to search page results .

6. Cannot enable extensions on iOS devices ​

If you cannot enable extensions on your iOS device, follow these steps:

If you don't need the other features of Content & Privacy Restrictions, you can also choose to simply turn off Content & Privacy Restrictions:

7. Safari settings page stuck on loading ​

Open Safari -> Settings -> Websites -> Immersive Translate
Find and remove any entries related to immersivetranslate.com.

8. Blank page when logging in from the settings page after updating to iOS 18 ​

Press & hold the floating button, tap the avatar, and log in.

9. "File does not exist" when dragging .crx file to browser extensions ​

You need to first extract the zip file, then drag the .crx file only.

10. Why is version 1.13.5 installed from the .crx download instead of the latest? ​

Because your browser’s Chromium version is below 115 and doesn’t support some advanced features, the extension is automatically downgraded to version 1.13.5.

Basic Translation Related ​

1. What's the difference between "Translate Webpage", "Translate the Main Content", and "Translate the Whole Page"? ​

Translate Webpage (Default Option)

This option essentially means "Translate the Main Content of the Page".

What does it mean? To preserve the original layout and navigation functionality of most websites, Immersive Translate intelligently identifies the core content areas of web pages (such as article text, post content, etc.) and translates them.

Why do this? Elements like navigation bars, headers/footers, or special elements (like Twitter usernames, posting times) would not only break the page aesthetics if translated, but could also affect normal website usage. Therefore, we've made fine-tuned adaptations for many mainstream websites, excluding these non-core parts from translation.

Additional note: This rule isn't 100% perfect. Some older or niche websites may not have been adapted, so even in default mode, navigation bars and other areas might get translated. We're continuously optimizing this.

Translate the Whole Page

As the name suggests, when you select this option, the extension will indiscriminately translate all recognizable text on the page. Previously excluded navigation bars, sidebars, and all other elements will be attempted for translation.

Use Cases

2. Youtube, Facebook main content is translated, but some sidebars are not—how to translate everything? ​

For better readability and user experience, Immersive Translate only translates the main content by default.

To translate the entire page:
Open the extension panel (long press the floating button on mobile) -> Tap More in the bottom-right corner -> Select "Translate the Whole Page" .

2. Floating button not showing in mobile apps ​

Immersive Translate is a browser extension and only works in browsers . It cannot be used inside other apps.

Extensions are tied to the browser they’re installed in and do not work across browsers (e.g., an extension installed in Safari won’t work in Chrome).

3. On iOS, clicking a YouTube link opens the app, preventing webpage translation ​

Long press the YouTube link and select “Open in browser” from the popup menu.

4. How to turn off automatic translation ​

How to turn off auto-translate

Disable relative settings in the popup panel.

Or change the settings in the Options .

5. No permission to translate this page ​

6. How to hide the original text ​

Click the Immersive Translate icon to open the panel, tap More , then select Show Translation Only .

Or click the icon on the left of Translate button on the popup panel.

7. Exclamation mark on the page ​

An exclamation mark means the translation service encountered an error.
Hover over it to see the specific error message.

Example: 429 Error ​

This is one of the most common errors. 429 means too many requests in a short time.

Webpage translation involves many segments, and despite heavy optimization, some services may still become overloaded and return a 429 rate limit error.

To resolve this, try switching to another translation service temporarily or wait and try again later.

If you're seeing 429 errors with Google services, it's likely that your current network node has been rate-limited by Google. Switching nodes is recommended.

8. How to switch translation source and target language ​

On mobile: long press the floating button.
On desktop: hover over the floating button to open settings.
Then choose a different translation service or target language.

9. Google Translate Being Blocked in China ​

Please add the translate.googleapis.com domain name to the proxy rule.

10. Does OpenAI's ban on API Keys in China affect member AI services? ​

No impact, the product uses Azure Enterprise OpenAI, which is not subject to API regional restrictions.

11. Caiyun Translation Error ​

If the error "Unsupported trans_type" shows when clicking the ? icon, you can manually set the source language instead of using auto-detect.

12. WeChat Reading content can't be translated ​

WeChat Reading restricts content access, blocking third-party tools, so translation is not possible.

13. Some parts of the webpage are not translated ​

This usually happens when the site uses translate="no" or notranslate class to block translation.

You can fix it by:

14. Translation not working on a specific site ​

If one site doesn't translate but others work fine:

For low-traffic sites:

For popular sites:

15. Translation issue on a webpage — how to save and report ​

Right-click on the webpage and select “Save As” or press Ctrl+S.
Choose the "Single File" option and save it as a .mht/.mhtml file.
Then send the file to support@immersivetranslate.com .

16. View Debug Logs ​

17. How to hide the floating button ​

18. Mouse Hover + Hotkey Translation Not Working ​

To use mouse hover + hotkey translation, the page must be focused. If it's not working, try the following:

19. How to update to the latest rules ​

The extension auto-syncs the latest official site rules regularly.

To sync manually, click the Immersive Translate icon in your browser. Once the pop panel opens, it will automatically check and update the rules.

Tampermonkey users are also supported with automatic rule detection and syncing.

20. Translation failed / Activity indicator keeps spinning ​

Check the failure reason:

Switch translation service:
Long press the floating button or click the extension icon, then select another service in the panel.

21. How to check Pro member translation quota and usage ​

Pro members get 20 million tokens per month. This quota applies to all translation services—you can use it entirely with DeepL (≈20M characters), OpenAI (20M tokens), or split across services as needed.

OpenAI pricing is based on tokens. For English, 1 token ≈ 4 characters or 0.75 words.
1,000 tokens ≈ 750 English words.

Check your usage here: https://immersivetranslate.com/accounts/usage

22. Why is the extension’s Google Translate quality lower than Google’s website? ​

The extension uses Google’s free API, an older, deprecated service that no longer receives updates. In contrast, the official Google Translate website continues to improve, so its translation quality is generally better.

Recently, the free API’s quality has declined significantly. We recommend switching to other available translation services.

More details: #2574

23. Touch mode activated under mouse mode ​

Go to Advanced Settings and enable “Mouse Only Mode”.

This detection has been improved in version 1.14.9.

24. Edge is unable to read the translation aloud. ​

The Read Aloud feature of the Edge browser automatically selects the corresponding voice model based on the language of the original webpage. Since these voice models are designed for a single language, the default selected voice model cannot correctly read the translated content when the page contains a translation.

Solution: You can click on the [Voice Options] in the toolbar of Edge's Read Aloud feature, and then manually select the speech model that matches the translated language. This will allow you to correctly read aloud the translated content.

25. Shortcuts not working in Arc Browser ​

Arc browser bug, will cause browser extension shortcuts to fail.

Solution: In the shortcut settings page, change the scope of the shortcut from "In Chromium" to "Global".

Note: After setting it to global, the browser window can be triggered even when it is not in focus.

That is, pressing the translation shortcut key in other software can also trigger the translation in the webpage, which may conflict with the shortcut keys of other software.

Suggestion: Use the floating bubble translation in the Arc browser, or use the shortcut key in the Chrome browser.

Video Translation Related ​

1. Youtube subtitle setup style ​

You can click on Youtube's own subtitle settings, [Options], and then you can adjust the size, color, and so on.

2. YouTube bilingual subtitles not showing in Traditional Chinese ​

YouTube’s auto-generated Traditional Chinese subtitles often have format issues, causing a large block of text to appear at the start.

To fix this, go to Options > Video Subtitles and enable
Use immersive translate to translate YouTube subtitles .

3. How to enable subtitle translation on Bilibili ​

To translate Bilibili video subtitles, follow these steps:

Notes:

4. Netflix subtitle translation uses default style ​

How to revert to the old method

Go to Developer Settings , find Edit User Rules ,
and add the following rule:

[
  {
    "id": "netflix",
    "subtitleRule.add": {
      "attachRule": {
        "appendSelector": ""
      }
    }
  }
]

File Translation ​

1. How to Translate Local Files ​

Method 1: Go to Immersive Translate - Document Translation
or click the Immersive Translate extension icon and select PDF/ePub , or Text .

Method 2: If you're using a Chromium-based browser (e.g., Chrome, Arc, Edge),
open chrome://extensions , find Immersive Translate ,
and enable Allow access to file URLs .
Then open local HTML or PDF files in the browser and right-click to select Translate .

Note : Safari has strict limits on extension access to local files.
Safari users should use Immersive Translate - Document Translation directly.

2. PDF Translation Slow with Too Many Pages ​

Split the file into parts with fewer than 100 pages for faster translation.
Merge them after translation is complete.

3. Duplicate or Overlapping Translations in PDF ​

This is usually caused by source file recognition issues.
Manually click and remove extra text boxes.
We're continuously improving PDF translation accuracy.

4. Glossary / Custom Translations or Exclusions ​

Version 1.16.1+ supports the AI Glossary feature.

Note:

To force-enable:

Go to Developer Settings -> Edit Full User Config , then add the following code:

{
  ....
  "enableMachineTranslateTerms":true,
  ...
}

5. Translated Word File Can’t Be Exported as Word ​

Currently, exporting to Word has technical limitations.
We recommend keeping the existing format.
Improvements are in progress.

6. How to Adjust Minimum Font Size in PDF ​

PDF translation font size depends on browser settings.
To reduce it, lower the browser font size.
For Chrome: go to Chrome Font Settings
or follow the steps below:

Input Box Translation ​

1. Input Enhancement Not Working ​

2. Input enhancement not working on Mac computer ​

If pressing three spaces on a Mac computer doesn't work, it may be because the Mac input method has a default setting of "Double-tap the space bar to insert a period."

You can find "Input Sources" in "System Settings" -> "Keyboard", click the "Edit" button, and turn off the "Add Period with double-space" option.

Payment ​

1. Can I Pay with WeChat? ​

Yes. Message a staff member in the user group and mention “WeChat Payment”.

After receiving a QR code, complete payment and send the payment details to the staff.
You’ll receive a membership code (monthly or yearly) to redeem at:
Membership Redemption Page

2. Can I Get an Invoice/Fapiao? ​

Invoices/Fapiao are available for yearly members only .
Paid users: DM the staff with “Invoice/Fapiao request”.
Unpaid users: see the Invoice Policy

Other Questions (Less Common) ​

How to Clear Tampermonkey Script Cache? ​

Due to Tampermonkey API limits, cache is stored per site.
To clear it, open the site’s developer tools and clear its cache.

Tampermonkey Custom API Request Fails? ​

Tampermonkey requires domain access to be declared at the top of the script:
e.g. @connect api.google.com
Add a similar line for any new domain you use.

Edge Extension Shows Blank Page with MANIFEST-000001 Error ​

Open the Everything File Search Tool
Search for extension ID amkbmndfnliijdhojkpoglbnaaahippg
Delete related files, then uninstall and reinstall the extension.

How to Download Bilingual Subtitles / Are Other Sites Supported? ​