AdvancedWP-CLI commands
WP-CLI commands
The following WP-CLI commands are available to translate custom posts, taxonomy terms (tags and categories), and media items.
WP-CLI commands run without a logged-in user by default. For proper permissions to create the translation entries, you must run commands with a user context, via option --user:
wp gatotranslate post 123 --user=adminwp gatotranslate post
Translate custom posts (posts, pages, custom post types).
Usage
wp gatotranslate post <ids> [options]Parameters
| Parameter | Description |
|---|---|
<ids> | List of post IDs to translate separated by commas or spaces |
Options
If not provided, options will be set with the value in the plugin Settings.
| Option | Description | Possible values |
|---|---|---|
--translate-slugs=<bool> | Whether to translate slugs | true, false |
--default-provider=<provider> | Default translation provider | chatgpt, claude, deepl, google_translate, deepseek, openrouter, mistral |
--status-to-update=<status> | The status posts must have to be updated | draft, pending, publish, private, future, any |
--status-when-translated=<status> | The status posts will have after translation | draft, pending, publish, private, current (i.e. don't modify the status), same-as-origin (i.e. copy the status from the origin post) |
--copy-date=<bool> | Whether to copy the date from the original post | true, false |
--language-providers=<providers> | JSON string of language providers mapping | JSON string with language codes as keys, and the provider name, or "none" (to disable for that language), or "default" (to use default provider) as values |
--tasks=<tasks> | Comma-separated list of tasks to execute | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Comma-separated list of content parts to modify | properties (title, slug, and excerpt), content (post content), meta (custom fields) |
--porcelain | Output only the essential information, suitable for parsing by scripts | No value required (flag) |
--fail-if-log-notifications | Fail if log notifications are added during execution | No value required (flag) |
Examples
# Translate post with ID 123
wp gatotranslate post 123 --user=admin
# Translate posts with IDs 123, 456, and 789
wp gatotranslate post 123,456,789 --user=admin
# Translate posts with IDs 123 and 456
wp gatotranslate post "123 456" --user=admin
# Translate post replicating the status and date of the original post
wp gatotranslate post 123 --user=admin --status-when-translated=same-as-origin --copy-date=true
# Translate post using ChatGPT as default provider
wp gatotranslate post 123 --user=admin --default-provider=chatgpt
# Translate post with a specific provider for each language
wp gatotranslate post 123 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate post disabling a specific language
wp gatotranslate post 123 --user=admin --language-providers='{"de":"none"}'
# Translate only post properties (title, slug, and excerpt)
wp gatotranslate post 123 --user=admin --parts=properties
# Translate only post content and meta
wp gatotranslate post 123 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate post 123 --user=admin --tasks=translate-entity-relationshipswp gatotranslate term
Translate taxonomy terms (categories, tags, custom taxonomies).
Usage
wp gatotranslate term <ids> [options]Parameters
| Parameter | Description |
|---|---|
<ids> | List of term IDs to translate separated by commas or spaces |
Options
| Option | Description | Possible values |
|---|---|---|
--translate-slugs=<bool> | Whether to translate slugs | true, false |
--default-provider=<provider> | Default translation provider | chatgpt, claude, deepl, google_translate, deepseek, openrouter, mistral |
--language-providers=<providers> | JSON string of language providers mapping | JSON string with language codes as keys, and the provider name, or "none" (to disable for that language), or "default" (to use default provider) as values |
--tasks=<tasks> | Comma-separated list of tasks to execute | translate-content, translate-entity-relationships |
--parts=<parts> | Comma-separated list of content parts to modify | properties (name, slug), content (description), meta (custom fields) |
--porcelain | Output only the essential information, suitable for parsing by scripts | No value required (flag) |
--fail-if-log-notifications | Fail if log notifications are added during execution | No value required (flag) |
Examples
# Translate term with ID 1
wp gatotranslate term 1 --user=admin
# Translate terms with IDs 1, 2, and 3
wp gatotranslate term 1,2,3 --user=admin
# Translate term 1 disabling slug translation, and using OpenRouter as default provider
wp gatotranslate term 1 --user=admin --translate-slugs=false --default-provider=openrouterr
# Translate term 1 with a specific provider for each language
wp gatotranslate term 1 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling a specific language
wp gatotranslate term 1 --user=admin --language-providers='{"de":"none"}'
# Translate only term name and slug
wp gatotranslate term 1 --user=admin --parts=properties
# Translate only term description and meta
wp gatotranslate term 1 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate term 1 --user=admin --tasks=translate-entity-relationshipswp gatotranslate media
Translate media items (attachments).
Usage
wp gatotranslate media <ids> [options]Parameters
| Parameter | Description |
|---|---|
<ids> | List of media IDs to translate separated by commas or spaces |
Options
| Option | Description | Possible values |
|---|---|---|
--translate-slugs=<bool> | Whether to translate slugs | true, false |
--default-provider=<provider> | Default translation provider | chatgpt, claude, deepl, google_translate, deepseek, openrouter, mistral |
--language-providers=<providers> | JSON string of language providers mapping | JSON string with language codes as keys, and the provider name, or "none" (to disable for that language), or "default" (to use default provider) as values |
--tasks=<tasks> | Comma-separated list of tasks to execute | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Comma-separated list of content parts to modify | properties (title, slug), content (alt text, caption, and description), meta (custom fields) |
--porcelain | Output only the essential information, suitable for parsing by scripts | No value required (flag) |
--fail-if-log-notifications | Fail if log notifications are added during execution | No value required (flag) |
Examples
# Translate media item with ID 10
wp gatotranslate media 10 --user=admin
# Translate media items with IDs 10, 11, 12
wp gatotranslate media 10,11,12 --user=admin
# Translate media item with a specific provider for each language
wp gatotranslate media 10 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling specific languages
wp gatotranslate media 10 --user=admin --language-providers='{"de":"none","zh":"none"}'
# Translate only media title and slug
wp gatotranslate media 10 --user=admin --parts=properties
# Translate only media content (alt text, caption, and description) and meta
wp gatotranslate media 10 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate media 10 --user=admin --tasks=translate-entity-relationships