Skip to main content

FAQ

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.

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

iOS:

  • Tampermonkey Browser
  • Safari with a userscript extension installed:
    • Userscripts
    • Stay: Recommended to search and install the optimized Immersive Translate script directly in the Stay built-in store (specially optimized for Stay).

Android:

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

  • Via Browser (Android)
  • Alook Browser (iOS)

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:

  1. Open the [Settings] app
  2. Scroll down and tap [Screen Time]
  3. Select [Content & Privacy Restrictions]
  4. Tap [Content Restrictions]
  5. Select [Web Content] and set it to [Unrestricted]

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

  1. Open the [Settings] app
  2. Select [Screen Time]
  3. Disable [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.

1. 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).

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

  • Browser default pages can’t be translated (no URL in address bar)
  • Third-party extension pages can’t be translated
  • Chrome browser blocks translations on the Chrome Web Store

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:

  1. Enabling the hover-to-translate feature
  2. Hovering over the section to force translation

14. Translation not working on a specific site

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

  • For low-traffic sites:

    • Use hover-to-translate for paragraphs
    • To translate the full page, consider using user rules
  • For popular sites:

    • Use Hover Translation for now
    • Report the issue in the user group; our team will schedule support later

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

  1. Enable debug logs: Open the panel -> Options -> Developer Settings -> Turn on “Print debug logs to console”.
  2. Open the site’s console: Right-click > Inspect -> Switch to the Console tab at the top -> Perform actions to see logs.

17. How to hide the floating button

  • Hide on current page: Set Never translate this site on.
  • Hide on all pages: Go to Options > Floating Button, and turn off Enable Floating Ball

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:

  1. Click anywhere on the page to ensure it’s focused.
  2. Try using mouse hover and the hotkey again.
  3. If it still doesn't work, check if your hotkey settings are correct.

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

  1. Check the failure reason:

    • If it says quota limit reached, your monthly limit for that translation service has been used up.
    • If it shows a network error, check your node or network connection.
  2. 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.

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:

  1. Turn on Bilibili’s built-in subtitles by clicking the “Subtitles” button in the bottom right of the player.
    If there’s no subtitle button or content, bilingual subtitles are not available.
  2. Click the “Immersive Translate” icon in the player to enable bilingual subtitles.

Notes:

  1. Make sure Bilibili’s built-in subtitles are enabled.
  2. The target language in Immersive Translate must be different from the subtitle language to trigger translation.

4. Netflix subtitle translation uses default style

  • The current Netflix translation uses a progressive method with self-hosted subtitles and does not support manual subtitles.
  • The old method waits for all subtitles to be translated before displaying them and supports manual subtitles.

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:

  • Google/Microsoft translation does not support glossary terms.
  • Placeholder-based glossary may reduce translation quality.

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

  • Make sure you’re not using an unsupported browser:
    See the Input Compatibility Guide
  • Cannot translate in address bar or new tab, only in search bars (e.g. test via https://www.bing.com/)
  • Try speeding up consecutive spacebar presses

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?

  • Subtitle download is only supported on desktop browsers.
  • For sites like YouTube, if a download button appears, bilingual subtitle download is supported.