diff --git a/astro.config.ts b/astro.config.ts
index 053b784973..c37e807206 100644
--- a/astro.config.ts
+++ b/astro.config.ts
@@ -32,7 +32,9 @@ export default defineConfig({
assets: '_astro_docs'
},
integrations: [
- AutoImport({ imports: [asideAutoImport] }),
+ AutoImport({
+ imports: [asideAutoImport, { '~/components/Video.astro': [['default', 'Video']] }],
+ }),
preact({ compat: true }),
sitemap(),
astroAsides(),
diff --git a/src/components/Video.astro b/src/components/Video.astro
index 5e2833c2ef..5bf5ca0b40 100644
--- a/src/components/Video.astro
+++ b/src/components/Video.astro
@@ -1,42 +1,78 @@
---
-import { parse } from 'node:path';
-import { getLanguageFromURL } from '../util';
-import languages from '../i18n/languages';
+/**
+ * Single source of truth for embedded videos in the docs.
+ *
+ * From one authoring point (``) it renders BOTH:
+ * 1. a responsive YouTube `
+
+
+
+
+
diff --git a/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-astro.mdx b/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-astro.mdx
index 83842435c9..0b725bed11 100644
--- a/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-astro.mdx
+++ b/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-astro.mdx
@@ -102,7 +102,7 @@ Your Application was built successfully
Learn how to build with Astro running on a local development server. Watch the video below:
-
+
#### Deploying the project
diff --git a/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-next.mdx b/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-next.mdx
index d3749f2e9e..c10250c4d8 100644
--- a/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-next.mdx
+++ b/src/content/docs/en/pages/build-journey/develop-with-azion/frameworks/framework-next.mdx
@@ -166,12 +166,4 @@ Wait a few minutes so the propagation takes place, and then access your applicat
Watch how to build with Next.js on Azion's YouTube channel:
-
+
diff --git a/src/content/docs/en/pages/build-journey/develop-with-azion/toolslocal-dev/local-dev.mdx b/src/content/docs/en/pages/build-journey/develop-with-azion/toolslocal-dev/local-dev.mdx
index 11a6367a78..c0eb14e234 100644
--- a/src/content/docs/en/pages/build-journey/develop-with-azion/toolslocal-dev/local-dev.mdx
+++ b/src/content/docs/en/pages/build-journey/develop-with-azion/toolslocal-dev/local-dev.mdx
@@ -31,15 +31,7 @@ Through [Azion CLI](/en/documentation/products/azion-cli/overview/) it's possibl
Watch a video about the compatibility between Azion and web frameworks through Azion Bundler on Azion's YouTube channel:
-
+
diff --git a/src/content/docs/en/pages/devtools/azion-edge-runtime/code-editor/code-editor.mdx b/src/content/docs/en/pages/devtools/azion-edge-runtime/code-editor/code-editor.mdx
index f15427a635..017700e0c7 100644
--- a/src/content/docs/en/pages/devtools/azion-edge-runtime/code-editor/code-editor.mdx
+++ b/src/content/docs/en/pages/devtools/azion-edge-runtime/code-editor/code-editor.mdx
@@ -55,14 +55,6 @@ Here's a real-life implementation of the Functions ChatGPT integration:
Watch a video about the Functions Code Editor on Azion’s YouTube channel:
-
+
diff --git a/src/content/docs/en/pages/devtools/cli/azion-cli/commands/link-project/link.mdx b/src/content/docs/en/pages/devtools/cli/azion-cli/commands/link-project/link.mdx
index b1eddaaa96..f7aaa3b7c4 100644
--- a/src/content/docs/en/pages/devtools/cli/azion-cli/commands/link-project/link.mdx
+++ b/src/content/docs/en/pages/devtools/cli/azion-cli/commands/link-project/link.mdx
@@ -145,7 +145,7 @@ The `--help` option displays more information about the `link` command.
Learn how to link and deploy projects on Azion Web Platform. Watch the video below:
-
+
diff --git a/src/content/docs/en/pages/guides/data-streaming/associate-domains.mdx b/src/content/docs/en/pages/guides/data-streaming/associate-domains.mdx
index 917f538dd7..5219f53afa 100644
--- a/src/content/docs/en/pages/guides/data-streaming/associate-domains.mdx
+++ b/src/content/docs/en/pages/guides/data-streaming/associate-domains.mdx
@@ -51,15 +51,7 @@ Now, the events associated with the domains you selected will be collected and s
Watch a video tutorial on How to associate domains on Data Stream on Azion’s YouTube channel:
-
+
diff --git a/src/content/docs/en/pages/guides/edge-dns/run-dig-command.mdx b/src/content/docs/en/pages/guides/edge-dns/run-dig-command.mdx
index a239e6cacc..7273bf2530 100644
--- a/src/content/docs/en/pages/guides/edge-dns/run-dig-command.mdx
+++ b/src/content/docs/en/pages/guides/edge-dns/run-dig-command.mdx
@@ -116,7 +116,7 @@ This comprehensive video demonstrates how to install and use the dig across diff
* Validate Edge Computing services
-
+
---
diff --git a/src/content/docs/en/pages/guides/marketplace/integrations/hcaptcha.mdx b/src/content/docs/en/pages/guides/marketplace/integrations/hcaptcha.mdx
index f37d12de8c..9f8ed0455a 100644
--- a/src/content/docs/en/pages/guides/marketplace/integrations/hcaptcha.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/integrations/hcaptcha.mdx
@@ -162,6 +162,6 @@ hCaptcha is a registered trademark of Intuition Machines, Inc.
Watch a video on how to install the hCaptcha® integration through Azion Marketplace on Azion's YouTube channel.
-
+
---
\ No newline at end of file
diff --git a/src/content/docs/en/pages/guides/marketplace/integrations/rate-limiting-with-penalty.mdx b/src/content/docs/en/pages/guides/marketplace/integrations/rate-limiting-with-penalty.mdx
index 2bd9670ae3..cb86d77bde 100644
--- a/src/content/docs/en/pages/guides/marketplace/integrations/rate-limiting-with-penalty.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/integrations/rate-limiting-with-penalty.mdx
@@ -196,6 +196,6 @@ Done. Now **Upstash Rate Limiting** is running and protecting your domains.
Discover how to enhance your web application's performance with this tutorial on **Rate Limit with Penalty on Azion + Upstash DB**. Watch now on Azion's YouTube channel.
-
+
---
\ No newline at end of file
diff --git a/src/content/docs/en/pages/guides/marketplace/integrations/recaptcha.mdx b/src/content/docs/en/pages/guides/marketplace/integrations/recaptcha.mdx
index cafe5dabcb..c980a8b248 100644
--- a/src/content/docs/en/pages/guides/marketplace/integrations/recaptcha.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/integrations/recaptcha.mdx
@@ -151,7 +151,7 @@ Done. Now the **reCAPTCHA** integration is running for every request made to the
Watch a video about how to install the reCAPTCHA integration through Azion Marketplace on Azion’s YouTube channel:
-
+
---
diff --git a/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx b/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx
index f39121b2d9..6496ad0859 100644
--- a/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx
@@ -103,7 +103,7 @@ import LinkButton from 'azion-webkit/linkbutton';
Watch a video on how to deploy applications using the Angular Boilerplate on Azion's YouTube channel.
-
+
diff --git a/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx b/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx
index 000809c791..aeabecac27 100644
--- a/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/templates/azion-starter-kit.mdx
@@ -132,6 +132,6 @@ import LinkButton from 'azion-webkit/linkbutton';
Learn how to deploy the Azion Starter Kit:
-
+
diff --git a/src/content/docs/en/pages/guides/marketplace/templates/dynamic-and-static-file-optimization.mdx b/src/content/docs/en/pages/guides/marketplace/templates/dynamic-and-static-file-optimization.mdx
index 9a04d8d744..54e6ec5b50 100644
--- a/src/content/docs/en/pages/guides/marketplace/templates/dynamic-and-static-file-optimization.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/templates/dynamic-and-static-file-optimization.mdx
@@ -106,7 +106,7 @@ import LinkButton from 'azion-webkit/linkbutton';
Learn how to deploy the Dynamic and Static File Optimization template. Watch the video below:
-
+
diff --git a/src/content/docs/en/pages/guides/marketplace/templates/edge-application-proxy.mdx b/src/content/docs/en/pages/guides/marketplace/templates/edge-application-proxy.mdx
index 76ca44a62b..78c6d10194 100644
--- a/src/content/docs/en/pages/guides/marketplace/templates/edge-application-proxy.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/templates/edge-application-proxy.mdx
@@ -92,6 +92,6 @@ Read the documentation about [managing applications](/en/documentation/products/
Learn how to deploy the Applications Proxy template. Watch the video below:
-
+
diff --git a/src/content/docs/en/pages/guides/marketplace/templates/image-optimization.mdx b/src/content/docs/en/pages/guides/marketplace/templates/image-optimization.mdx
index d9625d5c95..e6ac49b7ad 100644
--- a/src/content/docs/en/pages/guides/marketplace/templates/image-optimization.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/templates/image-optimization.mdx
@@ -92,6 +92,6 @@ Read the documentation about [managing applications](/en/documentation/products/
Learn how to deploy the Image Optimization template. Watch the video below:
-
+
diff --git a/src/content/docs/en/pages/guides/marketplace/templates/static-cache.mdx b/src/content/docs/en/pages/guides/marketplace/templates/static-cache.mdx
index 34273fe821..6a69fd882d 100644
--- a/src/content/docs/en/pages/guides/marketplace/templates/static-cache.mdx
+++ b/src/content/docs/en/pages/guides/marketplace/templates/static-cache.mdx
@@ -94,5 +94,5 @@ Read the documentation about [managing applications](/en/documentation/products/
Learn how to deploy the Static Cache template. Watch the video below:
-
+
diff --git a/src/content/docs/en/pages/main-menu/manage-accounts/manage-profile/personal-token.mdx b/src/content/docs/en/pages/main-menu/manage-accounts/manage-profile/personal-token.mdx
index 2705c79d1c..430a4e5b26 100644
--- a/src/content/docs/en/pages/main-menu/manage-accounts/manage-profile/personal-token.mdx
+++ b/src/content/docs/en/pages/main-menu/manage-accounts/manage-profile/personal-token.mdx
@@ -80,13 +80,4 @@ You'll see a message confirming the deletion of your token.
Watch a video tutorial on how to manage a personal token on Azion's YouTube channel:
-
+
diff --git a/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx b/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx
index c9ef104a04..f64f823c3f 100644
--- a/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx
+++ b/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx
@@ -212,12 +212,4 @@ You can [debug rules created with Rules Engine for Firewall](/en/documentation/p
Watch a video tutorial about programming Firewall rules for optimal WAF usage and cost optimization on Azion's YouTube channel:
-
+
diff --git a/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-amazon-s3.mdx b/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-amazon-s3.mdx
index 47ff9d6962..7e3eaf0680 100644
--- a/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-amazon-s3.mdx
+++ b/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-amazon-s3.mdx
@@ -119,15 +119,7 @@ You can keep track of the calls made by Data Stream to Amazon S3 on [Real-Time E
Watch a video tutorial on how to use Amazon S3 with Data Stream on Azion’s YouTube channel:
-
+
---
diff --git a/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-aws-kinesis.mdx b/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-aws-kinesis.mdx
index 72bab8c60d..9e9811df71 100644
--- a/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-aws-kinesis.mdx
+++ b/src/content/docs/en/pages/observe-journey/data-stream/integrations/connector-aws-kinesis.mdx
@@ -122,15 +122,7 @@ You can keep track of the calls made by Data Stream to Amazon Kinesis Data Fireh
Watch a video tutorial on how to use Amazon Kinesis Data Firehose with Data Stream on Azion's YouTube channel:
-
+
---
diff --git a/src/content/docs/pt-br/pages/guias/data-streaming/associar-dominios.mdx b/src/content/docs/pt-br/pages/guias/data-streaming/associar-dominios.mdx
index 56585384d1..86a163ff60 100644
--- a/src/content/docs/pt-br/pages/guias/data-streaming/associar-dominios.mdx
+++ b/src/content/docs/pt-br/pages/guias/data-streaming/associar-dominios.mdx
@@ -48,15 +48,7 @@ Agora, os eventos associados com os domínios que você selecionou serão coleta
Assista um tutorial sobre como associar domínios no Data Stream no canal do YouTube da Azion, com opção de ativar legendas em português:
-
+
---
diff --git a/src/content/docs/pt-br/pages/guias/edge-dns/run-dig-command.mdx b/src/content/docs/pt-br/pages/guias/edge-dns/run-dig-command.mdx
index 906d94abd4..f481e870c3 100644
--- a/src/content/docs/pt-br/pages/guias/edge-dns/run-dig-command.mdx
+++ b/src/content/docs/pt-br/pages/guias/edge-dns/run-dig-command.mdx
@@ -97,7 +97,7 @@ Se você [configurou uma zona](/pt-br/documentacao/produtos/guias/secure/edge-dn
Você também pode checar a latência de uma aplicação web com o comando dig para validar o serviço de Edge Computing da Azion. É possível, por exemplo, comparar a latência da sua aplicação, servida por um serviço de Cloud Computing e pela Edge da Azion.
-
+
diff --git a/src/content/docs/pt-br/pages/menu-principal/gerencie-contas/gerenciar-perfis/personal-token.mdx b/src/content/docs/pt-br/pages/menu-principal/gerencie-contas/gerenciar-perfis/personal-token.mdx
index aec448be72..4c006a2eb6 100644
--- a/src/content/docs/pt-br/pages/menu-principal/gerencie-contas/gerenciar-perfis/personal-token.mdx
+++ b/src/content/docs/pt-br/pages/menu-principal/gerencie-contas/gerenciar-perfis/personal-token.mdx
@@ -80,15 +80,6 @@ Você verá uma mensagem confirmando a exclusão do seu token.
Assista esse tutorial sobre o gerenciamento de Personal Tokens no canal do YouTube da Azion:
-
+
---
\ No newline at end of file
diff --git a/src/util/videoObject.test.ts b/src/util/videoObject.test.ts
new file mode 100644
index 0000000000..6f484882e9
--- /dev/null
+++ b/src/util/videoObject.test.ts
@@ -0,0 +1,56 @@
+import { describe, expect, test } from 'vitest';
+import { getVideoObjectSchema, normalizeUploadDate } from './videoObject';
+
+describe('normalizeUploadDate', () => {
+ test('date-only gains midnight UTC offset', () => {
+ expect(normalizeUploadDate('2024-05-15')).toBe('2024-05-15T00:00:00+00:00');
+ });
+ test('datetime without offset gains Z', () => {
+ expect(normalizeUploadDate('2024-05-15T18:00:00')).toBe('2024-05-15T18:00:00Z');
+ });
+ test('datetime already in UTC is kept', () => {
+ expect(normalizeUploadDate('2024-05-15T18:00:00Z')).toBe('2024-05-15T18:00:00Z');
+ });
+ test('datetime with explicit offset is kept', () => {
+ expect(normalizeUploadDate('2024-05-15T18:00:00-03:00')).toBe('2024-05-15T18:00:00-03:00');
+ });
+ test('empty/undefined returns undefined', () => {
+ expect(normalizeUploadDate(undefined)).toBeUndefined();
+ expect(normalizeUploadDate('')).toBeUndefined();
+ expect(normalizeUploadDate(' ')).toBeUndefined();
+ });
+});
+
+describe('getVideoObjectSchema', () => {
+ const base = {
+ src: 'https://www.youtube.com/embed/KB4f4bSyHgI?autoplay=1',
+ title: 'How to look up DNS servers with Dig command',
+ };
+
+ test('emits embedUrl and a derived YouTube thumbnail (never contentUrl)', () => {
+ const schema = getVideoObjectSchema(base);
+ expect(schema.embedUrl).toBe(base.src);
+ expect(schema.thumbnailUrl).toBe('https://i.ytimg.com/vi/KB4f4bSyHgI/hqdefault.jpg');
+ expect(schema).not.toHaveProperty('contentUrl');
+ });
+
+ test('description falls back to the title when absent', () => {
+ expect(getVideoObjectSchema(base).description).toBe(base.title);
+ });
+
+ test('description is used when provided', () => {
+ const schema = getVideoObjectSchema({ ...base, description: 'A real description.' });
+ expect(schema.description).toBe('A real description.');
+ });
+
+ test('uploadDate is normalized to ISO 8601 with timezone', () => {
+ const schema = getVideoObjectSchema({ ...base, uploadDate: '2023-07-03' });
+ expect(schema.uploadDate).toBe('2023-07-03T00:00:00+00:00');
+ });
+
+ test('omits uploadDate and duration when not provided', () => {
+ const schema = getVideoObjectSchema(base);
+ expect(schema).not.toHaveProperty('uploadDate');
+ expect(schema).not.toHaveProperty('duration');
+ });
+});
diff --git a/src/util/videoObject.ts b/src/util/videoObject.ts
new file mode 100644
index 0000000000..273a0f9489
--- /dev/null
+++ b/src/util/videoObject.ts
@@ -0,0 +1,86 @@
+/**
+ * Builds a schema.org `VideoObject` JSON-LD node for a video embedded on a
+ * documentation page.
+ *
+ * Single source of truth: the same props that render the embed also feed this
+ * builder (see `~/components/Video.astro`), so the embed and its structured
+ * data can never diverge.
+ *
+ * Mirrors the decisions made in the `azion/site` repository:
+ * - uses `embedUrl` (never `contentUrl`);
+ * - derives `thumbnailUrl` from the YouTube video ID
+ * (`https://i.ytimg.com/vi/{ID}/hqdefault.jpg`) when not provided;
+ * - emits a stable `@id` derived from the page URL;
+ * - `duration` is optional and omitted when absent.
+ *
+ * See: https://developers.google.com/search/docs/appearance/structured-data/video
+ */
+
+export interface VideoObjectInput {
+ /** YouTube embed URL, e.g. `https://www.youtube.com/embed/KB4f4bSyHgI`. */
+ src: string;
+ /** Video title (`name`). */
+ title: string;
+ /** Optional video description. */
+ description?: string;
+ /** Overrides the derived YouTube thumbnail. */
+ thumbnailUrl?: string;
+ /** ISO 8601 date used as `uploadDate`. */
+ uploadDate?: string;
+ /** ISO 8601 duration, e.g. `PT1M30S`. Omitted when absent. */
+ duration?: string;
+ /** Stable, page-scoped `@id` for the node. */
+ id?: string;
+}
+
+/** Extracts the YouTube video ID from a `/embed/{ID}` URL. */
+export function getYouTubeId(embedUrl: string): string | null {
+ const match = embedUrl.match(/\/embed\/([^?/&#]+)/);
+ return match ? match[1] : null;
+}
+
+/**
+ * Normalizes `uploadDate` to a full ISO 8601 datetime WITH a timezone, which is
+ * what Google's VideoObject requires. Fixes the Search Console warnings
+ * "Datetime property 'uploadDate' is missing a timezone" and
+ * "Invalid datetime value for 'uploadDate'".
+ *
+ * - date-only `YYYY-MM-DD` → `YYYY-MM-DDT00:00:00+00:00`
+ * - datetime without offset `…T18:00` → append `Z` (UTC)
+ * - already has `Z`/offset → kept as-is
+ */
+export function normalizeUploadDate(value?: string): string | undefined {
+ if (!value) return undefined;
+ const trimmed = value.trim();
+ if (!trimmed) return undefined;
+ if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) return `${trimmed}T00:00:00+00:00`;
+ if (/T\d{2}:\d{2}/.test(trimmed) && !/(Z|[+-]\d{2}:?\d{2})$/.test(trimmed)) return `${trimmed}Z`;
+ return trimmed;
+}
+
+export function getVideoObjectSchema(input: VideoObjectInput) {
+ const { src, title, description, duration, id } = input;
+
+ const youtubeId = getYouTubeId(src);
+ const thumbnailUrl =
+ input.thumbnailUrl ??
+ (youtubeId ? `https://i.ytimg.com/vi/${youtubeId}/hqdefault.jpg` : undefined);
+ const uploadDate = normalizeUploadDate(input.uploadDate);
+
+ const schema: Record = {
+ '@context': 'https://schema.org',
+ '@type': 'VideoObject',
+ };
+
+ if (id) schema['@id'] = id;
+ schema.name = title;
+ // `description` is required by Google — always emit a non-empty value,
+ // falling back to the title when no description is provided.
+ schema.description = description || title;
+ if (thumbnailUrl) schema.thumbnailUrl = thumbnailUrl;
+ if (uploadDate) schema.uploadDate = uploadDate;
+ schema.embedUrl = src;
+ if (duration) schema.duration = duration;
+
+ return schema;
+}