Skip to main content

Add product video

Attach a video to a product, cluster or category using the GraphQL API.

Mutation​

mutation CreateMediaVideo($input: MediaVideoInput!) {
  mediaVideoCreate(input: $input) {
    id
    productId
    alt { language value }
    description { language value }
    priority
    createdAt
  }
}

Variables​

{
  "input": {
    "productId": "26",
    "alt": [
      { "language": "NL", "value": "Industriële Kachel HT-350 installatiehandleiding" }
    ],
    "description": [
      { "language": "NL", "value": "Stapsgewijze installatievideo" }
    ],
    "tags": [
      { "language": "NL", "values": ["installatie", "handleiding"] }
    ],
    "priority": 1,
    "videos": [
      {
        "language": "NL",
        "uri": "https://www.youtube.com/watch?v=abc123xyz"
      }
    ]
  }
}

Response​

{
  "data": {
    "mediaVideoCreate": {
      "id": "66d7bc7f690599fecc3fa6b3",
      "productId": "26",
      "alt": [{ "language": "NL", "value": "Industriële Kachel HT-350 installatiehandleiding" }],
      "description": [{ "language": "NL", "value": "Stapsgewijze installatievideo" }],
      "priority": 1,
      "createdAt": "2026-03-05T10:30:00.000Z"
    }
  }
}

Attaching to other entities​

Replace productId with the appropriate field to attach media to other entities:

FieldEntity
productIdProduct
clusterIdCluster
categoryIdCategory

How it works​

The videos array accepts one or more video entries, each with a language and a uri. The URI can be a YouTube or Vimeo link. The priority field controls display order (lower numbers appear first). Use alt for accessibility text and description for longer captions.

See also​