Website rules
Websites vary widely in structure. Use Website rules and Allow & Block lists to translate only article bodies or comments while skipping sidebars, usernames, navigation, or code blocks.
Rule precedence & rule tiers
Open Settings › Websites › Website rules. Three rule tiers are evaluated in order:
My rules > Subscriptions > System
- System: Ships with Mini Trans and updates online with hundreds of curated rules for popular documentation, news, and community sites.
- Subscriptions: Add
http://orhttps://rule package URLs; Mini Trans refreshes them daily (or manually via Refresh). - My rules: Custom rules you create or import, taking top precedence.
Creating rules & subscriptions
Click Add under My rules to define a rule:
- Include URLs / Exclude URLs: One pattern per line—globs by default (e.g.
github.com/*) or/regex/flagswrapped in slashes. - Only on pages matching: Optional CSS selectors; the rule applies only when at least one selector matches.
- Translate only / Never translate: One CSS selector per line. Setting Translate only restricts translation strictly to those containers; Never translate excludes specific blocks inside them.
- Inject CSS: Applied while the page is translated and removed on restore—ideal for lifting
line-clamprules that would otherwise clip bilingual text.
Rules support batch enable/disable/delete and JSON / JSONC import & export.
Allow & Block lists
Switch to Settings › Websites › Allow & Block lists to manage domain-level policies:
- Always translate websites: Translate automatically on load regardless of default strategy.
- Never translate websites: Skip automatic translation (you can still click Translate anyway in the popup).
- Translate-all-elements websites: Ignore site rules and excluded areas on that domain and translate all readable elements.
- Widget Disable Lists: View and manage Floating ball disabled websites and Selection translate disabled websites.