Creates multiple metaobjects for a given metaobject definition
Description
You can use `metaobjectsCreate` to create multiple metaobjects that share the same metaobject definition.
A `MetaobjectDefinition` with the specified type must already exist.
The following example creates new "Lookbook" metaobjects with handle and season fields.
Query
mutation CreateMetaobjects($input: MetaobjectsCreateInput!) {
metaobjectsCreate(input: $input) {
metaobjects {
handle
values
}
userErrors {
field
message
code
}
}
}
Variables
{
"input": {
"type": "lookbook",
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"season": "winter"
}
},
{
"handle": "spring-2025",
"values": {
"season": "spring"
}
}
]
}
}
cURL
curl -X POST \
https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CreateMetaobjects($input: MetaobjectsCreateInput!) { metaobjectsCreate(input: $input) { metaobjects { handle values } userErrors { field message code } } }",
"variables": {
"input": {
"type": "lookbook",
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"season": "winter"
}
},
{
"handle": "spring-2025",
"values": {
"season": "spring"
}
}
]
}
}
}'
React Router
import { authenticate } from "../shopify.server";
export const loader = async ({request}) => {
const { admin } = await authenticate.admin(request);
const response = await admin.graphql(
`#graphql
mutation CreateMetaobjects($input: MetaobjectsCreateInput!) {
metaobjectsCreate(input: $input) {
metaobjects {
handle
values
}
userErrors {
field
message
code
}
}
}`,
{
variables: {
"input": {
"type": "lookbook",
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"season": "winter"
}
},
{
"handle": "spring-2025",
"values": {
"season": "spring"
}
}
]
}
},
},
);
const json = await response.json();
return json.data;
}
Ruby
session = ShopifyAPI::Auth::Session.new(
shop: "your-development-store.myshopify.com",
access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
session: session
)
query = <<~QUERY
mutation CreateMetaobjects($input: MetaobjectsCreateInput!) {
metaobjectsCreate(input: $input) {
metaobjects {
handle
values
}
userErrors {
field
message
code
}
}
}
QUERY
variables = {
"input": {
"type": "lookbook",
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"season": "winter"
}
},
{
"handle": "spring-2025",
"values": {
"season": "spring"
}
}
]
}
}
response = client.query(query: query, variables: variables)
Node.js
const client = new shopify.clients.Graphql({session});
const data = await client.query({
data: {
"query": `mutation CreateMetaobjects($input: MetaobjectsCreateInput!) {
metaobjectsCreate(input: $input) {
metaobjects {
handle
values
}
userErrors {
field
message
code
}
}
}`,
"variables": {
"input": {
"type": "lookbook",
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"season": "winter"
}
},
{
"handle": "spring-2025",
"values": {
"season": "spring"
}
}
]
}
},
},
});
Shopify CLI
shopify app execute \
--query \
'mutation CreateMetaobjects($input: MetaobjectsCreateInput!) {
metaobjectsCreate(input: $input) {
metaobjects {
handle
values
}
userErrors {
field
message
code
}
}
}' \
--variables \
'{
"input": {
"type": "lookbook",
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"season": "winter"
}
},
{
"handle": "spring-2025",
"values": {
"season": "spring"
}
}
]
}
}'
Direct API Access
const response = await fetch('shopify:admin/api/unstable/graphql.json', {
method: 'POST',
body: JSON.stringify({
query: `
mutation CreateMetaobjects($input: MetaobjectsCreateInput!) {
metaobjectsCreate(input: $input) {
metaobjects {
handle
values
}
userErrors {
field
message
code
}
}
}
`,
variables: {
"input": {
"type": "lookbook",
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"season": "winter"
}
},
{
"handle": "spring-2025",
"values": {
"season": "spring"
}
}
]
}
},
}),
});
const { data } = await response.json();
console.log(data);
Response
{
"metaobjectsCreate": {
"metaobjects": [
{
"handle": "winter-2024",
"values": {
"another_lookbook": null,
"cover_image": null,
"season": "winter",
"year": null
}
},
{
"handle": "spring-2025",
"values": {
"another_lookbook": null,
"cover_image": null,
"season": "spring",
"year": null
}
}
],
"userErrors": []
}
}