Skip to content
PolyFields - ACF Options for Polylang
  • Home
  • Features
  • About
  • Help Center
    • Documentation
    • Contact & Support
View Pricing
View Pricing
PolyFields - ACF Options for Polylang
  • Home
  • Features
  • About
  • Help Center
    • Documentation
    • Contact & Support

Getting Started

3
  • Introduction
  • Requirements
  • First-use workflow

Field Translation Modes

6
  • Field translation overview
  • translate mode
  • translate_once mode
  • copy_once mode
  • sync mode
  • ignore mode

Import & Migration

2
  • Import from default ACF options
  • Migration from “ACF Options for Polylang”

Performance & Storage

3
  • Legacy options autoload
  • Which option rows are affected
  • Autoload snapshot & revert on deactivation

WP-CLI Reference

4
  • WP-CLI overview
  • wp polyfields import-options
  • wp polyfields migrate-bea-options
  • wp polyfields autoload

Configuration

5
  • Polylang ACF options settings
  • Translation retry behavior
  • Workload thresholds & async behavior
  • Import batch size
  • Available filters

Licensing

1
  • Activating your license

Legal

1
  • License & trademark
View Categories
  • Home
  • Documentation
  • Field Translation Modes
  • translate_once mode

translate_once mode

The translate_once mode bootstraps translated content one time, then lets each language diverge independently on subsequent saves.

At save time

  • Writes only when the target value is empty.
  • Uses machine translation when available.
  • Small saves (below workload thresholds): machine translation runs synchronously during the request.
  • Large saves (above thresholds): machine translation is queued and runs in the background after the source save completes.

During import

  • Copies source value to the default-language store only when the default-language value is empty.
  • Queues machine-translation jobs when DeepL is available (always with first-use assistant; only above import workload thresholds with WP-CLI).
  • Small WP-CLI imports below thresholds translate synchronously instead of queuing jobs.
  • Queued jobs skip targets that already have a value.

When to use

Use translate_once to bootstrap translated content one time, then edit each language independently. Good for teaser text or intro paragraphs that editors refine per language. See Field translation overview for more guidance.

translate modecopy_once mode
PolyFields - ACF Options for Polylang

Perfect ACF Options integration for Polylang.

Pages

  • Features
  • About
  • Pricing
  • Account

Resources

  • Documentation
  • Contact & Support

Legal

  • Privacy Policy
  • Terms & Conditions
  • Cookie Preferences

Copyright © 2026 PolyFields | Made by Studio DPE.