Blog List SEO translations

Read and write localized blog list seo fields through the Store API.

Translate seo_title, seo_description, social_title, and social_description for an enabled language other than the store's source language. Images and robots settings are shared across languages. Supply strings; an empty string clears a translation. Omitted fields remain unchanged.

Save source text before adding its translation. Source edits mark translations outdated but keep serving them until replaced or removed. A missing translation falls back to the source field. Reads and writes require the corresponding resource and translation scopes shown on each endpoint.

Get Blog List SEO translation

GET read_blog + read_translations

Get translated SEO for the public blog index.

The locale must be enabled and cannot be the store default.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

401 UNAUTHORIZED
Authorization header missing, malformed, or token invalid/expired.
402 SUBSCRIPTION_REQUIRED
The store does not have an active or trialing subscription.
403 STORE_API_SCOPE_REQUIRED
Token is valid but lacks the required scope for this call.
429 RATE_LIMITED
The token's request allowance is exhausted. Retry after the Retry-After header.
400 STORE_API_INVALID_REQUEST_BODY
The body has an invalid shape. Translation values must be strings.
400 PAGE_SEO_PAGE_TYPE_INVALID
The requested list page type is not supported.
400 TRANSLATION_LOCALE_REQUIRED
A locale is required.
400 TRANSLATION_LOCALE_NOT_ENABLED
The locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
The source language cannot be a translation target.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
Only the four SEO and social text fields can be translated.
400 TRANSLATION_FIELDS_REQUIRED
Provide at least one field.
400 TRANSLATION_NO_SOURCE_TEXT
Save source text before adding its translation.
404 TRANSLATION_RESOURCE_NOT_FOUND
Save source SEO before writing translations for this page.
409 TRANSLATION_MUTATION_CONFLICT
The idempotency key was already used for another translation change.
400 PAGE_SEO_META_TITLE_INVALID_CHARS
A translated title contains unsupported characters.
400 PAGE_SEO_META_TITLE_TOO_LONG
A translated title exceeds its limit.
400 PAGE_SEO_META_DESCRIPTION_INVALID_CHARS
A translated description contains unsupported characters.
400 PAGE_SEO_META_DESCRIPTION_TOO_LONG
A translated description exceeds its limit.

curl 'https://api-store.tringify.com/api/2025-01/blog/list-seo/translations/fr' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/list-seo/translations/fr", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_STORE_API_TOKEN" },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/blog/list-seo/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "fields": {
      "seo_description": {
        "is_outdated": false,
        "value": "Les dernières nouvelles.",
        "word_count": 3
      },
      "seo_title": {
        "is_outdated": false,
        "value": "Actualités",
        "word_count": 1
      }
    },
    "locale": "fr",
    "page_type": "blog_list",
    "resource_type": "blog_list_seo"
  },
  "success": true
}

Set Blog List SEO translation

PUT write_blog + write_translations

Set or clear translated SEO fields for the public blog index.

Empty values clear only that locale's field. The write is atomic.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.
`Idempotency-Key`	`string`	Optional key for this translation write. Reuse it only with the same payload when repeating the request.

Body parameters

Name	Type	Description
`translations` required	`object`	Field-keyed translations. Example: `{"seo_title":"Actualités","seo_description":"Les dernières nouvelles."}`

Errors

401 UNAUTHORIZED
Authorization header missing, malformed, or token invalid/expired.
402 SUBSCRIPTION_REQUIRED
The store does not have an active or trialing subscription.
403 STORE_API_SCOPE_REQUIRED
Token is valid but lacks the required scope for this call.
429 RATE_LIMITED
The token's request allowance is exhausted. Retry after the Retry-After header.
400 STORE_API_INVALID_REQUEST_BODY
The body has an invalid shape. Translation values must be strings.
400 PAGE_SEO_PAGE_TYPE_INVALID
The requested list page type is not supported.
400 TRANSLATION_LOCALE_REQUIRED
A locale is required.
400 TRANSLATION_LOCALE_NOT_ENABLED
The locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
The source language cannot be a translation target.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
Only the four SEO and social text fields can be translated.
400 TRANSLATION_FIELDS_REQUIRED
Provide at least one field.
400 TRANSLATION_NO_SOURCE_TEXT
Save source text before adding its translation.
404 TRANSLATION_RESOURCE_NOT_FOUND
Save source SEO before writing translations for this page.
409 TRANSLATION_MUTATION_CONFLICT
The idempotency key was already used for another translation change.
400 PAGE_SEO_META_TITLE_INVALID_CHARS
A translated title contains unsupported characters.
400 PAGE_SEO_META_TITLE_TOO_LONG
A translated title exceeds its limit.
400 PAGE_SEO_META_DESCRIPTION_INVALID_CHARS
A translated description contains unsupported characters.
400 PAGE_SEO_META_DESCRIPTION_TOO_LONG
A translated description exceeds its limit.

curl -X PUT 'https://api-store.tringify.com/api/2025-01/blog/list-seo/translations/fr' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": {
    "seo_description": "Les dernières nouvelles.",
    "seo_title": "Actualités"
  }
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/list-seo/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": {
      "seo_description": "Les dernières nouvelles.",
      "seo_title": "Actualités"
    }
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/blog/list-seo/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": {
            "seo_description": "Les dernières nouvelles.",
            "seo_title": "Actualités",
        },
    },
)
data = res.json()

Response

200

Sample response

{
  "code": "TRANSLATION_SAVED",
  "message": "Translation saved.",
  "success": true
}

Webhook events#

Subscribe to these events when your integration mirrors localized blog list seo. Update and clear events identify the locale and changed fields. One write can emit both events when it sets some fields and clears others.

Blog List SEO translations updated

EVENT blog_list_seo/translations/update App scope: read_blog Staff permission: blog:write

Fired when translated SEO fields are added or updated for the public blog index in a locale.

Payload fields

Field	Type	Description
`blog_list_seo.page_type`	`string`	Always present The stable public blog-index identity, blog_list.
`blog_list_seo.seo_title`	`string`	Selectable in the Payload builder The blog index SEO title in the store's default language.
`blog_list_seo.seo_description`	`string`	Selectable in the Payload builder The blog index SEO description in the store's default language.
`blog_list_seo.social_title`	`string`	Selectable in the Payload builder The default-language social sharing title override.
`blog_list_seo.social_description`	`string`	Selectable in the Payload builder The default-language social sharing description override.
`blog_list_seo.social_image_id`	`string`	Selectable in the Payload builder The assigned site-asset image id, or null when no override is assigned.
`blog_list_seo.robots_index`	`boolean`	Selectable in the Payload builder Whether search engines may index the blog index.
`blog_list_seo.robots_follow`	`boolean`	Selectable in the Payload builder Whether search engines may follow links from the blog index.
`blog_list_seo.updated_at`	`string`	Selectable in the Payload builder When the source blog-index SEO settings last changed.
`locale`	`string`	Always present The locale whose Blog List SEO translation changed.
`translation.seo_title`	`string`	Selectable in the Payload builder The translated SEO title; empty on delete means it was removed.
`translation.seo_description`	`string`	Selectable in the Payload builder The translated SEO description; empty on delete means it was removed.
`translation.social_title`	`string`	Selectable in the Payload builder The translated social title; empty on delete means it was removed.
`translation.social_description`	`string`	Selectable in the Payload builder The translated social description; empty on delete means it was removed.
`updated_at`	`string`	Selectable in the Payload builder When this locale's Blog List SEO translation changed.

Payload shape

Sample payload

{
  "blog_list_seo": {
    "page_type": "blog_list",
    "robots_follow": true,
    "robots_index": true,
    "seo_description": "News, guides, and updates.",
    "seo_title": "Stories from our store",
    "social_description": "Read our latest stories.",
    "social_image_id": null,
    "social_title": "Our blog",
    "updated_at": "2026-09-01T12:00:00+05:30"
  },
  "locale": "fr",
  "translation": {
    "seo_description": "Les dernières nouvelles.",
    "seo_title": "Actualités",
    "social_description": "Découvrez nos dernières histoires.",
    "social_title": "Notre blog"
  },
  "updated_at": "2026-09-01T12:00:00+05:30"
}

Blog List SEO translations deleted

EVENT blog_list_seo/translations/delete App scope: read_blog Staff permission: blog:write

Fired when translated SEO fields are cleared for the public blog index in a locale.

Payload fields

Field	Type	Description
`blog_list_seo.page_type`	`string`	Always present The stable public blog-index identity, blog_list.
`blog_list_seo.seo_title`	`string`	Selectable in the Payload builder The blog index SEO title in the store's default language.
`blog_list_seo.seo_description`	`string`	Selectable in the Payload builder The blog index SEO description in the store's default language.
`blog_list_seo.social_title`	`string`	Selectable in the Payload builder The default-language social sharing title override.
`blog_list_seo.social_description`	`string`	Selectable in the Payload builder The default-language social sharing description override.
`blog_list_seo.social_image_id`	`string`	Selectable in the Payload builder The assigned site-asset image id, or null when no override is assigned.
`blog_list_seo.robots_index`	`boolean`	Selectable in the Payload builder Whether search engines may index the blog index.
`blog_list_seo.robots_follow`	`boolean`	Selectable in the Payload builder Whether search engines may follow links from the blog index.
`blog_list_seo.updated_at`	`string`	Selectable in the Payload builder When the source blog-index SEO settings last changed.
`locale`	`string`	Always present The locale whose Blog List SEO translation changed.
`translation.seo_title`	`string`	Selectable in the Payload builder The translated SEO title; empty on delete means it was removed.
`translation.seo_description`	`string`	Selectable in the Payload builder The translated SEO description; empty on delete means it was removed.
`translation.social_title`	`string`	Selectable in the Payload builder The translated social title; empty on delete means it was removed.
`translation.social_description`	`string`	Selectable in the Payload builder The translated social description; empty on delete means it was removed.
`updated_at`	`string`	Selectable in the Payload builder When this locale's Blog List SEO translation changed.

Payload shape

Sample payload

{
  "blog_list_seo": {
    "page_type": "blog_list",
    "robots_follow": true,
    "robots_index": true,
    "seo_description": "News, guides, and updates.",
    "seo_title": "Stories from our store",
    "social_description": "Read our latest stories.",
    "social_image_id": null,
    "social_title": "Our blog",
    "updated_at": "2026-09-01T12:00:00+05:30"
  },
  "locale": "fr",
  "translation": {
    "seo_description": "",
    "seo_title": "",
    "social_description": "",
    "social_title": ""
  },
  "updated_at": "2026-09-01T12:00:00+05:30"
}