Anchor to section titled 'undefined'product
product
mutation
2024-07
Requires write access scope. Also: The user must have a permission to create media for a product.
Creates media for a product.
Anchor to section titled 'Arguments'
Arguments
List of new media to be added to a product.
Specifies the product associated with the media.
Was this section helpful?
Anchor to section titled 'ProductCreateMediaPayload returns'
ProductCreateMediaPayload returns
The newly created media.
The list of errors that occurred from executing the mutation.
The product associated with the media.
The list of errors that occurred from executing the mutation. Use
mediainstead.User Errors
Was this section helpful?
Code examples for MUTATION: productCreateMedia
Query Reference for MUTATION: productCreateMedia
"mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n # Media fields\n }\n mediaUserErrors {\n # MediaUserError fields\n }\n product {\n # Product fields\n }\n userErrors {\n field\n message\n }\n }\n}"Input Reference for MUTATION: productCreateMedia
"{\n \"media\": [\n {\n \"alt\": \"<your-alt>\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"<your-originalSource>\"\n }\n ],\n \"productId\": \"gid://shopify/<objectName>/10079785100\"\n}"Schema Reference for MUTATION: productCreateMedia
"input CreateMediaInput {\n alt: String\n mediaContentType: MediaContentType!\n originalSource: String!\n}\n"Display Examples for MUTATION: productCreateMedia
[
{
"example": {
"type_name": "productcreatemedia",
"title": "Add both valid and invalid media to an existing product",
"description": "Trying to add both valid and invalid media to a product adds the valid media and returns an error for the invalid media.",
"query_string": "mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n}",
"variables": {
"media": [
{
"alt": "Image",
"mediaContentType": "EXTERNAL_VIDEO",
"originalSource": "https://youtu.be/32mGBDk3LSo"
},
{
"alt": "Image",
"mediaContentType": "IMAGE",
"originalSource": "invalid_img"
}
],
"productId": "gid://shopify/Product/121709582"
},
"response": {
"data": {
"productCreateMedia": {
"media": [
{
"alt": "Image",
"mediaContentType": "EXTERNAL_VIDEO",
"status": "UPLOADED"
}
],
"mediaUserErrors": [
{
"field": [
"media",
"1",
"originalSource"
],
"message": "Image URL is invalid"
}
],
"product": {
"id": "gid://shopify/Product/121709582",
"title": "Boots"
}
}
}
},
"api_name": "admin",
"minimum_api_version": "2023-10",
"maximum_api_version": "unstable",
"location": "/components/merchandising/test/unit/graph_api/admin/mutations/product_create_media_test.rb",
"curl_example": "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-07/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) { productCreateMedia(media: $media, productId: $productId) { media { alt mediaContentType status } mediaUserErrors { field message } product { id title } } }\",\n \"variables\": {\n \"media\": [\n {\n \"alt\": \"Image\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n {\n \"alt\": \"Image\",\n \"mediaContentType\": \"IMAGE\",\n \"originalSource\": \"invalid_img\"\n }\n ],\n \"productId\": \"gid://shopify/Product/121709582\"\n }\n}'\n",
"remix_example": "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n {\n variables: {\n \"media\": [\n {\n \"alt\": \"Image\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n {\n \"alt\": \"Image\",\n \"mediaContentType\": \"IMAGE\",\n \"originalSource\": \"invalid_img\"\n }\n ],\n \"productId\": \"gid://shopify/Product/121709582\"\n },\n },\n);\n\nconst data = await response.json();\n",
"ruby_example": "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY\n\nvariables = {\n \"media\": [{\"alt\"=>\"Image\", \"mediaContentType\"=>\"EXTERNAL_VIDEO\", \"originalSource\"=>\"https://youtu.be/32mGBDk3LSo\"}, {\"alt\"=>\"Image\", \"mediaContentType\"=>\"IMAGE\", \"originalSource\"=>\"invalid_img\"}],\n \"productId\": \"gid://shopify/Product/121709582\"\n}\n\nresponse = client.query(query: query, variables: variables)\n",
"node_example": "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: {\n \"query\": `mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n \"variables\": {\n \"media\": [\n {\n \"alt\": \"Image\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n {\n \"alt\": \"Image\",\n \"mediaContentType\": \"IMAGE\",\n \"originalSource\": \"invalid_img\"\n }\n ],\n \"productId\": \"gid://shopify/Product/121709582\"\n },\n },\n});\n",
"php_example": "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY;\n\n$variables = [\n \"media\" => [{\"alt\"=>\"Image\", \"mediaContentType\"=>\"EXTERNAL_VIDEO\", \"originalSource\"=>\"https://youtu.be/32mGBDk3LSo\"}, {\"alt\"=>\"Image\", \"mediaContentType\"=>\"IMAGE\", \"originalSource\"=>\"invalid_img\"}],\n \"productId\" => \"gid://shopify/Product/121709582\",\n];\n\n$response = $client->query([\"query\" => $query, \"variables\" => $variables]);\n"
},
"titleStringKey": "variables",
"inputVariableEntries": [
{
"arg": {
"name": "media",
"description": "List of new media to be added to a product.",
"type": {
"kind": "INPUT_OBJECT",
"name": "CreateMediaInput",
"list": true,
"non_null": true
},
"defaultValue": null,
"typeSignature": "[CreateMediaInput!]!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "media",
"argValue": " [{\"alt\":\"Image\",\"mediaContentType\":\"EXTERNAL_VIDEO\",\"originalSource\":\"https://youtu.be/32mGBDk3LSo\"},{\"alt\":\"Image\",\"mediaContentType\":\"IMAGE\",\"originalSource\":\"invalid_img\"}]",
"typeKind": "MUTATION"
},
{
"arg": {
"name": "productId",
"description": "Specifies the product associated with the media.",
"type": {
"kind": "SCALAR",
"name": "ID",
"list": false,
"non_null": true
},
"defaultValue": null,
"typeSignature": "ID!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "productId",
"argValue": " \"gid://shopify/Product/121709582\"",
"typeKind": "MUTATION"
}
]
},
{
"example": {
"type_name": "productcreatemedia",
"title": "Add invalid media to an existing product",
"description": "Trying to add invalid media to a product returns an error.",
"query_string": "mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n}",
"variables": {
"media": {
"alt": "Image",
"mediaContentType": "IMAGE",
"originalSource": "invalid_img"
},
"productId": "gid://shopify/Product/121709582"
},
"response": {
"data": {
"productCreateMedia": {
"media": [],
"mediaUserErrors": [
{
"field": [
"media",
"0",
"originalSource"
],
"message": "Image URL is invalid"
}
],
"product": {
"id": "gid://shopify/Product/121709582",
"title": "Boots"
}
}
}
},
"api_name": "admin",
"minimum_api_version": "2023-10",
"maximum_api_version": "unstable",
"location": "/components/merchandising/test/unit/graph_api/admin/mutations/product_create_media_test.rb",
"curl_example": "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-07/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) { productCreateMedia(media: $media, productId: $productId) { media { alt mediaContentType status } mediaUserErrors { field message } product { id title } } }\",\n \"variables\": {\n \"media\": {\n \"alt\": \"Image\",\n \"mediaContentType\": \"IMAGE\",\n \"originalSource\": \"invalid_img\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n }\n}'\n",
"remix_example": "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n {\n variables: {\n \"media\": {\n \"alt\": \"Image\",\n \"mediaContentType\": \"IMAGE\",\n \"originalSource\": \"invalid_img\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n },\n },\n);\n\nconst data = await response.json();\n",
"ruby_example": "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY\n\nvariables = {\n \"media\": {\n \"alt\": \"Image\",\n \"mediaContentType\": \"IMAGE\",\n \"originalSource\": \"invalid_img\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n}\n\nresponse = client.query(query: query, variables: variables)\n",
"node_example": "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: {\n \"query\": `mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n \"variables\": {\n \"media\": {\n \"alt\": \"Image\",\n \"mediaContentType\": \"IMAGE\",\n \"originalSource\": \"invalid_img\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n },\n },\n});\n",
"php_example": "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY;\n\n$variables = [\n \"media\" => [\n \"alt\" => \"Image\",\n \"mediaContentType\" => \"IMAGE\",\n \"originalSource\" => \"invalid_img\",\n ],\n \"productId\" => \"gid://shopify/Product/121709582\",\n];\n\n$response = $client->query([\"query\" => $query, \"variables\" => $variables]);\n"
},
"titleStringKey": "variables",
"inputVariableEntries": [
{
"arg": {
"name": "media",
"description": "List of new media to be added to a product.",
"type": {
"kind": "INPUT_OBJECT",
"name": "CreateMediaInput",
"list": true,
"non_null": true
},
"defaultValue": null,
"typeSignature": "[CreateMediaInput!]!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "media",
"argValue": " {\"alt\":\"Image\",\"mediaContentType\":\"IMAGE\",\"originalSource\":\"invalid_img\"}",
"typeKind": "MUTATION"
},
{
"arg": {
"name": "productId",
"description": "Specifies the product associated with the media.",
"type": {
"kind": "SCALAR",
"name": "ID",
"list": false,
"non_null": true
},
"defaultValue": null,
"typeSignature": "ID!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "productId",
"argValue": " \"gid://shopify/Product/121709582\"",
"typeKind": "MUTATION"
}
]
},
{
"example": {
"type_name": "productcreatemedia",
"title": "Add new media to a non-existent product",
"description": "Trying to add media to a non-existent product returns an error.",
"query_string": "mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n}",
"variables": {
"media": {
"alt": "Video",
"mediaContentType": "EXTERNAL_VIDEO",
"originalSource": "https://youtu.be/32mGBDk3LSo"
},
"productId": "gid://shopify/Product/-1"
},
"response": {
"data": {
"productCreateMedia": {
"media": null,
"mediaUserErrors": [
{
"field": [
"productId"
],
"message": "Product does not exist"
}
],
"product": null
}
}
},
"api_name": "admin",
"minimum_api_version": "2023-10",
"maximum_api_version": "unstable",
"location": "/components/merchandising/test/unit/graph_api/admin/mutations/product_create_media_test.rb",
"curl_example": "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-07/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) { productCreateMedia(media: $media, productId: $productId) { media { alt mediaContentType status } mediaUserErrors { field message } product { id title } } }\",\n \"variables\": {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/-1\"\n }\n}'\n",
"remix_example": "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n {\n variables: {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/-1\"\n },\n },\n);\n\nconst data = await response.json();\n",
"ruby_example": "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY\n\nvariables = {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/-1\"\n}\n\nresponse = client.query(query: query, variables: variables)\n",
"node_example": "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: {\n \"query\": `mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n \"variables\": {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/-1\"\n },\n },\n});\n",
"php_example": "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY;\n\n$variables = [\n \"media\" => [\n \"alt\" => \"Video\",\n \"mediaContentType\" => \"EXTERNAL_VIDEO\",\n \"originalSource\" => \"https://youtu.be/32mGBDk3LSo\",\n ],\n \"productId\" => \"gid://shopify/Product/-1\",\n];\n\n$response = $client->query([\"query\" => $query, \"variables\" => $variables]);\n"
},
"titleStringKey": "variables",
"inputVariableEntries": [
{
"arg": {
"name": "media",
"description": "List of new media to be added to a product.",
"type": {
"kind": "INPUT_OBJECT",
"name": "CreateMediaInput",
"list": true,
"non_null": true
},
"defaultValue": null,
"typeSignature": "[CreateMediaInput!]!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "media",
"argValue": " {\"alt\":\"Video\",\"mediaContentType\":\"EXTERNAL_VIDEO\",\"originalSource\":\"https://youtu.be/32mGBDk3LSo\"}",
"typeKind": "MUTATION"
},
{
"arg": {
"name": "productId",
"description": "Specifies the product associated with the media.",
"type": {
"kind": "SCALAR",
"name": "ID",
"list": false,
"non_null": true
},
"defaultValue": null,
"typeSignature": "ID!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "productId",
"argValue": " \"gid://shopify/Product/-1\"",
"typeKind": "MUTATION"
}
]
},
{
"example": {
"type_name": "productcreatemedia",
"title": "Add new media to an existing product",
"query_string": "mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n}",
"variables": {
"media": {
"alt": "Video",
"mediaContentType": "EXTERNAL_VIDEO",
"originalSource": "https://youtu.be/32mGBDk3LSo"
},
"productId": "gid://shopify/Product/121709582"
},
"response": {
"data": {
"productCreateMedia": {
"media": [
{
"alt": "Video",
"mediaContentType": "EXTERNAL_VIDEO",
"status": "UPLOADED"
}
],
"mediaUserErrors": [],
"product": {
"id": "gid://shopify/Product/121709582",
"title": "Boots"
}
}
}
},
"api_name": "admin",
"minimum_api_version": "2023-10",
"maximum_api_version": "unstable",
"location": "/components/merchandising/test/unit/graph_api/admin/mutations/product_create_media_test.rb",
"curl_example": "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-07/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) { productCreateMedia(media: $media, productId: $productId) { media { alt mediaContentType status } mediaUserErrors { field message } product { id title } } }\",\n \"variables\": {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n }\n}'\n",
"remix_example": "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n {\n variables: {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n },\n },\n);\n\nconst data = await response.json();\n",
"ruby_example": "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY\n\nvariables = {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n}\n\nresponse = client.query(query: query, variables: variables)\n",
"node_example": "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: {\n \"query\": `mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }`,\n \"variables\": {\n \"media\": {\n \"alt\": \"Video\",\n \"mediaContentType\": \"EXTERNAL_VIDEO\",\n \"originalSource\": \"https://youtu.be/32mGBDk3LSo\"\n },\n \"productId\": \"gid://shopify/Product/121709582\"\n },\n },\n});\n",
"php_example": "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n mutation productCreateMedia($media: [CreateMediaInput!]!, $productId: ID!) {\n productCreateMedia(media: $media, productId: $productId) {\n media {\n alt\n mediaContentType\n status\n }\n mediaUserErrors {\n field\n message\n }\n product {\n id\n title\n }\n }\n }\nQUERY;\n\n$variables = [\n \"media\" => [\n \"alt\" => \"Video\",\n \"mediaContentType\" => \"EXTERNAL_VIDEO\",\n \"originalSource\" => \"https://youtu.be/32mGBDk3LSo\",\n ],\n \"productId\" => \"gid://shopify/Product/121709582\",\n];\n\n$response = $client->query([\"query\" => $query, \"variables\" => $variables]);\n"
},
"titleStringKey": "variables",
"inputVariableEntries": [
{
"arg": {
"name": "media",
"description": "List of new media to be added to a product.",
"type": {
"kind": "INPUT_OBJECT",
"name": "CreateMediaInput",
"list": true,
"non_null": true
},
"defaultValue": null,
"typeSignature": "[CreateMediaInput!]!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "media",
"argValue": " {\"alt\":\"Video\",\"mediaContentType\":\"EXTERNAL_VIDEO\",\"originalSource\":\"https://youtu.be/32mGBDk3LSo\"}",
"typeKind": "MUTATION"
},
{
"arg": {
"name": "productId",
"description": "Specifies the product associated with the media.",
"type": {
"kind": "SCALAR",
"name": "ID",
"list": false,
"non_null": true
},
"defaultValue": null,
"typeSignature": "ID!",
"isDeprecated": false,
"deprecationReason": null,
"kind": "ARGUMENT"
},
"key": "productId",
"argValue": " \"gid://shopify/Product/121709582\"",
"typeKind": "MUTATION"
}
]
}
]