Video Component

Overview

The Video Component enables the inclusion of video content such as product demos, promotional clips, or event recordings within QR Code landing pages.
It supports externally hosted URLs (e.g., YouTube, Vimeo, or CDN links) as well as videos uploaded to Scanova’s server. A thumbnail image can also be specified to improve page load performance and provide a custom visual before playback begins.

Properties

Property	Type	Required	Description
video	`object`	✅ Yes	Contains video metadata and URL information.
video.url	`string`	✅ Yes	The full video URL (supports both `http` and `https` formats). Must be a valid video link up to 2000 characters.
video.name	`string`	No	Optional display name or label for the video file.
thumbnail	`object`	No	Defines the preview image shown before playback starts.
thumbnail.url	`string`	✅ Yes	URL for the thumbnail image (supports `.jpg`, `.png`, `.gif`, etc.). Must be a valid image link up to 2000 characters.
thumbnail.name	`string`	No	Optional name or identifier for the thumbnail image.
isUploaded	`boolean`	No	Indicates whether the video is hosted on Scanova’s server (`true`) or an external source (`false`). Defaults to `false`.

Used in Categories

This component is used in the following categories:

Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Video Component",
  "description": "Video component",
  "additionalProperties": false,
  "required": [
    "video"
  ],
  "properties": {
    "video": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2000,
          "format": "uri",
          "pattern": "(http://www\\.|https://www\\.|http://|https://)?[a-z0-9]+([\\-.][a-z0-9]+)*\\.[a-z]{2,10}(:[0-9]{1,5})?(/.*)?$"
        },
        "name": {
          "type": "string"
        }
      }
    },
    "thumbnail": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2000,
          "pattern": "(http://www\\.|https://www\\.|http://|https://)?[a-z0-9]+([\\-.][a-z0-9]+)*\\.[a-z]{2,10}(:[0-9]{1,5})?(/.*)?$"
        },
        "name": {
          "type": "string"
        }
      }
    },
    "isUploaded": {
      "type": "boolean",
      "default": false,
      "description": "Is uploaded on our server ?"
    }
  }
}

Notes

Always use HTTPS URLs for both video and thumbnail resources to ensure secure delivery.
If isUploaded is set to true, the video should exist on Scanova’s managed storage.
Avoid using excessively large video files — optimize for web playback (recommended max size: 20–30 MB).
The thumbnail is displayed as a placeholder until the video is loaded or played.
For better performance, consider using compressed MP4 or WebM formats.

Getting Started

Code Examples

Category Components

Categories

Overview

Properties

Used in Categories

Schema

Notes

​Overview

​Properties

​Used in Categories

​Schema

​Notes

Overview

Properties

Used in Categories

Schema

Notes