---
title: Translation retry behavior
description: "These filters configure retry behavior for queued machine-translation jobs when they encounter retryable errors. Retries apply only to async jobs — synchronous translation during small saves or small WP-CLI imports is not retried through this mechanism. ## Available filters -…"
url: "https://www.wp-polyfields.com/docs/configuration/translation-retry-behavior/"
updated: "2026-07-05"
category: Configuration
---

# Translation retry behavior

These filters configure retry behavior for queued machine-translation jobs when they encounter retryable errors. Retries apply only to async jobs — synchronous translation during small saves or small WP-CLI imports is not retried through this mechanism.

## Available filters

- `polyfields_acf_options/translation_max_retry_attempts` (default `3`) — Maximum number of retry attempts for retryable translation errors.
- `polyfields_acf_options/translation_retry_delays` (default `[30, 120, 600, 1200, 2400]` seconds) — Delay sequence applied between retries.

## Example

```
add_filter(
	'polyfields_acf_options/translation_max_retry_attempts',
	static function (): int {
		return 5;
	}
);
```

```
add_filter(
	'polyfields_acf_options/translation_retry_delays',
	static function (): array {
		return array( 60, 180, 600, 1800, 3600 );
	}
);
```

See [Polylang ACF options settings](https://www.wp-polyfields.com/docs/configuration/polylang-acf-options-settings/) for Standard and Persistent retry presets in the admin UI.