This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Sets the SEO tags of multiple items of the same type in one call.
Each entry carries its own field mask and behaves like a single Set Item SEO
Tags
call. The response reports a result per entry, correlated to the request by
itemMetadata.originalIndex, so you can tell exactly which entries succeeded.
A problem with one entry, such as an invalid tag or an item that doesn't exist, fails
only that entry. Check bulkActionMetadata.totalFailures and retry just the failed
entries: writes are idempotent, so re-sending an entry that already succeeded is safe.
Not every failure is per entry. An item type that isn't supported, or one that doesn't support bulk writes, rejects the whole call, and so does a request that isn't authorized. In those cases there are no per-entry results to inspect, so handle a failed call as well as failed entries.
Limitation: for a static page, request-level publish: true applies to every entry and
updates only each item's published revision — it does not also update the saved one. Get
Item SEO Tags and List Item SEO Tags always read the saved revision, so they keep
returning the values from before this call until the same changed fields are also set
without publish.
entries may contain up to 100 items, but some item types accept fewer per call: a
BLOG_POST request is capped at 20 entries. Sending more than an item type's own limit
fails the whole call with BULK_CHUNK_SIZE_EXCEEDED, naming the limit; split the request
into smaller batches and retry.
Tags can currently be written only for the items' primary language: leave
itemSeoTags.language unset on every entry. Sending a language fails with
LANGUAGE_NOT_SUPPORTED, even when the entry's field mask doesn't name it.
To set the tags of a single item, call Set Item SEO Tags.
You can only call this method when authenticated as a Wix app or Wix user identity.
There are 2 errors with this status code.
There is 1 error with this status code.
This method may also return standard errors. Learn more about standard Wix errors.