APIAdmin - Update blog article seo title and description

Shopify Apps

Topic summary

A developer is attempting to update SEO title and description for blog articles using the Shopify GraphQL Admin API through make.com. Their mutation query targets metafields with namespace “seo” and keys “title”/“description”, but despite receiving a 200 response with no errors, the fields aren’t updating.

Proposed Solution:

  • Use namespace 'global' instead of 'seo'
  • Use keys 'title_tag' and 'description_tag' instead of 'title' and 'description'
  • Reference provided to Shopify’s official SEO optimization documentation

Status: Potential solution offered but not yet confirmed as resolved.

Summarized with AI on October 31. AI used: claude-sonnet-4-5-20250929.
1

Hello,

I’m trying to update seo title and description metafield via a GraphQL APIAdmin call.

I’m using a make.com module to do this and the follow is the query:

mutation UpdateArticleMeta {
articleUpdate(
id: "gid://shopify/Article/{{43.id}}", 
article: {
metafields: [
{
namespace: "seo",
key: "title",
type: "single_line_text_field",
value: "{{40.result.meta_title}}"
},
{
namespace: "seo",
key: "description",
type: "multi_line_text_field",
value: "{{40.result.meta_description}}"
}
]
}
) {
article {
id
metafields(first: 2) {
edges {
node {
namespace
key
value
}
}
}
}
userErrors {
field
message
}
}
}

I’ve tried on the GraphQL App on Shopify and via make.com.

The call return 200 with no error but the fields never change.

Any idea?

Thanks

2

Hey,
Use the namespace ‘global’ as key ‘title_tag’ or ‘description_tag’. You can find more details here