From bb6f992115c44e5536620ffe7a2b548c11cbd786 Mon Sep 17 00:00:00 2001
From: Nick Trogh <nicktrog@microsoft.com>
Date: Wed, 2 Sep 2026 11:25:44 +0200
Subject: [PATCH 1/3] Add script to migrate embedded YouTube videos to linked
 thumbnails

---
 .../instructions/docs-writing.instructions.md |   4 +-
 build/replace-youtube-embeds.js               | 606 ++++++++++++++++++
 build/replace-youtube-embeds.test.js          | 159 +++++
 package.json                                  |   2 +
 4 files changed, 770 insertions(+), 1 deletion(-)
 create mode 100644 build/replace-youtube-embeds.js
 create mode 100644 build/replace-youtube-embeds.test.js

diff --git a/.github/instructions/docs-writing.instructions.md b/.github/instructions/docs-writing.instructions.md
index 9dd6348bb5..d9cb5b984d 100644
--- a/.github/instructions/docs-writing.instructions.md
+++ b/.github/instructions/docs-writing.instructions.md
@@ -118,7 +118,9 @@ Use the agreed framing to guide the plan, scope, structure, terminology, prerequ
 
 * Use videos only when they add value.
 * Videos have a descriptive and meaningful title that starts with "Video showing" or "Video of" and ends with ".".
-* For embedded videos, you MUST use `youtube-nocookie.com` instead of `youtube.com`.
+* Do not embed YouTube videos with an `iframe`. Use linked-image Markdown with a locally stored thumbnail. The site automatically opens external Markdown links in a new tab.
+* The thumbnail alt text is the link's accessible name. It must identify the video and announce that the link opens in a new tab, for example `[![Watch <video description> on YouTube (opens in new tab).](<thumbnail-path>)](<youtube-url>)`.
+* To migrate existing YouTube iframe embeds, run `npm run replace-youtube-embeds -- --write <file-or-directory>`. Omit `--write` to preview the migration.
 
 ## Lists
 
diff --git a/build/replace-youtube-embeds.js b/build/replace-youtube-embeds.js
new file mode 100644
index 0000000000..b26739254d
--- /dev/null
+++ b/build/replace-youtube-embeds.js
@@ -0,0 +1,606 @@
+// Replaces YouTube iframe embeds with locally stored, linked thumbnails.
+// Usage: node build/replace-youtube-embeds.js [--write] <file-or-directory> [...]
+
+/* eslint-disable security/detect-non-literal-fs-filename -- All content paths are constrained to the repository root. */
+
+const fs = require('fs');
+const https = require('https');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..');
+const VIDEO_ID_PATTERN = /^[A-Za-z0-9_-]{11}$/;
+const GENERIC_TITLES = new Set(['video', 'video player', 'youtube video', 'youtube video player']);
+const THUMBNAIL_QUALITIES = ['maxresdefault', 'sddefault', 'hqdefault'];
+const EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);
+const MAX_DOWNLOAD_BYTES = 10 * 1024 * 1024;
+
+function decodeHtml(value) {
+  return value
+    .replace(/&quot;/gi, '"')
+    .replace(/&#39;|&apos;/gi, "'")
+    .replace(/&amp;/gi, '&')
+    .replace(/&lt;/gi, '<')
+    .replace(/&gt;/gi, '>')
+    .replace(/&#(\d+);/g, function (_, code) {
+      return String.fromCharCode(Number(code));
+    })
+    .replace(/&#x([0-9a-f]+);/gi, function (_, code) {
+      return String.fromCharCode(parseInt(code, 16));
+    });
+}
+
+function parseAttributes(tag) {
+  const attributes = new Map();
+  let index = tag.toLowerCase().indexOf('<iframe') + '<iframe'.length;
+
+  while (index < tag.length) {
+    while (index < tag.length && /\s/.test(tag.charAt(index))) {
+      index++;
+    }
+    if (tag.charAt(index) === '>' || tag.substring(index, index + 2) === '/>') {
+      break;
+    }
+
+    const nameStart = index;
+    while (index < tag.length && /[:\w-]/.test(tag.charAt(index))) {
+      index++;
+    }
+    if (index === nameStart) {
+      index++;
+      continue;
+    }
+
+    const name = tag.substring(nameStart, index).toLowerCase();
+    while (index < tag.length && /\s/.test(tag.charAt(index))) {
+      index++;
+    }
+    if (tag.charAt(index) !== '=') {
+      continue;
+    }
+
+    index++;
+    while (index < tag.length && /\s/.test(tag.charAt(index))) {
+      index++;
+    }
+
+    const quote = tag.charAt(index);
+    let value;
+    if (quote === '"' || quote === "'") {
+      const valueStart = ++index;
+      while (index < tag.length && tag.charAt(index) !== quote) {
+        index++;
+      }
+      value = tag.substring(valueStart, index);
+      index++;
+    } else {
+      const valueStart = index;
+      while (index < tag.length && !/[\s>]/.test(tag.charAt(index))) {
+        index++;
+      }
+      value = tag.substring(valueStart, index);
+    }
+
+    attributes.set(name, decodeHtml(value));
+  }
+
+  return attributes;
+}
+
+function getVideoId(url) {
+  const hostname = url.hostname.toLowerCase().replace(/^www\./, '');
+  const pathParts = url.pathname.split('/').filter(Boolean);
+
+  if ((hostname === 'youtube.com' || hostname === 'youtube-nocookie.com') && pathParts[0] === 'embed') {
+    return pathParts[1];
+  }
+
+  if (hostname === 'youtu.be') {
+    return pathParts[0];
+  }
+
+  return undefined;
+}
+
+function isGenericTitle(title) {
+  return GENERIC_TITLES.has(title.toLowerCase().replace(/\.$/, '').trim());
+}
+
+function parseYouTubeIframe(iframe) {
+  const attributes = parseAttributes(iframe);
+  const source = attributes.get('src');
+  let sourceUrl;
+
+  if (!source) {
+    return { isYouTube: false };
+  }
+
+  try {
+    sourceUrl = new URL(source);
+  } catch (error) {
+    return { isYouTube: false };
+  }
+
+  const videoId = getVideoId(sourceUrl);
+  if (!videoId) {
+    return { isYouTube: false };
+  }
+
+  if (!VIDEO_ID_PATTERN.test(videoId)) {
+    return {
+      isYouTube: true,
+      error: `Invalid YouTube video ID "${videoId}".`
+    };
+  }
+
+  const title = (attributes.get('title') || '').replace(/\s+/g, ' ').trim();
+  if (!title || isGenericTitle(title)) {
+    return {
+      isYouTube: true,
+      error: `Video ${videoId} needs a meaningful iframe title before it can be migrated.`
+    };
+  }
+
+  return {
+    isYouTube: true,
+    videoId,
+    title
+  };
+}
+
+function getThumbnailPath(markdownPath, videoId) {
+  const articleName = path.basename(markdownPath, path.extname(markdownPath));
+  return path.join(path.dirname(markdownPath), 'images', articleName, `youtube-${videoId}.jpg`);
+}
+
+function renderLinkedThumbnail(embed, imagePath, markdownPath) {
+  const relativeImagePath = path.relative(path.dirname(markdownPath), imagePath).split(path.sep).join('/');
+  const title = embed.title.replace(/\.$/, '');
+  const accessibleName = `Watch ${title} on YouTube (opens in new tab).`;
+  const escapedAccessibleName = accessibleName.replace(/\\/g, '\\\\').replace(/\[/g, '\\[').replace(/\]/g, '\\]');
+
+  return `[![${escapedAccessibleName}](${relativeImagePath})](https://www.youtube.com/watch?v=${embed.videoId})`;
+}
+
+function findIframeRanges(content) {
+  const lowerContent = content.toLowerCase();
+  const ranges = [];
+  let searchIndex = 0;
+
+  while (searchIndex < content.length) {
+    const start = lowerContent.indexOf('<iframe', searchIndex);
+    if (start === -1) {
+      break;
+    }
+
+    const boundary = lowerContent.charAt(start + '<iframe'.length);
+    if (boundary && !/[\s>]/.test(boundary)) {
+      searchIndex = start + '<iframe'.length;
+      continue;
+    }
+
+    const closingStart = lowerContent.indexOf('</iframe', start + '<iframe'.length);
+    if (closingStart === -1) {
+      break;
+    }
+    const closingEnd = lowerContent.indexOf('>', closingStart + '</iframe'.length);
+    if (closingEnd === -1) {
+      break;
+    }
+
+    ranges.push({
+      end: closingEnd + 1,
+      start
+    });
+    searchIndex = closingEnd + 1;
+  }
+
+  return ranges;
+}
+
+function analyzeMarkdown(markdownPath, content) {
+  const embeds = [];
+  const issues = [];
+  let output = '';
+  let lastIndex = 0;
+
+  findIframeRanges(content).forEach(function (range) {
+    const iframe = content.substring(range.start, range.end);
+    const parsed = parseYouTubeIframe(iframe);
+    if (!parsed.isYouTube) {
+      return;
+    }
+
+    if (parsed.error) {
+      issues.push({
+        file: markdownPath,
+        line: content.substring(0, range.start).split('\n').length,
+        message: parsed.error
+      });
+      return;
+    }
+
+    const imagePath = getThumbnailPath(markdownPath, parsed.videoId);
+    output += content.substring(lastIndex, range.start);
+    output += renderLinkedThumbnail(parsed, imagePath, markdownPath);
+    lastIndex = range.end;
+    embeds.push({
+      videoId: parsed.videoId,
+      imagePath
+    });
+  });
+
+  output += content.substring(lastIndex);
+
+  return {
+    content: embeds.length > 0 ? output : content,
+    embeds,
+    issues
+  };
+}
+
+function isWithinRoot(candidatePath, root) {
+  const relativePath = path.relative(root, candidatePath);
+  return relativePath === '' || (!relativePath.startsWith(`..${path.sep}`) && relativePath !== '..' && !path.isAbsolute(relativePath));
+}
+
+function collectMarkdownFiles(inputs, root) {
+  const files = new Set();
+  const visitedDirectories = new Set();
+  const canonicalRoot = fs.realpathSync(root);
+
+  function visit(candidatePath, explicit) {
+    const absolutePath = path.resolve(candidatePath);
+    if (!fs.existsSync(absolutePath)) {
+      throw new Error(`Path does not exist: ${candidatePath}`);
+    }
+
+    const canonicalPath = fs.realpathSync(absolutePath);
+    if (!isWithinRoot(canonicalPath, canonicalRoot)) {
+      throw new Error(`Path must be inside ${canonicalRoot}: ${candidatePath}`);
+    }
+
+    const stat = fs.statSync(canonicalPath);
+    if (stat.isFile()) {
+      if (path.extname(canonicalPath).toLowerCase() !== '.md') {
+        if (explicit) {
+          throw new Error(`Expected a Markdown file: ${candidatePath}`);
+        }
+        return;
+      }
+      files.add(canonicalPath);
+      return;
+    }
+    if (!stat.isDirectory()) {
+      throw new Error(`Unsupported path: ${candidatePath}`);
+    }
+
+    if (visitedDirectories.has(canonicalPath)) {
+      return;
+    }
+    visitedDirectories.add(canonicalPath);
+
+    fs.readdirSync(canonicalPath, { withFileTypes: true })
+      .filter(function (entry) {
+        return !EXCLUDED_DIRECTORIES.has(entry.name);
+      })
+      .forEach(function (entry) {
+        visit(path.join(canonicalPath, entry.name), false);
+      });
+  }
+
+  inputs.forEach(function (input) {
+    visit(input, true);
+  });
+  return Array.from(files).sort();
+}
+
+function isJpeg(data) {
+  return data.length >= 4 &&
+    data[0] === 0xff &&
+    data[1] === 0xd8 &&
+    data[data.length - 2] === 0xff &&
+    data[data.length - 1] === 0xd9;
+}
+
+function requestBuffer(url, redirectsRemaining) {
+  const redirects = redirectsRemaining === undefined ? 5 : redirectsRemaining;
+
+  return new Promise(function (resolve, reject) {
+    const request = https.get(url, function (response) {
+      const statusCode = response.statusCode || 0;
+      const location = response.headers.location;
+
+      if (statusCode >= 300 && statusCode < 400 && location) {
+        response.resume();
+        if (redirects === 0) {
+          reject(new Error(`Too many redirects while downloading ${url}`));
+          return;
+        }
+        requestBuffer(new URL(location, url).toString(), redirects - 1).then(resolve, reject);
+        return;
+      }
+
+      if (statusCode !== 200) {
+        response.resume();
+        reject(new Error(`HTTP ${statusCode} from ${url}`));
+        return;
+      }
+
+      const chunks = [];
+      let totalBytes = 0;
+
+      response.on('data', function (chunk) {
+        totalBytes += chunk.length;
+        if (totalBytes > MAX_DOWNLOAD_BYTES) {
+          request.destroy(new Error(`Thumbnail exceeds ${MAX_DOWNLOAD_BYTES} bytes.`));
+          return;
+        }
+        chunks.push(chunk);
+      });
+      response.on('end', function () {
+        resolve({
+          contentType: response.headers['content-type'] || '',
+          data: Buffer.concat(chunks)
+        });
+      });
+      response.on('error', reject);
+    });
+
+    request.setTimeout(15000, function () {
+      request.destroy(new Error(`Timed out downloading ${url}`));
+    });
+    request.on('error', reject);
+  });
+}
+
+function downloadBestThumbnail(videoId, getBuffer) {
+  const fetchBuffer = getBuffer || requestBuffer;
+  const failures = [];
+  const qualities = THUMBNAIL_QUALITIES.slice();
+
+  function tryQuality() {
+    const quality = qualities.shift();
+    if (!quality) {
+      throw new Error(`Unable to download a JPEG thumbnail for ${videoId}: ${failures.join('; ')}`);
+    }
+
+    const url = `https://i.ytimg.com/vi/${videoId}/${quality}.jpg`;
+
+    return fetchBuffer(url).then(function (result) {
+      if (!/^image\/jpeg(?:;|$)/i.test(result.contentType) || !isJpeg(result.data)) {
+        throw new Error(`Invalid JPEG response from ${url}`);
+      }
+      return {
+        data: result.data,
+        quality,
+        url
+      };
+    }).catch(function (error) {
+      failures.push(`${quality}: ${error.message}`);
+      return tryQuality();
+    });
+  }
+
+  return tryQuality();
+}
+
+function prepareMigration(files) {
+  const filePlans = [];
+  const downloads = new Map();
+  const issues = [];
+  let embedCount = 0;
+
+  files.forEach(function (file) {
+    const originalContent = fs.readFileSync(file, 'utf8');
+    const analysis = analyzeMarkdown(file, originalContent);
+
+    embedCount += analysis.embeds.length + analysis.issues.length;
+    issues.push.apply(issues, analysis.issues);
+
+    if (analysis.embeds.length > 0) {
+      filePlans.push({
+        file,
+        content: analysis.content
+      });
+      analysis.embeds.forEach(function (embed) {
+        downloads.set(embed.imagePath, embed.videoId);
+      });
+    }
+  });
+
+  return {
+    downloads,
+    embedCount,
+    filePlans,
+    issues
+  };
+}
+
+function validateExistingImages(downloads) {
+  downloads.forEach(function (videoId, imagePath) {
+    if (fs.existsSync(imagePath) && !isJpeg(fs.readFileSync(imagePath))) {
+      throw new Error(`Existing thumbnail is not a valid JPEG for ${videoId}: ${imagePath}`);
+    }
+  });
+}
+
+function stageDownloads(downloads, getBuffer, logger) {
+  const staged = [];
+  const pending = [];
+
+  downloads.forEach(function (videoId, imagePath) {
+    if (!fs.existsSync(imagePath)) {
+      pending.push({ imagePath, videoId });
+    }
+  });
+
+  function cleanup() {
+    staged.forEach(function (item) {
+      if (fs.existsSync(item.temporaryPath)) {
+        fs.unlinkSync(item.temporaryPath);
+      }
+    });
+  }
+
+  return pending.reduce(function (promise, item, index) {
+    return promise.then(function () {
+      return downloadBestThumbnail(item.videoId, getBuffer).then(function (thumbnail) {
+        fs.mkdirSync(path.dirname(item.imagePath), { recursive: true });
+        const temporaryPath = `${item.imagePath}.tmp-${process.pid}-${index}`;
+        fs.writeFileSync(temporaryPath, thumbnail.data);
+        staged.push({
+          imagePath: item.imagePath,
+          temporaryPath
+        });
+        logger(`Downloaded ${item.videoId} (${thumbnail.quality}).`);
+      });
+    });
+  }, Promise.resolve()).then(function () {
+    return staged;
+  }).catch(function (error) {
+    cleanup();
+    throw error;
+  });
+}
+
+function commitMigration(filePlans, stagedDownloads) {
+  const temporaryMarkdownFiles = [];
+
+  try {
+    filePlans.forEach(function (plan, index) {
+      const temporaryPath = `${plan.file}.tmp-${process.pid}-${index}`;
+      fs.writeFileSync(temporaryPath, plan.content, 'utf8');
+      temporaryMarkdownFiles.push({
+        file: plan.file,
+        temporaryPath
+      });
+    });
+
+    stagedDownloads.forEach(function (item) {
+      fs.renameSync(item.temporaryPath, item.imagePath);
+    });
+    temporaryMarkdownFiles.forEach(function (item) {
+      fs.renameSync(item.temporaryPath, item.file);
+    });
+  } catch (error) {
+    stagedDownloads.concat(temporaryMarkdownFiles).forEach(function (item) {
+      if (fs.existsSync(item.temporaryPath)) {
+        fs.unlinkSync(item.temporaryPath);
+      }
+    });
+    throw error;
+  }
+}
+
+function formatSummary(summary, write) {
+  const action = write ? 'Replaced' : 'Would replace';
+  return `Found ${summary.foundCount} YouTube embed(s). ${action} ${summary.embedCount} embed(s) in ` +
+    `${summary.filePlans.length} file(s) with ${summary.downloads.size} local thumbnail(s); ` +
+    `${summary.issueCount} embed(s) need attention; scanned ${summary.fileCount} Markdown file(s).`;
+}
+
+function runMigration(options) {
+  const logger = options.logger || console.log;
+  const root = path.resolve(options.root || ROOT);
+  const files = collectMarkdownFiles(options.inputs, root);
+  const plan = prepareMigration(files);
+  const summary = {
+    downloads: plan.downloads,
+    embedCount: plan.embedCount,
+    fileCount: files.length,
+    filePlans: plan.filePlans,
+    foundCount: plan.embedCount,
+    issueCount: plan.issues.length
+  };
+  summary.foundCount += summary.issueCount;
+
+  if (plan.issues.length > 0) {
+    plan.issues.forEach(function (issue) {
+      logger(`${path.relative(root, issue.file)}:${issue.line}: ${issue.message}`);
+    });
+    logger(formatSummary(summary, false));
+    return Promise.reject(new Error(`Migration stopped with ${plan.issues.length} accessibility issue(s).`));
+  }
+
+  validateExistingImages(plan.downloads);
+
+  if (!options.write) {
+    logger(formatSummary(summary, false));
+    return Promise.resolve(summary);
+  }
+
+  return stageDownloads(plan.downloads, options.getBuffer, logger).then(function (stagedDownloads) {
+    commitMigration(plan.filePlans, stagedDownloads);
+    logger(formatSummary(summary, true));
+    return summary;
+  });
+}
+
+function printUsage() {
+  console.log([
+    'Usage: npm run replace-youtube-embeds -- [--write] <file-or-directory> [...]',
+    '',
+    'Runs in dry-run mode unless --write is provided.'
+  ].join('\n'));
+}
+
+function parseArguments(argv) {
+  const options = {
+    inputs: [],
+    write: false
+  };
+
+  argv.forEach(function (argument) {
+    if (argument === '--write') {
+      options.write = true;
+    } else if (argument === '--help' || argument === '-h') {
+      options.help = true;
+    } else if (argument.startsWith('-')) {
+      throw new Error(`Unknown option: ${argument}`);
+    } else {
+      options.inputs.push(argument);
+    }
+  });
+
+  return options;
+}
+
+function main() {
+  let options;
+
+  try {
+    options = parseArguments(process.argv.slice(2));
+    if (options.help) {
+      printUsage();
+      return;
+    }
+    if (options.inputs.length === 0) {
+      throw new Error('Provide at least one Markdown file or directory.');
+    }
+  } catch (error) {
+    console.error(error.message);
+    printUsage();
+    process.exitCode = 1;
+    return;
+  }
+
+  runMigration(options).catch(function (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+  });
+}
+
+module.exports = {
+  analyzeMarkdown,
+  collectMarkdownFiles,
+  downloadBestThumbnail,
+  isJpeg,
+  parseArguments,
+  parseYouTubeIframe,
+  renderLinkedThumbnail,
+  runMigration
+};
+
+if (require.main === module) {
+  main();
+}
diff --git a/build/replace-youtube-embeds.test.js b/build/replace-youtube-embeds.test.js
new file mode 100644
index 0000000000..1682d8f2da
--- /dev/null
+++ b/build/replace-youtube-embeds.test.js
@@ -0,0 +1,159 @@
+const assert = require('node:assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const test = require('node:test');
+
+/* eslint-disable security/detect-non-literal-fs-filename -- Tests use paths under isolated temporary directories. */
+
+const {
+  analyzeMarkdown,
+  downloadBestThumbnail,
+  parseYouTubeIframe,
+  renderLinkedThumbnail,
+  runMigration
+} = require('./replace-youtube-embeds');
+
+const JPEG = Buffer.from([0xff, 0xd8, 0xff, 0xe0, 0xff, 0xd9]);
+
+test('parses supported YouTube iframe variants', function () {
+  const iframe = [
+    '<iframe',
+    ' title="Video showing &quot;debugging&quot; in VS Code."',
+    " height='315'",
+    ' src="https://www.youtube-nocookie.com/embed/3HiLLByBWkg?rel=0&amp;start=10"',
+    ' width=560>',
+    '</iframe>'
+  ].join('\n');
+
+  assert.deepEqual(parseYouTubeIframe(iframe), {
+    isYouTube: true,
+    videoId: '3HiLLByBWkg',
+    title: 'Video showing "debugging" in VS Code.'
+  });
+});
+
+test('rejects generic iframe titles', function () {
+  assert.deepEqual(
+    parseYouTubeIframe('<iframe src="https://youtu.be/3HiLLByBWkg" title="YouTube video player"></iframe>'),
+    {
+      isYouTube: true,
+      error: 'Video 3HiLLByBWkg needs a meaningful iframe title before it can be migrated.'
+    }
+  );
+});
+
+test('renders an accessible Markdown thumbnail link', function () {
+  const markdownPath = path.join('docs', 'debugtest', 'debugging.md');
+  const imagePath = path.join('docs', 'debugtest', 'images', 'debugging', 'youtube-3HiLLByBWkg.jpg');
+  const output = renderLinkedThumbnail({
+    videoId: '3HiLLByBWkg',
+    title: 'Video showing "debugging" in [VS Code].'
+  }, imagePath, markdownPath);
+
+  assert.equal(
+    output,
+    '[![Watch Video showing "debugging" in \\[VS Code\\] on YouTube (opens in new tab).](images/debugging/youtube-3HiLLByBWkg.jpg)](https://www.youtube.com/watch?v=3HiLLByBWkg)'
+  );
+});
+
+test('falls back to the next valid JPEG thumbnail', function () {
+  const requestedUrls = [];
+
+  return downloadBestThumbnail('3HiLLByBWkg', function (url) {
+    requestedUrls.push(url);
+    if (url.includes('maxresdefault')) {
+      return Promise.reject(new Error('HTTP 404'));
+    }
+    return Promise.resolve({
+      contentType: 'image/jpeg',
+      data: JPEG
+    });
+  }).then(function (thumbnail) {
+    assert.equal(thumbnail.quality, 'sddefault');
+    assert.equal(requestedUrls.length, 2);
+  });
+});
+
+test('dry-run reports changes without writing files or downloading images', function () {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'youtube-embed-dry-run-'));
+  const markdownPath = path.join(root, 'article.md');
+  const original = '<iframe src="https://www.youtube.com/embed/3HiLLByBWkg" title="Video showing debugging."></iframe>\n';
+  let downloadCalled = false;
+
+  fs.writeFileSync(markdownPath, original);
+
+  return runMigration({
+    getBuffer: function () {
+      downloadCalled = true;
+      return Promise.resolve({ contentType: 'image/jpeg', data: JPEG });
+    },
+    inputs: [markdownPath],
+    logger: function () {},
+    root
+  }).then(function (summary) {
+    assert.equal(summary.embedCount, 1);
+    assert.equal(downloadCalled, false);
+    assert.equal(fs.readFileSync(markdownPath, 'utf8'), original);
+    assert.equal(fs.existsSync(path.join(root, 'images', 'article', 'youtube-3HiLLByBWkg.jpg')), false);
+  }).finally(function () {
+    fs.rmSync(root, { recursive: true, force: true });
+  });
+});
+
+test('directory input recursively scans only Markdown files', function () {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'youtube-embed-directory-'));
+  const nestedDirectory = path.join(root, 'nested');
+  const markdownPath = path.join(nestedDirectory, 'article.md');
+
+  fs.mkdirSync(nestedDirectory);
+  fs.writeFileSync(path.join(root, 'package.json'), '{}');
+  fs.writeFileSync(markdownPath, '<iframe src="https://www.youtube.com/embed/3HiLLByBWkg" title="Video showing debugging."></iframe>\n');
+
+  return runMigration({
+    inputs: [root],
+    logger: function () {},
+    root
+  }).then(function (summary) {
+    assert.equal(summary.fileCount, 1);
+    assert.equal(summary.embedCount, 1);
+  }).finally(function () {
+    fs.rmSync(root, { recursive: true, force: true });
+  });
+});
+
+test('failed downloads leave Markdown unchanged', function () {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'youtube-embed-failure-'));
+  const markdownPath = path.join(root, 'article.md');
+  const original = '<iframe src="https://www.youtube.com/embed/3HiLLByBWkg" title="Video showing debugging."></iframe>\n';
+
+  fs.writeFileSync(markdownPath, original);
+
+  return assert.rejects(runMigration({
+    getBuffer: function () {
+      return Promise.reject(new Error('network unavailable'));
+    },
+    inputs: [markdownPath],
+    logger: function () {},
+    root,
+    write: true
+  }), /Unable to download a JPEG thumbnail/).then(function () {
+    assert.equal(fs.readFileSync(markdownPath, 'utf8'), original);
+    assert.equal(fs.existsSync(path.join(root, 'images', 'article', 'youtube-3HiLLByBWkg.jpg')), false);
+  }).finally(function () {
+    fs.rmSync(root, { recursive: true, force: true });
+  });
+});
+
+test('analyzes only YouTube iframes', function () {
+  const markdownPath = path.join('docs', 'article.md');
+  const content = [
+    '<iframe src="https://example.com/embed/3HiLLByBWkg" title="Example"></iframe>',
+    '<iframe src="https://www.youtube.com/embed/3HiLLByBWkg" title="Video showing debugging."></iframe>'
+  ].join('\n');
+  const analysis = analyzeMarkdown(markdownPath, content);
+
+  assert.equal(analysis.embeds.length, 1);
+  assert.match(analysis.content, /https:\/\/example\.com/);
+  assert.doesNotMatch(analysis.content, /youtube\.com\/embed/);
+});
diff --git a/package.json b/package.json
index e3ace04d37..81d0ed02cd 100644
--- a/package.json
+++ b/package.json
@@ -14,6 +14,8 @@
     "check-staged-files": "node ./build/check-staged-files.js",
     "lint": "eslint **/*.js",
     "prepare": "husky install",
+    "replace-youtube-embeds": "node ./build/replace-youtube-embeds.js",
+    "test:replace-youtube-embeds": "node --test ./build/replace-youtube-embeds.test.js",
     "generate-sidebar": "node ./build/generate-sidebar.js",
     "serve": "npm run generate-sidebar && docsify serve .",
     "test-release-note-toc": "node --test ./build/release-note-toc.test.js"

From 8214a7ced89d2bb16ebd7d29881d6b7bc5b27f0c Mon Sep 17 00:00:00 2001
From: Nick Trogh <nicktrog@microsoft.com>
Date: Wed, 2 Sep 2026 11:51:03 +0200
Subject: [PATCH 2/3] Updated iframe links to YouTube video links for better
 accessibility.

---
 .../introvideos/youtube-LUl_WXt8ohA.jpg       |   3 +
 blogs/2016/08/15/introvideos.md               |   2 +-
 .../video-introducing-live-share.jpg          |   3 +
 blogs/2017/11/15/live-share.md                |   2 +-
 .../rich-navigation/youtube-DAqDEi0fGco.jpg   |   3 +
 blogs/2018/12/04/rich-navigation.md           |   2 +-
 .../youtube-TVcoGLL6Smo.jpg                   |   3 +
 .../youtube-mIHprjsSO9o.jpg                   |   3 +
 .../youtube-rh1Ag41J6IA.jpg                   |   3 +
 blogs/2019/05/02/remote-development.md        |   6 +-
 blogs/2020/05/06/github-issues-integration.md |   2 +-
 .../youtube-T6sW1Dk9B4E.jpg                   |   3 +
 blogs/2021/06/02/build-2021.md                |  14 +--
 .../images/build-2021/youtube-DyKYB76SDx0.jpg |   3 +
 .../images/build-2021/youtube-EWYYgEkGJfs.jpg |   3 +
 .../images/build-2021/youtube-Jk708pQJSyk.jpg |   3 +
 .../images/build-2021/youtube-WyAikmxLlhs.jpg |   3 +
 .../images/build-2021/youtube-eKJftIqv8Uo.jpg |   3 +
 .../images/build-2021/youtube-jN2INtCLRTo.jpg |   3 +
 .../images/build-2021/youtube-wiUzCG_mEGo.jpg |   3 +
 blogs/2021/11/08/custom-notebooks.md          |   2 +-
 .../custom-notebooks/youtube-D-AXZZDTQhM.jpg  |   3 +
 blogs/2024/12/18/free-github-copilot.md       |   2 +-
 .../youtube-MLWlWrRAb4w.jpg                   |   3 +
 blogs/2025/05/12/agent-mode-meets-mcp.md      |   2 +-
 .../youtube-VePxCcF99w4.jpg                   |   3 +
 blogs/2025/05/27/ai-and-remote.md             |   2 +-
 .../ai-and-remote/youtube-ErYP9LRo7e0.jpg     |   3 +
 blogs/2025/10/22/bring-your-own-key.md        |   2 +-
 .../youtube-xXFTlPZJJoo.jpg                   |   3 +
 blogs/2025/11/18/PrivateMarketplace.md        |   2 +-
 .../youtube-nQLdmy50cb0.jpg                   |   3 +
 .../mcp-apps-support/youtube-fbNH6_jdwQU.jpg  |   3 +
 blogs/2026/01/26/mcp-apps-support.md          |   2 +-
 .../youtube-BsAHunfVwNs.jpg                   |   3 +
 blogs/2026/02/05/multi-agent-development.md   |   2 +-
 .../2026/03/13/how-VS-Code-Builds-with-AI.md  |   2 +-
 .../youtube-ee-obY-4rqk.jpg                   |   3 +
 blogs/2026/06/18/byok-vscode.md               |   2 +-
 .../byok-vscode/youtube-EB7dQv1ALCU.jpg       |   3 +
 blogs/2026/08/26/agent-host-architecture.md   |   2 +-
 .../youtube-k91ejc3G1YM.jpg                   |   3 +
 build/replace-youtube-embeds.js               | 107 +++++++++++++++---
 build/replace-youtube-embeds.test.js          |  43 +++++++
 .../youtube-hh1nOX14TyY.jpg                   |   3 +
 .../agents/guides/prompt-engineering-guide.md |   2 +-
 docs/cpp/cmake-linux.md                       |   2 +-
 docs/cpp/config-mingw.md                      |   2 +-
 .../cmake-linux/youtube-_BWU5mWqVA4.jpg       |   3 +
 .../config-mingw/youtube-oC69vlWofJQ.jpg      |   3 +
 .../video-build-cpp-project.jpg               |   3 +
 .../video-configure-cpp-intellisense.jpg      |   3 +
 .../video-debug-cpp-project.jpg               |   3 +
 .../introvideos-cpp/youtube-ZfT2CXY5-Dc.jpg   |   3 +
 .../introvideos-cpp/youtube-qeEcV6u1kV4.jpg   |   3 +
 docs/cpp/introvideos-cpp.md                   |  10 +-
 .../youtube-8M-wwFTqsCs.jpg                   |   3 +
 .../youtube-HnP6pkE8Tjs.jpg                   |   3 +
 .../youtube-S4Rks1L03LI.jpg                   |   3 +
 .../youtube-TGM386ZzeOc.jpg                   |   3 +
 .../youtube-VuIOk3DqKgc.jpg                   |   3 +
 .../youtube-jF9ltwBK2Wk.jpg                   |   3 +
 .../youtube-tFCZw-wZVtg.jpg                   |   3 +
 docs/csharp/introvideos-csharp.md             |  14 +--
 .../jupyter-notebooks/youtube-suAkMeWJ1yE.jpg |   3 +
 docs/datascience/jupyter-notebooks.md         |   2 +-
 docs/debugtest/debugging.md                   |   2 +-
 .../images/debugging/youtube-3HiLLByBWkg.jpg  |   3 +
 .../userinterface/youtube-nORT3-kONgA.jpg     |   3 +
 docs/editing/getting-started/userinterface.md |   2 +-
 docs/getstarted/educators-and-students.md     |   6 +-
 .../youtube-A2ceblXTBBc.jpg                   |   3 +
 docs/introvideos/basics.md                    |   2 +-
 docs/introvideos/codeediting.md               |   2 +-
 docs/introvideos/configure.md                 |   2 +-
 docs/introvideos/customize.md                 |   2 +-
 docs/introvideos/debugging.md                 |   2 +-
 docs/introvideos/extend.md                    |   2 +-
 .../images/basics/youtube-f8_uF_IDV50.jpg     |   3 +
 .../codeediting/youtube-MNBwGGwvvKE.jpg       |   3 +
 .../images/configure/youtube-HOShAQzOy4Q.jpg  |   3 +
 .../images/customize/youtube-nORT3-kONgA.jpg  |   3 +
 .../images/debugging/youtube-3HiLLByBWkg.jpg  |   3 +
 .../images/extend/youtube-SKcZ3cwX8lA.jpg     |   3 +
 .../productivity/youtube-HIqONcVBEm0.jpg      |   3 +
 .../versioncontrol/youtube-i_23KUAEtUM.jpg    |   3 +
 docs/introvideos/productivity.md              |   2 +-
 docs/introvideos/versioncontrol.md            |   2 +-
 .../tutorial-fastapi/youtube-fPCjEbRpK1M.jpg  |   3 +
 docs/python/tutorial-fastapi.md               |   2 +-
 .../images/tunnels/youtube-SyLHXdXhE1U.jpg    |   3 +
 .../images/vscode-web/youtube-2sdXMJZKLJE.jpg |   3 +
 docs/remote/tunnels.md                        |   2 +-
 docs/remote/vscode-web.md                     |   2 +-
 .../images/overview/youtube-i_23KUAEtUM.jpg   |   3 +
 docs/sourcecontrol/overview.md                |   2 +-
 learn/agents/1-using-tools-with-agents.md     |   2 +-
 .../2-extending-agents-with-mcp-servers.md    |   2 +-
 learn/agents/3-agent-plugins.md               |   2 +-
 .../4-using-third-party-agents-in-vs-code.md  |   2 +-
 .../youtube-wZrQ0TAfpFg.jpg                   |   3 +
 .../youtube-Sf4qD7SS2NA.jpg                   |   3 +
 .../3-agent-plugins/youtube-9lonfxt7dqU.jpg   |   3 +
 .../youtube-OWYQ8Mn7KqE.jpg                   |   3 +
 .../1-why-customization-matter.md             |   2 +-
 learn/customizations/2-instructions.md        |   2 +-
 learn/customizations/3-skills.md              |   2 +-
 learn/customizations/4-custom-agent.md        |   2 +-
 learn/customizations/5-hooks.md               |   2 +-
 learn/customizations/6-prompt-files.md        |   2 +-
 .../7-customization-features-explained.md     |   2 +-
 learn/customizations/8-demo.md                |   2 +-
 .../youtube-AZzCk-WGks4.jpg                   |   3 +
 .../2-instructions/youtube-dk2biPguo_E.jpg    |   3 +
 .../images/3-skills/youtube-mPjTZviv23s.jpg   |   3 +
 .../4-custom-agent/youtube-Y7MPeZTIgqo.jpg    |   3 +
 .../images/5-hooks/youtube-ZsyiRa91XZg.jpg    |   3 +
 .../6-prompt-files/youtube-d37Y28uU2JY.jpg    |   3 +
 .../youtube-oyMMotLlcgQ.jpg                   |   3 +
 .../images/8-demo/youtube-Bb45ZoKfJf0.jpg     |   3 +
 .../agent-sessions-and-where-agents-run.md    |   2 +-
 .../approvals-autonomy-and-context-budget.md  |   2 +-
 .../build-your-first-app-with-agent-mode.md   |   2 +-
 ...g-and-whats-happening-behind-the-scenes.md |   2 +-
 .../youtube-0CsKOO7d35I.jpg                   |   3 +
 .../youtube-WcN74XvZGes.jpg                   |   3 +
 .../youtube-hmfldW7dmgw.jpg                   |   3 +
 .../youtube-aW2jlbbUREc.jpg                   |   3 +
 .../youtube-uu4sf8z9n8c.jpg                   |   3 +
 .../youtube-oFSJs6RnFt4.jpg                   |   3 +
 ...introduction-to-agent-first-development.md |   2 +-
 ...reviewing-and-controlling-agent-changes.md |   2 +-
 .../1-get-started.md                          |   2 +-
 .../2-exploring-models.md                     |   2 +-
 .../3-building-social-media-agent.md          |   2 +-
 .../4-building-hosted-agent.md                |   2 +-
 .../1-get-started/youtube-aQFSDGAk9DA.jpg     |   3 +
 .../youtube-92tKoJOTays.jpg                   |   3 +
 .../youtube-NPGMgljY2Gs.jpg                   |   3 +
 .../youtube-pxG-9Lh_a44.jpg                   |   3 +
 learn/java-spring-boot/1-build-and-run.md     |   2 +-
 learn/java-spring-boot/2-debug-and-inspect.md |   2 +-
 .../3-expose-tools-with-mcp.md                |   2 +-
 .../4-test-with-playwright.md                 |   2 +-
 .../1-build-and-run/youtube-ZX8LEQpKPx0.jpg   |   3 +
 .../youtube-y8SdqmjEqq8.jpg                   |   3 +
 .../youtube-gzyU4yn0qGw.jpg                   |   3 +
 .../youtube-NR4YHj_9WFw.jpg                   |   3 +
 release-notes/v1_61.md                        |   2 +-
 .../add-local-file-mount.md                   |   2 +-
 .../change-default-source-mount.md            |   4 +-
 .../environment-variables.md                  |   4 +-
 .../youtube-L1-dx-ZD0Ao.jpg                   |   3 +
 .../youtube-4zX2XWTmr3c.jpg                   |   3 +
 .../youtube-o5coAL7oE0o.jpg                   |   3 +
 .../youtube-qTU7w3bWrOk.jpg                   |   3 +
 .../youtube-vEb7hKlagAU.jpg                   |   3 +
 .../youtube-MUsROtVmPJM.jpg                   |   3 +
 .../youtube-iDdJWIPRUx4.jpg                   |   3 +
 .../youtube-12nZz-TjoZg.jpg                   |   3 +
 .../start-processes/youtube-9qRy_kxVCK8.jpg   |   3 +
 .../start-processes/youtube-KuSNpZgDYDs.jpg   |   3 +
 .../start-processes/youtube-zFzPnWgBx_I.jpg   |   3 +
 .../advancedcontainers/improve-performance.md |   4 +-
 .../persist-bash-history.md                   |   2 +-
 remote/advancedcontainers/start-processes.md  |   6 +-
 166 files changed, 512 insertions(+), 109 deletions(-)
 create mode 100644 blogs/2016/08/15/images/introvideos/youtube-LUl_WXt8ohA.jpg
 create mode 100644 blogs/2017/11/15/images/live-share/video-introducing-live-share.jpg
 create mode 100644 blogs/2018/12/04/images/rich-navigation/youtube-DAqDEi0fGco.jpg
 create mode 100644 blogs/2019/05/02/images/remote-development/youtube-TVcoGLL6Smo.jpg
 create mode 100644 blogs/2019/05/02/images/remote-development/youtube-mIHprjsSO9o.jpg
 create mode 100644 blogs/2019/05/02/images/remote-development/youtube-rh1Ag41J6IA.jpg
 create mode 100644 blogs/2020/05/06/images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg
 create mode 100644 blogs/2021/06/02/images/build-2021/youtube-DyKYB76SDx0.jpg
 create mode 100644 blogs/2021/06/02/images/build-2021/youtube-EWYYgEkGJfs.jpg
 create mode 100644 blogs/2021/06/02/images/build-2021/youtube-Jk708pQJSyk.jpg
 create mode 100644 blogs/2021/06/02/images/build-2021/youtube-WyAikmxLlhs.jpg
 create mode 100644 blogs/2021/06/02/images/build-2021/youtube-eKJftIqv8Uo.jpg
 create mode 100644 blogs/2021/06/02/images/build-2021/youtube-jN2INtCLRTo.jpg
 create mode 100644 blogs/2021/06/02/images/build-2021/youtube-wiUzCG_mEGo.jpg
 create mode 100644 blogs/2021/11/08/images/custom-notebooks/youtube-D-AXZZDTQhM.jpg
 create mode 100644 blogs/2024/12/18/images/free-github-copilot/youtube-MLWlWrRAb4w.jpg
 create mode 100644 blogs/2025/05/12/images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg
 create mode 100644 blogs/2025/05/27/images/ai-and-remote/youtube-ErYP9LRo7e0.jpg
 create mode 100644 blogs/2025/10/22/images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg
 create mode 100644 blogs/2025/11/18/images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg
 create mode 100644 blogs/2026/01/26/images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg
 create mode 100644 blogs/2026/02/05/images/multi-agent-development/youtube-BsAHunfVwNs.jpg
 create mode 100644 blogs/2026/03/13/images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg
 create mode 100644 blogs/2026/06/18/images/byok-vscode/youtube-EB7dQv1ALCU.jpg
 create mode 100644 blogs/2026/08/26/images/agent-host-architecture/youtube-k91ejc3G1YM.jpg
 create mode 100644 docs/agents/guides/images/prompt-engineering-guide/youtube-hh1nOX14TyY.jpg
 create mode 100644 docs/cpp/images/cmake-linux/youtube-_BWU5mWqVA4.jpg
 create mode 100644 docs/cpp/images/config-mingw/youtube-oC69vlWofJQ.jpg
 create mode 100644 docs/cpp/images/introvideos-cpp/video-build-cpp-project.jpg
 create mode 100644 docs/cpp/images/introvideos-cpp/video-configure-cpp-intellisense.jpg
 create mode 100644 docs/cpp/images/introvideos-cpp/video-debug-cpp-project.jpg
 create mode 100644 docs/cpp/images/introvideos-cpp/youtube-ZfT2CXY5-Dc.jpg
 create mode 100644 docs/cpp/images/introvideos-cpp/youtube-qeEcV6u1kV4.jpg
 create mode 100644 docs/csharp/images/introvideos-csharp/youtube-8M-wwFTqsCs.jpg
 create mode 100644 docs/csharp/images/introvideos-csharp/youtube-HnP6pkE8Tjs.jpg
 create mode 100644 docs/csharp/images/introvideos-csharp/youtube-S4Rks1L03LI.jpg
 create mode 100644 docs/csharp/images/introvideos-csharp/youtube-TGM386ZzeOc.jpg
 create mode 100644 docs/csharp/images/introvideos-csharp/youtube-VuIOk3DqKgc.jpg
 create mode 100644 docs/csharp/images/introvideos-csharp/youtube-jF9ltwBK2Wk.jpg
 create mode 100644 docs/csharp/images/introvideos-csharp/youtube-tFCZw-wZVtg.jpg
 create mode 100644 docs/datascience/images/jupyter-notebooks/youtube-suAkMeWJ1yE.jpg
 create mode 100644 docs/debugtest/images/debugging/youtube-3HiLLByBWkg.jpg
 create mode 100644 docs/editing/getting-started/images/userinterface/youtube-nORT3-kONgA.jpg
 create mode 100644 docs/getstarted/images/educators-and-students/youtube-A2ceblXTBBc.jpg
 create mode 100644 docs/introvideos/images/basics/youtube-f8_uF_IDV50.jpg
 create mode 100644 docs/introvideos/images/codeediting/youtube-MNBwGGwvvKE.jpg
 create mode 100644 docs/introvideos/images/configure/youtube-HOShAQzOy4Q.jpg
 create mode 100644 docs/introvideos/images/customize/youtube-nORT3-kONgA.jpg
 create mode 100644 docs/introvideos/images/debugging/youtube-3HiLLByBWkg.jpg
 create mode 100644 docs/introvideos/images/extend/youtube-SKcZ3cwX8lA.jpg
 create mode 100644 docs/introvideos/images/productivity/youtube-HIqONcVBEm0.jpg
 create mode 100644 docs/introvideos/images/versioncontrol/youtube-i_23KUAEtUM.jpg
 create mode 100644 docs/python/images/tutorial-fastapi/youtube-fPCjEbRpK1M.jpg
 create mode 100644 docs/remote/images/tunnels/youtube-SyLHXdXhE1U.jpg
 create mode 100644 docs/remote/images/vscode-web/youtube-2sdXMJZKLJE.jpg
 create mode 100644 docs/sourcecontrol/images/overview/youtube-i_23KUAEtUM.jpg
 create mode 100644 learn/agents/images/1-using-tools-with-agents/youtube-wZrQ0TAfpFg.jpg
 create mode 100644 learn/agents/images/2-extending-agents-with-mcp-servers/youtube-Sf4qD7SS2NA.jpg
 create mode 100644 learn/agents/images/3-agent-plugins/youtube-9lonfxt7dqU.jpg
 create mode 100644 learn/agents/images/4-using-third-party-agents-in-vs-code/youtube-OWYQ8Mn7KqE.jpg
 create mode 100644 learn/customizations/images/1-why-customization-matter/youtube-AZzCk-WGks4.jpg
 create mode 100644 learn/customizations/images/2-instructions/youtube-dk2biPguo_E.jpg
 create mode 100644 learn/customizations/images/3-skills/youtube-mPjTZviv23s.jpg
 create mode 100644 learn/customizations/images/4-custom-agent/youtube-Y7MPeZTIgqo.jpg
 create mode 100644 learn/customizations/images/5-hooks/youtube-ZsyiRa91XZg.jpg
 create mode 100644 learn/customizations/images/6-prompt-files/youtube-d37Y28uU2JY.jpg
 create mode 100644 learn/customizations/images/7-customization-features-explained/youtube-oyMMotLlcgQ.jpg
 create mode 100644 learn/customizations/images/8-demo/youtube-Bb45ZoKfJf0.jpg
 create mode 100644 learn/foundations/images/agent-sessions-and-where-agents-run/youtube-0CsKOO7d35I.jpg
 create mode 100644 learn/foundations/images/approvals-autonomy-and-context-budget/youtube-WcN74XvZGes.jpg
 create mode 100644 learn/foundations/images/build-your-first-app-with-agent-mode/youtube-hmfldW7dmgw.jpg
 create mode 100644 learn/foundations/images/debugging-and-whats-happening-behind-the-scenes/youtube-aW2jlbbUREc.jpg
 create mode 100644 learn/foundations/images/introduction-to-agent-first-development/youtube-uu4sf8z9n8c.jpg
 create mode 100644 learn/foundations/images/reviewing-and-controlling-agent-changes/youtube-oFSJs6RnFt4.jpg
 create mode 100644 learn/foundry-toolkit-extension/images/1-get-started/youtube-aQFSDGAk9DA.jpg
 create mode 100644 learn/foundry-toolkit-extension/images/2-exploring-models/youtube-92tKoJOTays.jpg
 create mode 100644 learn/foundry-toolkit-extension/images/3-building-social-media-agent/youtube-NPGMgljY2Gs.jpg
 create mode 100644 learn/foundry-toolkit-extension/images/4-building-hosted-agent/youtube-pxG-9Lh_a44.jpg
 create mode 100644 learn/java-spring-boot/images/1-build-and-run/youtube-ZX8LEQpKPx0.jpg
 create mode 100644 learn/java-spring-boot/images/2-debug-and-inspect/youtube-y8SdqmjEqq8.jpg
 create mode 100644 learn/java-spring-boot/images/3-expose-tools-with-mcp/youtube-gzyU4yn0qGw.jpg
 create mode 100644 learn/java-spring-boot/images/4-test-with-playwright/youtube-NR4YHj_9WFw.jpg
 create mode 100644 remote/advancedcontainers/images/add-local-file-mount/youtube-L1-dx-ZD0Ao.jpg
 create mode 100644 remote/advancedcontainers/images/change-default-source-mount/youtube-4zX2XWTmr3c.jpg
 create mode 100644 remote/advancedcontainers/images/change-default-source-mount/youtube-o5coAL7oE0o.jpg
 create mode 100644 remote/advancedcontainers/images/environment-variables/youtube-qTU7w3bWrOk.jpg
 create mode 100644 remote/advancedcontainers/images/environment-variables/youtube-vEb7hKlagAU.jpg
 create mode 100644 remote/advancedcontainers/images/improve-performance/youtube-MUsROtVmPJM.jpg
 create mode 100644 remote/advancedcontainers/images/improve-performance/youtube-iDdJWIPRUx4.jpg
 create mode 100644 remote/advancedcontainers/images/persist-bash-history/youtube-12nZz-TjoZg.jpg
 create mode 100644 remote/advancedcontainers/images/start-processes/youtube-9qRy_kxVCK8.jpg
 create mode 100644 remote/advancedcontainers/images/start-processes/youtube-KuSNpZgDYDs.jpg
 create mode 100644 remote/advancedcontainers/images/start-processes/youtube-zFzPnWgBx_I.jpg

diff --git a/blogs/2016/08/15/images/introvideos/youtube-LUl_WXt8ohA.jpg b/blogs/2016/08/15/images/introvideos/youtube-LUl_WXt8ohA.jpg
new file mode 100644
index 0000000000..289d94d1c4
--- /dev/null
+++ b/blogs/2016/08/15/images/introvideos/youtube-LUl_WXt8ohA.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2007a7b4204f9e33e03a4f185b0d2367930300b6d6a8403ad023da6efbc330df
+size 40669
diff --git a/blogs/2016/08/15/introvideos.md b/blogs/2016/08/15/introvideos.md
index 4380835af8..b675954248 100644
--- a/blogs/2016/08/15/introvideos.md
+++ b/blogs/2016/08/15/introvideos.md
@@ -24,7 +24,7 @@ Navigate to [Intro Videos - Overview](/docs/getstarted/introvideos.md) to get st
 
 Below is the first video covering downloading, installing, and the basics of using VS Code:
 
-<iframe src="https://www.youtube-nocookie.com/embed/LUl_WXt8ohA?rel=0&amp;disablekb=0&amp;modestbranding=1&amp;showinfo=0" frameborder="0" allowfullscreen></iframe>
+[![Watch Welcome to VS Code on YouTube (opens in new tab).](images/introvideos/youtube-LUl_WXt8ohA.jpg)](https://www.youtube.com/watch?v=LUl_WXt8ohA)
 
 You can see the video outline [here](/docs/introvideos/basics.md) as well as additional introductory learning resources.
 
diff --git a/blogs/2017/11/15/images/live-share/video-introducing-live-share.jpg b/blogs/2017/11/15/images/live-share/video-introducing-live-share.jpg
new file mode 100644
index 0000000000..7ce225b120
--- /dev/null
+++ b/blogs/2017/11/15/images/live-share/video-introducing-live-share.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:05feebbb28da8ae5d61891b24c4325136a30630a0f5e2369d9431e9d0254fbdf
+size 23616
diff --git a/blogs/2017/11/15/live-share.md b/blogs/2017/11/15/live-share.md
index 4ad06268e1..c85c015876 100755
--- a/blogs/2017/11/15/live-share.md
+++ b/blogs/2017/11/15/live-share.md
@@ -21,7 +21,7 @@ Live Share enables your team to quickly collaborate on the same codebase without
 
 When it comes to Live Share, seeing is believing.  Watch the following video to get an idea of what we are working on:
 
-<iframe src="https://aka.ms/vsls-video" allowFullScreen frameBorder="0" title="Introducing Visual Studio Live Share"></iframe>
+[![Watch Introducing Visual Studio Live Share on Microsoft Learn (opens in new tab).](images/live-share/video-introducing-live-share.jpg)](https://learn.microsoft.com/shows/visual-studio-connect-event-2017/t254)
 
 When you share a collaborative session, your teammate sees the context of the workspace in their editor. This means your teammate can read the code you shared without having to clone a repo or install any dependencies your code relies on. They can use rich language features to navigate within the code; not only just opening other files as text but using semantic analysis-based navigation like Go to Definition or Peek.
 
diff --git a/blogs/2018/12/04/images/rich-navigation/youtube-DAqDEi0fGco.jpg b/blogs/2018/12/04/images/rich-navigation/youtube-DAqDEi0fGco.jpg
new file mode 100644
index 0000000000..92a6335bf0
--- /dev/null
+++ b/blogs/2018/12/04/images/rich-navigation/youtube-DAqDEi0fGco.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:136ebe5d8d1045b75e12753a0e289e7c71e82b08e9f0c24c57b66d4d4de79862
+size 159076
diff --git a/blogs/2018/12/04/rich-navigation.md b/blogs/2018/12/04/rich-navigation.md
index 8b33e14add..33227fbc83 100644
--- a/blogs/2018/12/04/rich-navigation.md
+++ b/blogs/2018/12/04/rich-navigation.md
@@ -15,7 +15,7 @@ Pull requests are a critical collaboration tool for millions of developers every
 
 In September, along with GitHub, [we announced the GitHub Pull Requests extension](https://code.visualstudio.com/blogs/2018/09/10/introducing-github-pullrequests), which enabled developers to review source code in the same place they write it: inside their familiar and highly-customized editor. Today, we're excited to share a sneak peek of a new experience that will further enhance in-editor PR reviews with support for **rich, multi-repository code navigations**.
 
-<iframe src="https://www.youtube-nocookie.com/embed/DAqDEi0fGco?rel=0&amp;disablekb=0&amp;modestbranding=1&amp;showinfo=0" frameborder="0" allowfullscreen title="First look at a rich code navigation experience"></iframe>
+[![Watch First look at a rich code navigation experience on YouTube (opens in new tab).](images/rich-navigation/youtube-DAqDEi0fGco.jpg)](https://www.youtube.com/watch?v=DAqDEi0fGco)
 
 ## Say goodbye to superficial reviews
 
diff --git a/blogs/2019/05/02/images/remote-development/youtube-TVcoGLL6Smo.jpg b/blogs/2019/05/02/images/remote-development/youtube-TVcoGLL6Smo.jpg
new file mode 100644
index 0000000000..e4645781c0
--- /dev/null
+++ b/blogs/2019/05/02/images/remote-development/youtube-TVcoGLL6Smo.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f1c2ac9f29da8f90d6f282e0c935b95325878119396e2f46cdce52dc56080db4
+size 105396
diff --git a/blogs/2019/05/02/images/remote-development/youtube-mIHprjsSO9o.jpg b/blogs/2019/05/02/images/remote-development/youtube-mIHprjsSO9o.jpg
new file mode 100644
index 0000000000..abde32e5d7
--- /dev/null
+++ b/blogs/2019/05/02/images/remote-development/youtube-mIHprjsSO9o.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a6a616b9a35030b25097aff5ffb59160977cf15895aeb1cec0bf8177d2358982
+size 113302
diff --git a/blogs/2019/05/02/images/remote-development/youtube-rh1Ag41J6IA.jpg b/blogs/2019/05/02/images/remote-development/youtube-rh1Ag41J6IA.jpg
new file mode 100644
index 0000000000..973938c98d
--- /dev/null
+++ b/blogs/2019/05/02/images/remote-development/youtube-rh1Ag41J6IA.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8436584d2934dacc556e0023db19533df039aaba73454d56132fa35bb9c54d00
+size 91460
diff --git a/blogs/2019/05/02/remote-development.md b/blogs/2019/05/02/remote-development.md
index d8e792d44a..e0597fdf03 100644
--- a/blogs/2019/05/02/remote-development.md
+++ b/blogs/2019/05/02/remote-development.md
@@ -78,7 +78,7 @@ Commands and extensions are run directly in the Linux distro, so you don't have
 
 Check out this quick, 2-minute video to see how easy it is to develop in WSL.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/mIHprjsSO9o" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen title="Visual Studio Code WSL"></iframe>
+[![Watch Visual Studio Code WSL on YouTube (opens in new tab).](images/remote-development/youtube-mIHprjsSO9o.jpg)](https://www.youtube.com/watch?v=mIHprjsSO9o)
 
 For more information, please see the [Developing in WSL](https://aka.ms/vscode-remote/wsl) documentation.
 
@@ -96,7 +96,7 @@ You could use Vim over SSH or Jupyter Notebooks to edit your remote code, but yo
 
 Check out this quick, 2-minute video to see how easy it is to develop on a virtual machine over SSH.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/rh1Ag41J6IA" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen title="Visual Studio Code Remote - SSH"></iframe>
+[![Watch Visual Studio Code Remote - SSH on YouTube (opens in new tab).](images/remote-development/youtube-rh1Ag41J6IA.jpg)](https://www.youtube.com/watch?v=rh1Ag41J6IA)
 
 For more information, please see the [Developing using SSH](https://aka.ms/vscode-remote/ssh) documentation.
 
@@ -112,7 +112,7 @@ A `devcontainer.json` file can be used to tell VS Code how to configure the deve
 
 Check out this quick, 2-minute video to see Development Containers in action.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/TVcoGLL6Smo" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen title="Visual Studio Code Dev Containers"></iframe>
+[![Watch Visual Studio Code Dev Containers on YouTube (opens in new tab).](images/remote-development/youtube-TVcoGLL6Smo.jpg)](https://www.youtube.com/watch?v=TVcoGLL6Smo)
 
 For more information on development containers, please see the [Developing inside a Container](https://aka.ms/vscode-remote/containers) documentation as well as the [vscode-remote-try-* repositories](https://github.com/search?q=org%3AMicrosoft+vscode-remote-try-&unscoped_q=vscode-remote-try-) that contain samples you can use today.
 
diff --git a/blogs/2020/05/06/github-issues-integration.md b/blogs/2020/05/06/github-issues-integration.md
index 71e8cf1c89..98ea930f0a 100644
--- a/blogs/2020/05/06/github-issues-integration.md
+++ b/blogs/2020/05/06/github-issues-integration.md
@@ -59,7 +59,7 @@ To fit more workflows, there are several options you can configure. If your flow
 
 You can watch this **What every GitHub user should know about VS Code** talk from [GitHub Satellite](https://githubsatellite.com) by Sana Ajani, [@sana_ajani](https://twitter.com/sana_ajani), and Burke Holland, [@burkeholland](https://twitter.com/burkeholland).
 
-<iframe src="https://www.youtube-nocookie.com/embed/T6sW1Dk9B4E?rel=0&amp;disablekb=0&amp;modestbranding=1&amp;showinfo=0" frameborder="0" allowfullscreen title="What every GitHub user should know about VS Code"></iframe>
+[![Watch What every GitHub user should know about VS Code on YouTube (opens in new tab).](images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg)](https://www.youtube.com/watch?v=T6sW1Dk9B4E)
 
 ---
 
diff --git a/blogs/2020/05/06/images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg b/blogs/2020/05/06/images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg
new file mode 100644
index 0000000000..0d32de0962
--- /dev/null
+++ b/blogs/2020/05/06/images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:830766f922c79d6dbf874ac3d9f0159c4641f6b77142f578612d8a10e796027c
+size 85030
diff --git a/blogs/2021/06/02/build-2021.md b/blogs/2021/06/02/build-2021.md
index c609a0b159..b7282952e8 100644
--- a/blogs/2021/06/02/build-2021.md
+++ b/blogs/2021/06/02/build-2021.md
@@ -25,13 +25,13 @@ Among all the sessions that were presented, here is a hand-picked selection for
 
 Join Sana Ajani and Jeffrey Mew for some of the newest features of VS Code, including new debugging and testing features, custom notebooks, better support for Python, PyTorch, and Jupyter Notebooks.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/eKJftIqv8Uo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch What's new in Visual Studio Code | BRK212 on YouTube (opens in new tab).](images/build-2021/youtube-eKJftIqv8Uo.jpg)](https://www.youtube.com/watch?v=eKJftIqv8Uo)
 
 ### Application development with Scott Hanselman & friends
 
 Why did this "not a keynote" keynote get so many rave reviews? Find out for yourself, and learn about what's new for developers from Microsoft, including with VS Code: custom notebooks, GitHub integration, GitHub Codespaces, and more.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/EWYYgEkGJfs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Application Development with Scott Hanselman & Friends | KEY11D on YouTube (opens in new tab).](images/build-2021/youtube-EWYYgEkGJfs.jpg)](https://www.youtube.com/watch?v=EWYYgEkGJfs)
 
 ### What's new with TypeScript
 
@@ -51,13 +51,13 @@ VS Code developer Christof Marti gives a brief demo of developing in a container
 
 [Dapr](https://dapr.io/) is a distributed application runtime to build microservice-based apps and works with any programming language. Check out Dapr and how it is used with VS Code.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/DyKYB76SDx0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Microservices made easy with Dapr | OD521 on YouTube (opens in new tab).](images/build-2021/youtube-DyKYB76SDx0.jpg)](https://www.youtube.com/watch?v=DyKYB76SDx0)
 
 ### Build cloud-native applications that run anywhere
 
 Use VS Code and Azure to build, debug, and run serverless or containerized apps.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/jN2INtCLRTo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Build cloud-native applications that run anywhere | TS03 on YouTube (opens in new tab).](images/build-2021/youtube-jN2INtCLRTo.jpg)](https://www.youtube.com/watch?v=jN2INtCLRTo)
 
 ## Learn new skills
 
@@ -67,19 +67,19 @@ This year's Build had a large "student zone", for beginners and perennial learne
 
 Learn how VS Code and GitHub can help student and beginning programmers learn to code. Hosted by Sana Ajani, from the VS Code team, and Meaghan Lewis.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Jk708pQJSyk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Core tools for a dev career: an introduction to Visual Studio Code and GitHub | CON068 on YouTube (opens in new tab).](images/build-2021/youtube-Jk708pQJSyk.jpg)](https://www.youtube.com/watch?v=Jk708pQJSyk)
 
 ### The art of artificial intelligence: creating images with Python and Azure
 
 Learn how to use AI to generate images and photos, with Python and Jupyter Notebooks in VS Code.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/WyAikmxLlhs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch The art of artificial intelligence: creating images with Python and Azure | CON070 on YouTube (opens in new tab).](images/build-2021/youtube-WyAikmxLlhs.jpg)](https://www.youtube.com/watch?v=WyAikmxLlhs)
 
 ### Get started with popular programming languages: Intro to Python and C#
 
 James Montemagno and Christopher Harrison offer a beginner-friendly introduction to programming in C# and Python, and of course using VS Code.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/wiUzCG_mEGo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Get started with popular programming languages: Intro to Python and C# | CON069 on YouTube (opens in new tab).](images/build-2021/youtube-wiUzCG_mEGo.jpg)](https://www.youtube.com/watch?v=wiUzCG_mEGo)
 
 ## Reach out
 
diff --git a/blogs/2021/06/02/images/build-2021/youtube-DyKYB76SDx0.jpg b/blogs/2021/06/02/images/build-2021/youtube-DyKYB76SDx0.jpg
new file mode 100644
index 0000000000..18d55281ce
--- /dev/null
+++ b/blogs/2021/06/02/images/build-2021/youtube-DyKYB76SDx0.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4a7aa1595e5fb7dd7c0883d82cdf87531ad72246c470cfc4a90b31bb31e4812e
+size 117424
diff --git a/blogs/2021/06/02/images/build-2021/youtube-EWYYgEkGJfs.jpg b/blogs/2021/06/02/images/build-2021/youtube-EWYYgEkGJfs.jpg
new file mode 100644
index 0000000000..8e2a30848f
--- /dev/null
+++ b/blogs/2021/06/02/images/build-2021/youtube-EWYYgEkGJfs.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:56bbb65a57f7b6ed4ed21fb512570a18972a2bf78e8ad989e710a30bb5c701b6
+size 225661
diff --git a/blogs/2021/06/02/images/build-2021/youtube-Jk708pQJSyk.jpg b/blogs/2021/06/02/images/build-2021/youtube-Jk708pQJSyk.jpg
new file mode 100644
index 0000000000..914184d044
--- /dev/null
+++ b/blogs/2021/06/02/images/build-2021/youtube-Jk708pQJSyk.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f583eb65776fcafd0f3486defd2021b6885e5f0054778cb172aeb4317c7e1c91
+size 150564
diff --git a/blogs/2021/06/02/images/build-2021/youtube-WyAikmxLlhs.jpg b/blogs/2021/06/02/images/build-2021/youtube-WyAikmxLlhs.jpg
new file mode 100644
index 0000000000..fbdf13f660
--- /dev/null
+++ b/blogs/2021/06/02/images/build-2021/youtube-WyAikmxLlhs.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6a882cd7878acb0acb9420fbe2c32076401ad234c68edb752fc839597f5e3b62
+size 98183
diff --git a/blogs/2021/06/02/images/build-2021/youtube-eKJftIqv8Uo.jpg b/blogs/2021/06/02/images/build-2021/youtube-eKJftIqv8Uo.jpg
new file mode 100644
index 0000000000..5906f87f8c
--- /dev/null
+++ b/blogs/2021/06/02/images/build-2021/youtube-eKJftIqv8Uo.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:53695df6b5e906439f4670a5f310d9d4dd14036eaa138d6751dc3ce71fb859ca
+size 86314
diff --git a/blogs/2021/06/02/images/build-2021/youtube-jN2INtCLRTo.jpg b/blogs/2021/06/02/images/build-2021/youtube-jN2INtCLRTo.jpg
new file mode 100644
index 0000000000..4b7dd79fbc
--- /dev/null
+++ b/blogs/2021/06/02/images/build-2021/youtube-jN2INtCLRTo.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:01dea266cad164cdaabd23b82154eb23e19e454e4a356e4a622f063e2262d8a7
+size 87626
diff --git a/blogs/2021/06/02/images/build-2021/youtube-wiUzCG_mEGo.jpg b/blogs/2021/06/02/images/build-2021/youtube-wiUzCG_mEGo.jpg
new file mode 100644
index 0000000000..2e17a4c02d
--- /dev/null
+++ b/blogs/2021/06/02/images/build-2021/youtube-wiUzCG_mEGo.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:787bede57bd5a1a563f5bda909c02febb1e93bd59caa6a60f17089463fa0ffac
+size 68015
diff --git a/blogs/2021/11/08/custom-notebooks.md b/blogs/2021/11/08/custom-notebooks.md
index 7b3fee4e0a..065de0c8a4 100644
--- a/blogs/2021/11/08/custom-notebooks.md
+++ b/blogs/2021/11/08/custom-notebooks.md
@@ -74,7 +74,7 @@ For both of these notebooks, it was great to have the VS Code Notebook UI to cre
 
 The VS Code team recorded a livestream several months ago about custom notebooks and in it, I showcased in a live coding demo of what it's like to create a custom notebook extension. You can watch it on YouTube: [VS Code Notebooks: A Deep Dive](https://youtu.be/D-AXZZDTQhM). Some of the Notebook APIs have changed since the video was published but the principles are still the same.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/D-AXZZDTQhM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch VS Code Notebooks: A Deep Dive on YouTube (opens in new tab).](images/custom-notebooks/youtube-D-AXZZDTQhM.jpg)](https://www.youtube.com/watch?v=D-AXZZDTQhM)
 
 For the most up to date and detailed information when you're ready to build your own notebook extension, you can reference the [Notebook extension authors guide](/api/extension-guides/notebook.md).
 
diff --git a/blogs/2021/11/08/images/custom-notebooks/youtube-D-AXZZDTQhM.jpg b/blogs/2021/11/08/images/custom-notebooks/youtube-D-AXZZDTQhM.jpg
new file mode 100644
index 0000000000..4b778170ab
--- /dev/null
+++ b/blogs/2021/11/08/images/custom-notebooks/youtube-D-AXZZDTQhM.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5f726024885dfe7d310965a031db8634746901ce6238383ad5d5460db8c8d2cc
+size 95887
diff --git a/blogs/2024/12/18/free-github-copilot.md b/blogs/2024/12/18/free-github-copilot.md
index 718cd69d7a..e4da8c147b 100644
--- a/blogs/2024/12/18/free-github-copilot.md
+++ b/blogs/2024/12/18/free-github-copilot.md
@@ -115,7 +115,7 @@ No more commits that say "changes". GitHub Copilot will suggest a commit message
 
 Every VS Code extension can tie directly into the GitHub Copilot APIs and offer a customized AI experience. Check out MongoDB with [their extension](https://marketplace.visualstudio.com/items?itemName=mongodb.mongodb-vscode) that can write impressively complex queries, use fuzzy search and a lot more...
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/MLWlWrRAb4w?si=FzYwY_lOLUlfOmQ7" title="VS Code MongoDB extension" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch VS Code MongoDB extension on YouTube (opens in new tab).](images/free-github-copilot/youtube-MLWlWrRAb4w.jpg)](https://www.youtube.com/watch?v=MLWlWrRAb4w)
 
 **Try this:** Build your own extension for GitHub Copilot using GitHub Copilot! We've created some new tutorials that show you how to [build a code tutor chat participant](https://code.visualstudio.com/api/extension-guides/chat-tutorial) or [generate AI-powered code annotations](https://code.visualstudio.com/api/extension-guides/language-model-tutorial).
 
diff --git a/blogs/2024/12/18/images/free-github-copilot/youtube-MLWlWrRAb4w.jpg b/blogs/2024/12/18/images/free-github-copilot/youtube-MLWlWrRAb4w.jpg
new file mode 100644
index 0000000000..18ac7ace2f
--- /dev/null
+++ b/blogs/2024/12/18/images/free-github-copilot/youtube-MLWlWrRAb4w.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:458e201e14ff7fda5592802d54d80c1befeaa7be0148b7bab81f1a975bc5df3f
+size 87526
diff --git a/blogs/2025/05/12/agent-mode-meets-mcp.md b/blogs/2025/05/12/agent-mode-meets-mcp.md
index 93f009d9b3..1d00bc8ad8 100644
--- a/blogs/2025/05/12/agent-mode-meets-mcp.md
+++ b/blogs/2025/05/12/agent-mode-meets-mcp.md
@@ -16,7 +16,7 @@ When we first introduced [agent mode](https://code.visualstudio.com/docs/agents/
 
 Our first attempt followed the familiar VS Code pattern: extensibility through the [Tools](https://code.visualstudio.com/api/extension-guides/tools) and [Chat participants](https://code.visualstudio.com/api/extension-guides/chat) APIs. This made sense given the thousands of extensions already in the ecosystem, but the industry was moving quickly toward a new standard: the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP). MCP is best understood as a protocol for connecting AI agents to a wide range of external tools and services in a consistent way, much like how HTTP standardized communication for the web. The goal is to let any client, not just VS Code, plug in powerful tool servers like databases, code search, and deployment systems, and have them “just work.”
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com//embed/VePxCcF99w4?si=vY-f4CKc0rrl5fDa&start=165" title="Agent mode tools in VS Code" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Agent mode tools in VS Code on YouTube (opens in new tab).](images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg)](https://www.youtube.com/watch?v=VePxCcF99w4)
 
 This shift to MCP unlocked a wider ecosystem almost overnight. Now, VS Code users can take advantage of servers like [Playwright MCP Server](https://github.com/microsoft/playwright-mcp) for frontend verification, [GitHub MCP Server](https://github.com/github/github-mcp-server/) for repository insights and pull requests, or [Context7](https://github.com/upstash/context7/) for smarter API usage. The [list of servers](https://github.com/modelcontextprotocol/servers) continues to grow, and MCP has quickly become a foundation for bringing additional capabilities across AI agents.
 
diff --git a/blogs/2025/05/12/images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg b/blogs/2025/05/12/images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg
new file mode 100644
index 0000000000..c4ec713b2c
--- /dev/null
+++ b/blogs/2025/05/12/images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b46f12dc55f10e76580851481a2f0fd9f5526e0750d44ad2901d24b7ca7c25fd
+size 72377
diff --git a/blogs/2025/05/27/ai-and-remote.md b/blogs/2025/05/27/ai-and-remote.md
index a02b82a643..d4246f3fbf 100644
--- a/blogs/2025/05/27/ai-and-remote.md
+++ b/blogs/2025/05/27/ai-and-remote.md
@@ -18,7 +18,7 @@ Now combine those capabilities with the flexibility and power of AI in VS Code,
 
 In this blog, we'll explore how your existing remote setups can be enhanced to "just work" with AI, along with some more customized AI + remote workflows that include custom instructions, chat participants, and agent auto-approvals.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com//embed/ErYP9LRo7e0?si=1zYHow_2ivCc0jzd" title="AI and Remote Development in VS Code" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch AI and Remote Development in VS Code on YouTube (opens in new tab).](images/ai-and-remote/youtube-ErYP9LRo7e0.jpg)](https://www.youtube.com/watch?v=ErYP9LRo7e0)
 
 ## What is Remote Development?
 
diff --git a/blogs/2025/05/27/images/ai-and-remote/youtube-ErYP9LRo7e0.jpg b/blogs/2025/05/27/images/ai-and-remote/youtube-ErYP9LRo7e0.jpg
new file mode 100644
index 0000000000..aef5a9c70a
--- /dev/null
+++ b/blogs/2025/05/27/images/ai-and-remote/youtube-ErYP9LRo7e0.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:49d115f57be08c5a5d666d1e710a3673f7aa6c5f95564cc0902e8c366b33b861
+size 36007
diff --git a/blogs/2025/10/22/bring-your-own-key.md b/blogs/2025/10/22/bring-your-own-key.md
index e97472865b..0cfef81683 100644
--- a/blogs/2025/10/22/bring-your-own-key.md
+++ b/blogs/2025/10/22/bring-your-own-key.md
@@ -18,7 +18,7 @@ In March, we released the [bring your own key (BYOK)](https://code.visualstudio.
 
 Now, we're taking BYOK to the next level. In the [v1.104 release](https://code.visualstudio.com/updates/v1_104), we introduced the [Language Model Chat Provider API](https://code.visualstudio.com/api/extension-guides/ai/language-model-chat-provider) that enables model providers to contribute their models directly through VS Code extensions.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com//embed/xXFTlPZJJoo?si=UrgdYjNbOzVbSysl" title="BYOK in VS Code" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch BYOK in VS Code on YouTube (opens in new tab).](images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg)](https://www.youtube.com/watch?v=xXFTlPZJJoo)
 
 
 ## What is Bring Your Own Key (BYOK)?
diff --git a/blogs/2025/10/22/images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg b/blogs/2025/10/22/images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg
new file mode 100644
index 0000000000..887db425cc
--- /dev/null
+++ b/blogs/2025/10/22/images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:acf0be3c084f8be883060d27d6a9ce6dcb1501124a72d5e3e41df23e29157572
+size 80673
diff --git a/blogs/2025/11/18/PrivateMarketplace.md b/blogs/2025/11/18/PrivateMarketplace.md
index cc2daf0cca..e18affa63a 100644
--- a/blogs/2025/11/18/PrivateMarketplace.md
+++ b/blogs/2025/11/18/PrivateMarketplace.md
@@ -14,7 +14,7 @@ November 18, 2025 by [Sean Iyer](https://x.com/nuget)
 
 Developers shouldn't have to juggle manual installs, worry about unverified extensions, or chase compliance exceptions just to get their favorite tools. Today, we're excited to announce Private Marketplace for VS Code—a dedicated, enterprise-ready hub that puts you in full control of how extensions are sourced, reviewed, and distributed to your dev teams. 🔐✨
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/nQLdmy50cb0?si=URhzNdCQ4a4zOSBx" title="Video showing the VS Code private marketplace." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video showing the VS Code private marketplace on YouTube (opens in new tab).](images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg)](https://www.youtube.com/watch?v=nQLdmy50cb0)
 
 ## With the Private Marketplace, you can:
 
diff --git a/blogs/2025/11/18/images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg b/blogs/2025/11/18/images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg
new file mode 100644
index 0000000000..47774f5558
--- /dev/null
+++ b/blogs/2025/11/18/images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:62d99e5ed526dbddb034b085ca557dfac4f3ac212a889df096eec8a13e59b043
+size 26206
diff --git a/blogs/2026/01/26/images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg b/blogs/2026/01/26/images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg
new file mode 100644
index 0000000000..73b33250db
--- /dev/null
+++ b/blogs/2026/01/26/images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6388a0ce2aecef573eab1eacb45ec1d68f76781df5125f759cf841d5f93b9c6b
+size 70478
diff --git a/blogs/2026/01/26/mcp-apps-support.md b/blogs/2026/01/26/mcp-apps-support.md
index 6518dffd64..910506ba7e 100644
--- a/blogs/2026/01/26/mcp-apps-support.md
+++ b/blogs/2026/01/26/mcp-apps-support.md
@@ -52,7 +52,7 @@ We've built a few [demos](https://github.com/digitarald/mcp-apps-playground) to
 
 [Storybook](https://storybook.js.org) has [added MCP Apps support](https://github.com/storybookjs/mcp/pull/134) to their open source MCP server. Simply ask an agent to *"build a login form using our design system"* instead of describing the desired result in extensive detail, and the agent renders an interactive component preview directly in VS Code.
 
-<iframe src="https://www.youtube-nocookie.com/embed/fbNH6_jdwQU?rel=0&amp;disablekb=0&amp;modestbranding=1&amp;showinfo=0" frameborder="0" allowfullscreen title="Storybook MCP Apps demo"></iframe>
+[![Watch Storybook MCP Apps demo on YouTube (opens in new tab).](images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg)](https://www.youtube.com/watch?v=fbNH6_jdwQU)
 
 > "We've been working with the VS Code team on MCP Apps and we're excited about the results. Users can now preview Storybook stories directly in the agent chat, eliminating the need to navigate between the chat and their Storybook to review changes." – Jeppe Reinhold (Storybook core contributor, Chromatic)
 
diff --git a/blogs/2026/02/05/images/multi-agent-development/youtube-BsAHunfVwNs.jpg b/blogs/2026/02/05/images/multi-agent-development/youtube-BsAHunfVwNs.jpg
new file mode 100644
index 0000000000..6b4d68cc54
--- /dev/null
+++ b/blogs/2026/02/05/images/multi-agent-development/youtube-BsAHunfVwNs.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:59a0ba9804b2eca8da7c63687ee003bbf31735310fe06d0a56ed2b56ba4a90fe
+size 34559
diff --git a/blogs/2026/02/05/multi-agent-development.md b/blogs/2026/02/05/multi-agent-development.md
index a0dd0380cf..0e8216fdb6 100644
--- a/blogs/2026/02/05/multi-agent-development.md
+++ b/blogs/2026/02/05/multi-agent-development.md
@@ -24,7 +24,7 @@ The Agent Sessions view gives you one place to see all your agent sessions—loc
 
 Kick off a cloud agent for a well-defined refactor, then jump into a local session for something more exploratory. Monitor a background task or let it run as you work on something else.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/BsAHunfVwNs?si=6m4vsMuc2Wb0YRpb" title="Video showing the unified agent experience." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video showing the unified agent experience on YouTube (opens in new tab).](images/multi-agent-development/youtube-BsAHunfVwNs.jpg)](https://www.youtube.com/watch?v=BsAHunfVwNs)
 
 The above demo illustrates how developers are constantly tackling multiple things at once: planning improvements, building features, reviewing results, debugging errors. For each moment, you need to pick the right tool: local when needing to steer, background or cloud when wanting isolated changes, parallel subagents when needing multiple processes.
 
diff --git a/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md b/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md
index 624ae4bb9c..1ff764777b 100644
--- a/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md
+++ b/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md
@@ -16,7 +16,7 @@ We use AI every day to ship VS Code. It's made us so much faster that, after ten
 
 To kick off [Agent Sessions Day](https://youtube.com/live/tAezuMSJuFs), I sat down with Peng Lyu, Engineering Manager on the VS Code team, to walk through how the VS Code team actually uses AI for our day-to-day work. Not only for implementing features (that part's self-evident), but for everything *around* building features: triage, code review, release notes, validation, staying productive in a meeting-heavy schedule.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/ee-obY-4rqk?si=N-y6jlg15iBzoKxH" title="Agent Sessions Day: How VS Code Builds with AI." frameborder="0" allow="accelerometer; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Agent Sessions Day: How VS Code Builds with AI on YouTube (opens in new tab).](images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg)](https://www.youtube.com/watch?v=ee-obY-4rqk)
 
 In that session, we probably only covered 5% of what the team does with agents on any given day. But it's representative of how a product that's used by millions of developers is built. So, we wanted to share more about these big recent changes to our workflow, and where we think we're going next.
 
diff --git a/blogs/2026/03/13/images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg b/blogs/2026/03/13/images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg
new file mode 100644
index 0000000000..5f31c3db17
--- /dev/null
+++ b/blogs/2026/03/13/images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:dde5655b70db6528eccbf845a0430dddd7880b8a0bce297ef8458952eed90628
+size 142812
diff --git a/blogs/2026/06/18/byok-vscode.md b/blogs/2026/06/18/byok-vscode.md
index c1e1ada0a2..84585eaa64 100644
--- a/blogs/2026/06/18/byok-vscode.md
+++ b/blogs/2026/06/18/byok-vscode.md
@@ -145,7 +145,7 @@ To learn more, check out the VS Code docs on [AI language models](https://code.v
 
 We also have a video for how to [Bring Your Own AI... No Sign-In Required!](https://www.youtube.com/watch?v=EB7dQv1ALCU).
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/EB7dQv1ALCU?si=mDo0BJiZ5FLJBPwJ" title="Bring Your Own AI... No Sign-In Required!" frameborder="0" allow="accelerometer; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Bring Your Own AI... No Sign-In Required! on YouTube (opens in new tab).](images/byok-vscode/youtube-EB7dQv1ALCU.jpg)](https://www.youtube.com/watch?v=EB7dQv1ALCU)
 
 We are continuing to improve model choice in VS Code, and your feedback helps shape what comes next. Try BYOK with your workflow and let us know what you think in the [VS Code repository](https://github.com/microsoft/vscode).
 
diff --git a/blogs/2026/06/18/images/byok-vscode/youtube-EB7dQv1ALCU.jpg b/blogs/2026/06/18/images/byok-vscode/youtube-EB7dQv1ALCU.jpg
new file mode 100644
index 0000000000..69781138bd
--- /dev/null
+++ b/blogs/2026/06/18/images/byok-vscode/youtube-EB7dQv1ALCU.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f4e87bbaabdfc24b534ce4b3ac1a3f2b9394ac07c78cdd14e6c79ad7e6d4ba82
+size 106429
diff --git a/blogs/2026/08/26/agent-host-architecture.md b/blogs/2026/08/26/agent-host-architecture.md
index 89241412ed..f8d3a6b243 100644
--- a/blogs/2026/08/26/agent-host-architecture.md
+++ b/blogs/2026/08/26/agent-host-architecture.md
@@ -19,7 +19,7 @@ We're introducing the **Agent Host**, a self-contained process that owns agent s
 
 In this post, we'll explain why we built the Agent Host, what it enables in VS Code (and how you can try it), how its architecture works, and how AHP opens that architecture to other clients.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/k91ejc3G1YM?si=vSL3mEKcR3YOMBHI" title="Video showing an Agent Host session continuing across folders, VS Code surfaces, and remote connections." frameborder="0" allow="accelerometer; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video showing an Agent Host session continuing across folders, VS Code surfaces, and remote connections on YouTube (opens in new tab).](images/agent-host-architecture/youtube-k91ejc3G1YM.jpg)](https://www.youtube.com/watch?v=k91ejc3G1YM)
 
 ## Why we built the Agent Host
 
diff --git a/blogs/2026/08/26/images/agent-host-architecture/youtube-k91ejc3G1YM.jpg b/blogs/2026/08/26/images/agent-host-architecture/youtube-k91ejc3G1YM.jpg
new file mode 100644
index 0000000000..93ee641663
--- /dev/null
+++ b/blogs/2026/08/26/images/agent-host-architecture/youtube-k91ejc3G1YM.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:eea20f0bc89d0096d1b60078d57306fa608922a5d18ab2f905c11a62e129643d
+size 104930
diff --git a/build/replace-youtube-embeds.js b/build/replace-youtube-embeds.js
index b26739254d..02e4644a6f 100644
--- a/build/replace-youtube-embeds.js
+++ b/build/replace-youtube-embeds.js
@@ -136,6 +136,8 @@ function parseYouTubeIframe(iframe) {
   if (!title || isGenericTitle(title)) {
     return {
       isYouTube: true,
+      issueCode: 'missing-title',
+      videoId,
       error: `Video ${videoId} needs a meaningful iframe title before it can be migrated.`
     };
   }
@@ -197,7 +199,7 @@ function findIframeRanges(content) {
   return ranges;
 }
 
-function analyzeMarkdown(markdownPath, content) {
+function analyzeMarkdown(markdownPath, content, titleOverrides) {
   const embeds = [];
   const issues = [];
   let output = '';
@@ -205,16 +207,26 @@ function analyzeMarkdown(markdownPath, content) {
 
   findIframeRanges(content).forEach(function (range) {
     const iframe = content.substring(range.start, range.end);
-    const parsed = parseYouTubeIframe(iframe);
+    let parsed = parseYouTubeIframe(iframe);
     if (!parsed.isYouTube) {
       return;
     }
 
+    if (parsed.issueCode === 'missing-title' && titleOverrides && titleOverrides.has(parsed.videoId)) {
+      parsed = {
+        isYouTube: true,
+        title: titleOverrides.get(parsed.videoId),
+        videoId: parsed.videoId
+      };
+    }
+
     if (parsed.error) {
       issues.push({
+        code: parsed.issueCode,
         file: markdownPath,
         line: content.substring(0, range.start).split('\n').length,
-        message: parsed.error
+        message: parsed.error,
+        videoId: parsed.videoId
       });
       return;
     }
@@ -384,7 +396,51 @@ function downloadBestThumbnail(videoId, getBuffer) {
   return tryQuality();
 }
 
-function prepareMigration(files) {
+function downloadVideoTitle(videoId, getBuffer) {
+  const fetchBuffer = getBuffer || requestBuffer;
+  const watchUrl = `https://www.youtube.com/watch?v=${videoId}`;
+  const url = `https://www.youtube.com/oembed?url=${encodeURIComponent(watchUrl)}&format=json`;
+
+  return fetchBuffer(url).then(function (result) {
+    if (!/^application\/json(?:;|$)/i.test(result.contentType)) {
+      throw new Error(`Invalid oEmbed response type for ${videoId}: ${result.contentType || 'missing'}`);
+    }
+
+    let metadata;
+    try {
+      metadata = JSON.parse(result.data.toString('utf8'));
+    } catch (error) {
+      throw new Error(`Invalid oEmbed JSON for ${videoId}: ${error.message}`);
+    }
+
+    const title = typeof metadata.title === 'string' ? metadata.title.replace(/\s+/g, ' ').trim() : '';
+    if (!title || isGenericTitle(title)) {
+      throw new Error(`YouTube oEmbed did not provide a meaningful title for ${videoId}.`);
+    }
+
+    return title;
+  });
+}
+
+function resolveIssueTitles(issues, getBuffer, logger) {
+  const videoIds = Array.from(new Set(issues.map(function (issue) {
+    return issue.videoId;
+  })));
+  const titles = new Map();
+
+  return videoIds.reduce(function (promise, videoId) {
+    return promise.then(function () {
+      return downloadVideoTitle(videoId, getBuffer).then(function (title) {
+        titles.set(videoId, title);
+        logger(`Resolved title for ${videoId}: ${title}`);
+      });
+    });
+  }, Promise.resolve()).then(function () {
+    return titles;
+  });
+}
+
+function prepareMigration(files, titleOverrides) {
   const filePlans = [];
   const downloads = new Map();
   const issues = [];
@@ -392,9 +448,9 @@ function prepareMigration(files) {
 
   files.forEach(function (file) {
     const originalContent = fs.readFileSync(file, 'utf8');
-    const analysis = analyzeMarkdown(file, originalContent);
+    const analysis = analyzeMarkdown(file, originalContent, titleOverrides);
 
-    embedCount += analysis.embeds.length + analysis.issues.length;
+    embedCount += analysis.embeds.length;
     issues.push.apply(issues, analysis.issues);
 
     if (analysis.embeds.length > 0) {
@@ -499,22 +555,24 @@ function formatSummary(summary, write) {
     `${summary.issueCount} embed(s) need attention; scanned ${summary.fileCount} Markdown file(s).`;
 }
 
-function runMigration(options) {
-  const logger = options.logger || console.log;
-  const root = path.resolve(options.root || ROOT);
-  const files = collectMarkdownFiles(options.inputs, root);
-  const plan = prepareMigration(files);
+function createSummary(plan, fileCount) {
   const summary = {
     downloads: plan.downloads,
     embedCount: plan.embedCount,
-    fileCount: files.length,
+    fileCount,
     filePlans: plan.filePlans,
     foundCount: plan.embedCount,
     issueCount: plan.issues.length
   };
   summary.foundCount += summary.issueCount;
 
-  if (plan.issues.length > 0) {
+  return summary;
+}
+
+function executeMigration(plan, options, files, root, logger) {
+  const summary = createSummary(plan, files.length);
+
+  if (summary.issueCount > 0) {
     plan.issues.forEach(function (issue) {
       logger(`${path.relative(root, issue.file)}:${issue.line}: ${issue.message}`);
     });
@@ -536,6 +594,28 @@ function runMigration(options) {
   });
 }
 
+function runMigration(options) {
+  const logger = options.logger || console.log;
+  const root = path.resolve(options.root || ROOT);
+  const files = collectMarkdownFiles(options.inputs, root);
+  const initialPlan = prepareMigration(files);
+
+  if (options.write && initialPlan.issues.length > 0) {
+    const unresolvableIssues = initialPlan.issues.filter(function (issue) {
+      return issue.code !== 'missing-title';
+    });
+    if (unresolvableIssues.length > 0) {
+      return executeMigration(initialPlan, options, files, root, logger);
+    }
+
+    return resolveIssueTitles(initialPlan.issues, options.getMetadataBuffer, logger).then(function (titles) {
+      return executeMigration(prepareMigration(files, titles), options, files, root, logger);
+    });
+  }
+
+  return executeMigration(initialPlan, options, files, root, logger);
+}
+
 function printUsage() {
   console.log([
     'Usage: npm run replace-youtube-embeds -- [--write] <file-or-directory> [...]',
@@ -594,6 +674,7 @@ module.exports = {
   analyzeMarkdown,
   collectMarkdownFiles,
   downloadBestThumbnail,
+  downloadVideoTitle,
   isJpeg,
   parseArguments,
   parseYouTubeIframe,
diff --git a/build/replace-youtube-embeds.test.js b/build/replace-youtube-embeds.test.js
index 1682d8f2da..5d360b14b6 100644
--- a/build/replace-youtube-embeds.test.js
+++ b/build/replace-youtube-embeds.test.js
@@ -9,6 +9,7 @@ const test = require('node:test');
 const {
   analyzeMarkdown,
   downloadBestThumbnail,
+  downloadVideoTitle,
   parseYouTubeIframe,
   renderLinkedThumbnail,
   runMigration
@@ -38,6 +39,8 @@ test('rejects generic iframe titles', function () {
     parseYouTubeIframe('<iframe src="https://youtu.be/3HiLLByBWkg" title="YouTube video player"></iframe>'),
     {
       isYouTube: true,
+      issueCode: 'missing-title',
+      videoId: '3HiLLByBWkg',
       error: 'Video 3HiLLByBWkg needs a meaningful iframe title before it can be migrated.'
     }
   );
@@ -75,6 +78,46 @@ test('falls back to the next valid JPEG thumbnail', function () {
   });
 });
 
+test('resolves a meaningful title from YouTube oEmbed metadata', function () {
+  return downloadVideoTitle('3HiLLByBWkg', function (url) {
+    assert.match(url, /^https:\/\/www\.youtube\.com\/oembed\?/);
+    return Promise.resolve({
+      contentType: 'application/json; charset=utf-8',
+      data: Buffer.from(JSON.stringify({ title: 'Getting Started with Debugging in VS Code' }))
+    });
+  }).then(function (title) {
+    assert.equal(title, 'Getting Started with Debugging in VS Code');
+  });
+});
+
+test('write mode resolves generic titles before migrating', function () {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'youtube-embed-title-'));
+  const markdownPath = path.join(root, 'article.md');
+  const original = '<iframe src="https://www.youtube.com/embed/3HiLLByBWkg" title="YouTube video player"></iframe>\n';
+
+  fs.writeFileSync(markdownPath, original);
+
+  return runMigration({
+    getBuffer: function () {
+      return Promise.resolve({ contentType: 'image/jpeg', data: JPEG });
+    },
+    getMetadataBuffer: function () {
+      return Promise.resolve({
+        contentType: 'application/json',
+        data: Buffer.from(JSON.stringify({ title: 'Getting Started with Debugging in VS Code' }))
+      });
+    },
+    inputs: [markdownPath],
+    logger: function () {},
+    root,
+    write: true
+  }).then(function () {
+    assert.match(fs.readFileSync(markdownPath, 'utf8'), /Watch Getting Started with Debugging in VS Code on YouTube/);
+  }).finally(function () {
+    fs.rmSync(root, { recursive: true, force: true });
+  });
+});
+
 test('dry-run reports changes without writing files or downloading images', function () {
   const root = fs.mkdtempSync(path.join(os.tmpdir(), 'youtube-embed-dry-run-'));
   const markdownPath = path.join(root, 'article.md');
diff --git a/docs/agents/guides/images/prompt-engineering-guide/youtube-hh1nOX14TyY.jpg b/docs/agents/guides/images/prompt-engineering-guide/youtube-hh1nOX14TyY.jpg
new file mode 100644
index 0000000000..7095e4ad99
--- /dev/null
+++ b/docs/agents/guides/images/prompt-engineering-guide/youtube-hh1nOX14TyY.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:313a07b3da1a05921df7f22648786048c82470c8939162f86797372d63f86a96
+size 109611
diff --git a/docs/agents/guides/prompt-engineering-guide.md b/docs/agents/guides/prompt-engineering-guide.md
index ba32e5c956..1415c14509 100644
--- a/docs/agents/guides/prompt-engineering-guide.md
+++ b/docs/agents/guides/prompt-engineering-guide.md
@@ -8,7 +8,7 @@ MetaSocialImage: ../images/shared/github-copilot-social.png
 
 This article covers tips to write prompts to get better and more relevant responses from AI in {% data variables.product.prodname_vscode %}. _Prompt engineering_ or _prompt crafting_ is a common phrase you'll hear when discussing AI and refers to how and what information is packaged and sent to an AI API endpoint.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/hh1nOX14TyY" title="Core principles of prompt engineering with GitHub Copilot" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Core principles of prompt engineering with GitHub Copilot on YouTube (opens in new tab).](images/prompt-engineering-guide/youtube-hh1nOX14TyY.jpg)](https://www.youtube.com/watch?v=hh1nOX14TyY)
 
 If you are new to {% data variables.product.prodname_vscode_shortname %} or AI, you might want to review the [AI in {% data variables.product.prodname_vscode_shortname %} Overview](/docs/agent-native/overview.md) article first or dive straight into the [Getting started](/docs/agents/agents-tutorial.md) tutorial.
 
diff --git a/docs/cpp/cmake-linux.md b/docs/cpp/cmake-linux.md
index 4c07bcff40..c8d284e244 100644
--- a/docs/cpp/cmake-linux.md
+++ b/docs/cpp/cmake-linux.md
@@ -34,7 +34,7 @@ To complete this tutorial on Ubuntu, install the following:
 
 Watch this video to understand when a build system will help you and how to set up CMake for your project, or follow the steps in the following sections.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/_BWU5mWqVA4" title="C++ in {% data variables.product.prodname_vscode_shortname %}: Building your Code with CMake" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch C++ in {% data variables.product.prodname_vscode_shortname %}: Building your Code with CMake on YouTube (opens in new tab).](images/cmake-linux/youtube-_BWU5mWqVA4.jpg)](https://www.youtube.com/watch?v=_BWU5mWqVA4)
 
 ### Ensure that CMake is installed
 
diff --git a/docs/cpp/config-mingw.md b/docs/cpp/config-mingw.md
index 4be0a08e1f..d3bf789917 100644
--- a/docs/cpp/config-mingw.md
+++ b/docs/cpp/config-mingw.md
@@ -29,7 +29,7 @@ Get the latest version of MinGW-w64 via [MSYS2](https://www.msys2.org/), which p
 
 To install the MinGW-w64 toolchain, check out this video or follow the steps below:
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/oC69vlWofJQ" title="Installing MinGW to build C++ code on Windows" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+[![Watch Installing MinGW to build C++ code on Windows on YouTube (opens in new tab).](images/config-mingw/youtube-oC69vlWofJQ.jpg)](https://www.youtube.com/watch?v=oC69vlWofJQ)
 
 1. You can download the latest installer from the MSYS2 page or use this [**direct link to the installer**](https://github.com/msys2/msys2-installer/releases/download/2025-08-30/msys2-x86_64-20250830.exe).
 
diff --git a/docs/cpp/images/cmake-linux/youtube-_BWU5mWqVA4.jpg b/docs/cpp/images/cmake-linux/youtube-_BWU5mWqVA4.jpg
new file mode 100644
index 0000000000..ac4c79b6bc
--- /dev/null
+++ b/docs/cpp/images/cmake-linux/youtube-_BWU5mWqVA4.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5a14e1a856e8257a96ba06d073622ea010d7ec2c23d17e5f5a091c85e3baaf94
+size 117039
diff --git a/docs/cpp/images/config-mingw/youtube-oC69vlWofJQ.jpg b/docs/cpp/images/config-mingw/youtube-oC69vlWofJQ.jpg
new file mode 100644
index 0000000000..8c776a02a9
--- /dev/null
+++ b/docs/cpp/images/config-mingw/youtube-oC69vlWofJQ.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0a5a200ca17a20f6d4941555c9ed7e85484b830847744a1d0820d28f215f94ed
+size 134649
diff --git a/docs/cpp/images/introvideos-cpp/video-build-cpp-project.jpg b/docs/cpp/images/introvideos-cpp/video-build-cpp-project.jpg
new file mode 100644
index 0000000000..4e55023b09
--- /dev/null
+++ b/docs/cpp/images/introvideos-cpp/video-build-cpp-project.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6622391bf6da5e0b1dabf728894f68f3ff6c5a6f7f9a9ec5fef48781b26abe4b
+size 71473
diff --git a/docs/cpp/images/introvideos-cpp/video-configure-cpp-intellisense.jpg b/docs/cpp/images/introvideos-cpp/video-configure-cpp-intellisense.jpg
new file mode 100644
index 0000000000..fd03d948c8
--- /dev/null
+++ b/docs/cpp/images/introvideos-cpp/video-configure-cpp-intellisense.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a57ee0568df3f716601ec6e422cb12d4418c77174b0ef9f84e11a8ae088ee622
+size 54535
diff --git a/docs/cpp/images/introvideos-cpp/video-debug-cpp-project.jpg b/docs/cpp/images/introvideos-cpp/video-debug-cpp-project.jpg
new file mode 100644
index 0000000000..c07352d5c6
--- /dev/null
+++ b/docs/cpp/images/introvideos-cpp/video-debug-cpp-project.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:dadd2edc116bcfd95d5029ef25f3b98e7e777c87708453bad466317fa2039cc7
+size 29814
diff --git a/docs/cpp/images/introvideos-cpp/youtube-ZfT2CXY5-Dc.jpg b/docs/cpp/images/introvideos-cpp/youtube-ZfT2CXY5-Dc.jpg
new file mode 100644
index 0000000000..b1d1b38699
--- /dev/null
+++ b/docs/cpp/images/introvideos-cpp/youtube-ZfT2CXY5-Dc.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ae997bac61415c98b1a9010181b7aa2fe0c63436207911082c4f76d1dc7facd5
+size 154496
diff --git a/docs/cpp/images/introvideos-cpp/youtube-qeEcV6u1kV4.jpg b/docs/cpp/images/introvideos-cpp/youtube-qeEcV6u1kV4.jpg
new file mode 100644
index 0000000000..ad32d42c57
--- /dev/null
+++ b/docs/cpp/images/introvideos-cpp/youtube-qeEcV6u1kV4.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b5c6c6f781b8c59567da6167020fa15bda4b3909d490fdce3cc5db20a1845022
+size 144589
diff --git a/docs/cpp/introvideos-cpp.md b/docs/cpp/introvideos-cpp.md
index 86bfdf7ad9..da8dad1271 100644
--- a/docs/cpp/introvideos-cpp.md
+++ b/docs/cpp/introvideos-cpp.md
@@ -13,31 +13,31 @@ Get started with C++ in {% data variables.product.prodname_vscode %} by watching
 
 This video shows you how to install the C/C++ extension and a C++ compiler. You then learn how to run and debug your code by using the run or debug play button.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/qeEcV6u1kV4" title="Getting Started with C++ in 5 minutes" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+[![Watch Getting Started with C++ in 5 minutes on YouTube (opens in new tab).](images/introvideos-cpp/youtube-qeEcV6u1kV4.jpg)](https://www.youtube.com/watch?v=qeEcV6u1kV4)
 
 ## Configure C++ IntelliSense
 
 This video walks you through the steps to configure C++ IntelliSense for your project.
 
-<iframe src="https://channel9.msdn.com/Blogs/One-Dev-Minute/Configure-C-IntelliSense-in-Visual-Studio-Code/player" width="960" height="540" allowFullScreen frameBorder="0" title="Configure C++ IntelliSense in {% data variables.product.prodname_vscode %} - Microsoft Channel 9 Video"></iframe>
+[![Watch Configure C++ IntelliSense in {% data variables.product.prodname_vscode %} on Microsoft Learn (opens in new tab).](images/introvideos-cpp/video-configure-cpp-intellisense.jpg)](https://learn.microsoft.com/shows/one-dev-minute/configure-c-intellisense-in-visual-studio-code)
 
 ## Build a C++ project
 
 Learn how to build C++ projects in {% data variables.product.prodname_vscode_shortname %} by customizing your C++ build tasks.
 
-<iframe src="https://channel9.msdn.com/Blogs/One-Dev-Minute/Build-a-C-project-in-VS-Code/player" width="960" height="540" allowFullScreen frameBorder="0" title="Build a C++ project in {% data variables.product.prodname_vscode_shortname %} - Microsoft Channel 9 Video"></iframe>
+[![Watch Build a C++ project in {% data variables.product.prodname_vscode_shortname %} on Microsoft Learn (opens in new tab).](images/introvideos-cpp/video-build-cpp-project.jpg)](https://learn.microsoft.com/shows/one-dev-minute/build-a-c-project-in-vs-code)
 
 ## Debug a C++ project
 
 This video shows you how to customize debug configurations for your C++ project and start a C++ debugging session in {% data variables.product.prodname_vscode_shortname %}.
 
-<iframe src="https://channel9.msdn.com/Shows/Docs-Dev-Tools/Debug-a-C-project-in-VS-Code/player" width="960" height="540" allowFullScreen frameBorder="0" title="Debug a C++ project in {% data variables.product.prodname_vscode_shortname %} - Microsoft Channel 9 Video"></iframe>
+[![Watch Debug a C++ project in {% data variables.product.prodname_vscode_shortname %} on Microsoft Learn (opens in new tab).](images/introvideos-cpp/video-debug-cpp-project.jpg)](https://learn.microsoft.com/shows/docs-dev-tools/debug-a-c-project-in-vs-code)
 
 ## Getting started using Copilot Chat for C++ in {% data variables.product.prodname_vscode_shortname %}
 
 This video covers some use cases for using Copilot Chat in {% data variables.product.prodname_vscode_shortname %} with C++ Code.
 
-<iframe src="https://www.youtube-nocookie.com/embed/ZfT2CXY5-Dc?si=0F2qRniRhN-sg3cR" width="960" height="540" allowFullScreen frameBorder="0" title="Getting Started using Copilot Chat for C++ in {% data variables.product.prodname_vscode_shortname %}"></iframe>
+[![Watch Getting Started using Copilot Chat for C++ in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/introvideos-cpp/youtube-ZfT2CXY5-Dc.jpg)](https://www.youtube.com/watch?v=ZfT2CXY5-Dc)
 
 ## Next steps
 
diff --git a/docs/csharp/images/introvideos-csharp/youtube-8M-wwFTqsCs.jpg b/docs/csharp/images/introvideos-csharp/youtube-8M-wwFTqsCs.jpg
new file mode 100644
index 0000000000..81c5e6e773
--- /dev/null
+++ b/docs/csharp/images/introvideos-csharp/youtube-8M-wwFTqsCs.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3a3a06eed378eaa1ea99d5d96a8916d16d11fce718a26a0bd3a1819649c8dffd
+size 92436
diff --git a/docs/csharp/images/introvideos-csharp/youtube-HnP6pkE8Tjs.jpg b/docs/csharp/images/introvideos-csharp/youtube-HnP6pkE8Tjs.jpg
new file mode 100644
index 0000000000..960b98d007
--- /dev/null
+++ b/docs/csharp/images/introvideos-csharp/youtube-HnP6pkE8Tjs.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:daf5dbbad33edc23ba89f7930ed66057a679f9d18f1bf41954ff9409b8e14a75
+size 96539
diff --git a/docs/csharp/images/introvideos-csharp/youtube-S4Rks1L03LI.jpg b/docs/csharp/images/introvideos-csharp/youtube-S4Rks1L03LI.jpg
new file mode 100644
index 0000000000..cb8b2772f0
--- /dev/null
+++ b/docs/csharp/images/introvideos-csharp/youtube-S4Rks1L03LI.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6db84e963c958e79e9afdeda7de8db505ecc9e8d1ece52b02528b869c64b98a9
+size 97210
diff --git a/docs/csharp/images/introvideos-csharp/youtube-TGM386ZzeOc.jpg b/docs/csharp/images/introvideos-csharp/youtube-TGM386ZzeOc.jpg
new file mode 100644
index 0000000000..6e2da4610c
--- /dev/null
+++ b/docs/csharp/images/introvideos-csharp/youtube-TGM386ZzeOc.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f65a97cfcc9b7e0ca665e995cce8710ab21678bd0dc74f52fe735a4f76e880b1
+size 95699
diff --git a/docs/csharp/images/introvideos-csharp/youtube-VuIOk3DqKgc.jpg b/docs/csharp/images/introvideos-csharp/youtube-VuIOk3DqKgc.jpg
new file mode 100644
index 0000000000..66f73a269e
--- /dev/null
+++ b/docs/csharp/images/introvideos-csharp/youtube-VuIOk3DqKgc.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d20f49d6ef62acebbb252b8ba4377ed82f3db6cae2df7b7402072c0d19c4466a
+size 95219
diff --git a/docs/csharp/images/introvideos-csharp/youtube-jF9ltwBK2Wk.jpg b/docs/csharp/images/introvideos-csharp/youtube-jF9ltwBK2Wk.jpg
new file mode 100644
index 0000000000..d6fca09910
--- /dev/null
+++ b/docs/csharp/images/introvideos-csharp/youtube-jF9ltwBK2Wk.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:83749f63fe899f51ffb947319d899d18e3856e21f83363a500a042be74a43a0a
+size 96804
diff --git a/docs/csharp/images/introvideos-csharp/youtube-tFCZw-wZVtg.jpg b/docs/csharp/images/introvideos-csharp/youtube-tFCZw-wZVtg.jpg
new file mode 100644
index 0000000000..4dba35aebc
--- /dev/null
+++ b/docs/csharp/images/introvideos-csharp/youtube-tFCZw-wZVtg.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:65d65478f02dd188b1266733be1beead1d81abd2ddf2be6965c729e31990e2a6
+size 98947
diff --git a/docs/csharp/introvideos-csharp.md b/docs/csharp/introvideos-csharp.md
index 0bfa7293b5..91c93fd782 100644
--- a/docs/csharp/introvideos-csharp.md
+++ b/docs/csharp/introvideos-csharp.md
@@ -11,43 +11,43 @@ Get started with C# in {% data variables.product.prodname_vscode %} by watching
 
 This video explains how {% data variables.product.prodname_vscode_shortname %} together with the C# Dev Kit extension provide a productive and powerful C# development environment.
 
-<iframe src="https://www.youtube-nocookie.com/embed/tFCZw-wZVtg" width="960" height="540" allowFullScreen frameBorder="0" title="What is {% data variables.product.prodname_vscode_shortname %} and C# Dev Kit?"></iframe>
+[![Watch What is {% data variables.product.prodname_vscode_shortname %} and C# Dev Kit? on YouTube (opens in new tab).](images/introvideos-csharp/youtube-tFCZw-wZVtg.jpg)](https://www.youtube.com/watch?v=tFCZw-wZVtg)
 
 ## Installing C# Dev Kit
 
 Learn how to install {% data variables.product.prodname_vscode %} and C# Dev Kit and create your first C# project.
 
-<iframe src="https://www.youtube-nocookie.com/embed/S4Rks1L03LI" width="960" height="540" allowFullScreen frameBorder="0" title="Installing {% data variables.product.prodname_vscode_shortname %} and C# Dev Kit"></iframe>
+[![Watch Installing {% data variables.product.prodname_vscode_shortname %} and C# Dev Kit on YouTube (opens in new tab).](images/introvideos-csharp/youtube-S4Rks1L03LI.jpg)](https://www.youtube.com/watch?v=S4Rks1L03LI)
 
 ## C# project management
 
 This video shows you how to navigate your C# project using the Solution Explorer in C# Dev Kit.
 
-<iframe src="https://www.youtube-nocookie.com/embed/HnP6pkE8Tjs" width="960" height="540" allowFullScreen frameBorder="0" title="C# Project Management in {% data variables.product.prodname_vscode_shortname %}"></iframe>
+[![Watch C# Project Management in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/introvideos-csharp/youtube-HnP6pkE8Tjs.jpg)](https://www.youtube.com/watch?v=HnP6pkE8Tjs)
 
 ## {% data variables.product.prodname_vscode_shortname %} C# productivity
 
 This video shows you how to write C# code in {% data variables.product.prodname_vscode_shortname %} and discover cool productivity tools you can use along the way!
 
-<iframe src="https://www.youtube-nocookie.com/embed/8M-wwFTqsCs" width="960" height="540" allowFullScreen frameBorder="0" title="{% data variables.product.prodname_vscode_shortname %} C# Productivity"></iframe>
+[![Watch {% data variables.product.prodname_vscode_shortname %} C# Productivity on YouTube (opens in new tab).](images/introvideos-csharp/youtube-8M-wwFTqsCs.jpg)](https://www.youtube.com/watch?v=8M-wwFTqsCs)
 
 ## Debugging C# apps
 
 This video shows you how to debug your C# application using C# Dev Kits debugger tools.
 
-<iframe src="https://www.youtube-nocookie.com/embed/VuIOk3DqKgc" width="960" height="540" allowFullScreen frameBorder="0" title="Debugging C# Apps in {% data variables.product.prodname_vscode_shortname %}"></iframe>
+[![Watch Debugging C# Apps in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/introvideos-csharp/youtube-VuIOk3DqKgc.jpg)](https://www.youtube.com/watch?v=VuIOk3DqKgc)
 
 ## Testing C# apps
 
 This video shows you how to test your C# application using C# Dev Kit.
 
-<iframe src="https://www.youtube-nocookie.com/embed/TGM386ZzeOc" width="960" height="540" allowFullScreen frameBorder="0" title="Testing C# Apps in {% data variables.product.prodname_vscode_shortname %}"></iframe>
+[![Watch Testing C# Apps in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/introvideos-csharp/youtube-TGM386ZzeOc.jpg)](https://www.youtube.com/watch?v=TGM386ZzeOc)
 
 ## How to contribute to C# in {% data variables.product.prodname_vscode_shortname %}
 
 This video explains about how you can contribute to a better C# experience in {% data variables.product.prodname_vscode_shortname %}.
 
-<iframe src="https://www.youtube-nocookie.com/embed/jF9ltwBK2Wk" width="960" height="540" allowFullScreen frameBorder="0" title="How to Contribute to C# in {% data variables.product.prodname_vscode_shortname %}"></iframe>
+[![Watch How to Contribute to C# in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/introvideos-csharp/youtube-jF9ltwBK2Wk.jpg)](https://www.youtube.com/watch?v=jF9ltwBK2Wk)
 
 ## Next steps
 
diff --git a/docs/datascience/images/jupyter-notebooks/youtube-suAkMeWJ1yE.jpg b/docs/datascience/images/jupyter-notebooks/youtube-suAkMeWJ1yE.jpg
new file mode 100644
index 0000000000..96efdda3be
--- /dev/null
+++ b/docs/datascience/images/jupyter-notebooks/youtube-suAkMeWJ1yE.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e8ccc69aef54ecb4c462e36d9139b0a2b7700100dbb6f50c1492707570b0e84f
+size 92209
diff --git a/docs/datascience/jupyter-notebooks.md b/docs/datascience/jupyter-notebooks.md
index 25d3525600..e10f9d7be3 100644
--- a/docs/datascience/jupyter-notebooks.md
+++ b/docs/datascience/jupyter-notebooks.md
@@ -14,7 +14,7 @@ MetaSocialImage: images/tutorial/python-social.png
 - Connect to a remote Jupyter server
 - Debug a Jupyter Notebook
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/suAkMeWJ1yE" title="Get started with Jupyter Notebooks in {% data variables.product.prodname_vscode_shortname %}" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Get started with Jupyter Notebooks in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/jupyter-notebooks/youtube-suAkMeWJ1yE.jpg)](https://www.youtube.com/watch?v=suAkMeWJ1yE)
 
 ## Setting up your environment
 
diff --git a/docs/debugtest/debugging.md b/docs/debugtest/debugging.md
index c7fd37bd45..800d6a3ccf 100644
--- a/docs/debugtest/debugging.md
+++ b/docs/debugtest/debugging.md
@@ -12,7 +12,7 @@ This article describes the debugging features of {% data variables.product.prodn
 
 The following video shows how to get started with debugging in {% data variables.product.prodname_vscode_shortname %}.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/3HiLLByBWkg" title="Getting started with debugging in {% data variables.product.prodname_vscode_shortname %}" frameborder="0" allowfullscreen></iframe>
+[![Watch Getting started with debugging in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/debugging/youtube-3HiLLByBWkg.jpg)](https://www.youtube.com/watch?v=3HiLLByBWkg)
 
 ## Debugger user interface
 
diff --git a/docs/debugtest/images/debugging/youtube-3HiLLByBWkg.jpg b/docs/debugtest/images/debugging/youtube-3HiLLByBWkg.jpg
new file mode 100644
index 0000000000..7a0ba6c507
--- /dev/null
+++ b/docs/debugtest/images/debugging/youtube-3HiLLByBWkg.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6e31cc17ccf50881f5296cd1c0f0d749290261da8004d26b4fe739c45bed01a8
+size 98468
diff --git a/docs/editing/getting-started/images/userinterface/youtube-nORT3-kONgA.jpg b/docs/editing/getting-started/images/userinterface/youtube-nORT3-kONgA.jpg
new file mode 100644
index 0000000000..dfa8d49750
--- /dev/null
+++ b/docs/editing/getting-started/images/userinterface/youtube-nORT3-kONgA.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c3ff01968ad36784e4dd4622ce5b050530a6e96cd5d3abd91b2fe527098e77d7
+size 117779
diff --git a/docs/editing/getting-started/userinterface.md b/docs/editing/getting-started/userinterface.md
index 6226a016a8..b7e9601c32 100644
--- a/docs/editing/getting-started/userinterface.md
+++ b/docs/editing/getting-started/userinterface.md
@@ -7,7 +7,7 @@ MetaDescription: A quick overview of the {% data variables.product.prodname_vsco
 
 At its heart, {% data variables.product.prodname_vscode %} is a code editor. Like many other code editors, {% data variables.product.prodname_vscode_shortname %} adopts a common user interface and layout of an explorer on the left, showing all of the files and folders you have access to, and an editor on the right, showing the content of the files you have opened.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/nORT3-kONgA" title="Transform your {% data variables.product.prodname_vscode_shortname %} user interface" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Transform your {% data variables.product.prodname_vscode_shortname %} user interface on YouTube (opens in new tab).](images/userinterface/youtube-nORT3-kONgA.jpg)](https://www.youtube.com/watch?v=nORT3-kONgA)
 
 <div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Get started with AI">
 Follow a hands-on tutorial to build your first app with AI in {% data variables.product.prodname_vscode_shortname %}.
diff --git a/docs/getstarted/educators-and-students.md b/docs/getstarted/educators-and-students.md
index ab891ff539..11072d4314 100644
--- a/docs/getstarted/educators-and-students.md
+++ b/docs/getstarted/educators-and-students.md
@@ -83,7 +83,7 @@ Try out these space-travel themed challenges that introduce you to data science,
 
 Check out these WONDER WOMAN 1984 inspired lessons built to help you write your first lines of Python code. In the first module, learn how to crack a Caesar Cipher code that reveals a secret message with a location. In the second module, create a personality challenge to determine which character you're most like!
 
-Follow along with the [video walkthrough of the first lesson](https://www.youtube-nocookie.com/embed/VH_mU42lQkQ).
+Follow along with the [video walkthrough of the first lesson](https://www.youtube.com/watch?v=VH_mU42lQkQ).
 
 | Title | Description |
 |-------|-------------|
@@ -91,7 +91,7 @@ Follow along with the [video walkthrough of the first lesson](https://www.youtub
 
 ### Learn Python with Space Jam
 
-Inspired by the film "Space Jam: A New Legacy," this learning path shows basketball fans how an understanding of data science and coding can support their passions, create opportunities, and even open doors to possible careers. Develop skills in {% data variables.product.prodname_vscode %}, Azure, GitHub, JavaScript, and Python, to gain insights into how individual moments throughout a player's history can lead to a critical game decision in the finals. Watch the [introduction video](https://www.youtube-nocookie.com/embed/pXkIIzihEYM).
+Inspired by the film "Space Jam: A New Legacy," this learning path shows basketball fans how an understanding of data science and coding can support their passions, create opportunities, and even open doors to possible careers. Develop skills in {% data variables.product.prodname_vscode %}, Azure, GitHub, JavaScript, and Python, to gain insights into how individual moments throughout a player's history can lead to a critical game decision in the finals. Watch the [introduction video](https://www.youtube.com/watch?v=pXkIIzihEYM).
 
 | Title | Description |
 |-------|-------------|
@@ -103,7 +103,7 @@ Inspired by the film "Space Jam: A New Legacy," this learning path shows basketb
 
 [Live Share](https://learn.microsoft.com/visualstudio/liveshare) enables you to quickly collaborate in real time with a friend, classmate, or professor on the same code without the need to sync code or to configure the same development tools, settings, or environment.
 
-<iframe src="https://www.youtube-nocookie.com/embed/A2ceblXTBBc?rel=0&amp;disablekb=0&amp;modestbranding=1&amp;showinfo=0" frameborder="0" allowfullscreen title="Collaborate with Live Share"></iframe>
+[![Watch Collaborate with Live Share on YouTube (opens in new tab).](images/educators-and-students/youtube-A2ceblXTBBc.jpg)](https://www.youtube.com/watch?v=A2ceblXTBBc)
 
 >**Note**: The video mentions the deprecated Live Share Extension Pack and Live Share Audio extension. To follow along with the video, you only need to install the [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) extension.
 
diff --git a/docs/getstarted/images/educators-and-students/youtube-A2ceblXTBBc.jpg b/docs/getstarted/images/educators-and-students/youtube-A2ceblXTBBc.jpg
new file mode 100644
index 0000000000..292a55a117
--- /dev/null
+++ b/docs/getstarted/images/educators-and-students/youtube-A2ceblXTBBc.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:34de4193e8e9c0387c0903cd4c09c13bbefeb109277c1d63115b1e8f148b0805
+size 44465
diff --git a/docs/introvideos/basics.md b/docs/introvideos/basics.md
index 41a41dc33d..7b726968bb 100644
--- a/docs/introvideos/basics.md
+++ b/docs/introvideos/basics.md
@@ -8,7 +8,7 @@ MetaSocialImage: images/opengraph/introvideos-social.png
 
 In this tutorial, we walk you through using {% data variables.product.prodname_vscode %} powered with AI features.
 
-<iframe src="https://www.youtube-nocookie.com/embed/f8_uF_IDV50" width="640" height="320" allowFullScreen="true" frameBorder="0" title="Getting Started with {% data variables.product.prodname_vscode %}"></iframe>
+[![Watch Getting Started with {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/basics/youtube-f8_uF_IDV50.jpg)](https://www.youtube.com/watch?v=f8_uF_IDV50)
 
 Here's the next video we recommend: [Code Editing in {% data variables.product.prodname_vscode %}](/docs/introvideos/codeediting.md)
 
diff --git a/docs/introvideos/codeediting.md b/docs/introvideos/codeediting.md
index 89ce54abb2..a50d66bc0c 100644
--- a/docs/introvideos/codeediting.md
+++ b/docs/introvideos/codeediting.md
@@ -8,7 +8,7 @@ MetaSocialImage:
 
 In this {% data variables.product.prodname_vscode %} tutorial, we cover how to edit and run a small piece of code, including the features outlined below. After viewing this overview, read on in the [Related Resources](/docs/introvideos/codeediting.md#related-resources) section to see more features.
 
-<iframe src="https://www.youtube-nocookie.com/embed/MNBwGGwvvKE" width="640" height="320" allowFullScreen="true" frameBorder="0" title="Code editing in {% data variables.product.prodname_vscode %}"></iframe>
+[![Watch Code editing in {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/codeediting/youtube-MNBwGGwvvKE.jpg)](https://www.youtube.com/watch?v=MNBwGGwvvKE)
 
 Here's the next video we recommend: [Productivity Tips](/docs/introvideos/productivity.md)
 
diff --git a/docs/introvideos/configure.md b/docs/introvideos/configure.md
index b888980c20..9a33d0fb4b 100644
--- a/docs/introvideos/configure.md
+++ b/docs/introvideos/configure.md
@@ -8,7 +8,7 @@ MetaSocialImage: images/opengraph/introvideos-social.png
 
 In this {% data variables.product.prodname_vscode %} tutorial, we show you how to personalize {% data variables.product.prodname_vscode %} with themes.
 
-<iframe src="https://www.youtube-nocookie.com/embed/HOShAQzOy4Q" width="640" height="320" allowFullScreen="true" frameBorder="0" title="Personalize {% data variables.product.prodname_vscode %}"></iframe>
+[![Watch Personalize {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/configure/youtube-HOShAQzOy4Q.jpg)](https://www.youtube.com/watch?v=HOShAQzOy4Q)
 
 Here's the next video we recommend: [Extensions in {% data variables.product.prodname_vscode %}](/docs/introvideos/extend.md)
 
diff --git a/docs/introvideos/customize.md b/docs/introvideos/customize.md
index 439103611d..04c548070a 100644
--- a/docs/introvideos/customize.md
+++ b/docs/introvideos/customize.md
@@ -8,7 +8,7 @@ MetaSocialImage: images/opengraph/introvideos-social.png
 
 In this {% data variables.product.prodname_vscode %} tutorial, we show you how to customize {% data variables.product.prodname_vscode %} with settings and keyboard shortcuts.
 
-<iframe src="https://www.youtube-nocookie.com/embed/nORT3-kONgA?si=yrBv0XmZATIA7gVr" width="640" height="320" allowFullScreen="true" frameBorder="0" title="Customize {% data variables.product.prodname_vscode %}"></iframe>
+[![Watch Customize {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/customize/youtube-nORT3-kONgA.jpg)](https://www.youtube.com/watch?v=nORT3-kONgA)
 
 Pick another video from the list: [Introductory Videos](/docs/getstarted/introvideos.md)
 
diff --git a/docs/introvideos/debugging.md b/docs/introvideos/debugging.md
index fa03aae3db..feb0adc6d8 100644
--- a/docs/introvideos/debugging.md
+++ b/docs/introvideos/debugging.md
@@ -10,7 +10,7 @@ Debugging is a core feature of {% data variables.product.prodname_vscode %}. In
 
 > **Tip:** To use the debugging features demonstrated in this video for Node.js, you will need to first install [Node.js](https://nodejs.org). To follow along with the Python portion of the video, you'll need to install [Python](https://www.python.org/downloads/).
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/3HiLLByBWkg" title="Getting started with debugging in {% data variables.product.prodname_vscode_shortname %}" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Getting started with debugging in {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/debugging/youtube-3HiLLByBWkg.jpg)](https://www.youtube.com/watch?v=3HiLLByBWkg)
 
 Here's the next video we recommend: [Version Control](/docs/introvideos/versioncontrol.md)
 
diff --git a/docs/introvideos/extend.md b/docs/introvideos/extend.md
index 134a076f17..b097e9acad 100644
--- a/docs/introvideos/extend.md
+++ b/docs/introvideos/extend.md
@@ -8,7 +8,7 @@ MetaSocialImage: images/opengraph/introvideos-social.png
 
 Use {% data variables.product.prodname_vscode %} extensions to add new features, themes and more. In this tutorial, we will show you how to find extensions, install the ones you like, and disable extensions you don't want to use all the time.
 
-<iframe src="https://www.youtube-nocookie.com/embed/SKcZ3cwX8lA?rel=0&amp;disablekb=0&amp;modestbranding=1&amp;showinfo=0" frameborder="0" allowfullscreen title="Using extensions in {% data variables.product.prodname_vscode %}" ></iframe>
+[![Watch Using extensions in {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/extend/youtube-SKcZ3cwX8lA.jpg)](https://www.youtube.com/watch?v=SKcZ3cwX8lA)
 
 Here's the next video we recommend: [Debugging](/docs/introvideos/debugging.md)
 
diff --git a/docs/introvideos/images/basics/youtube-f8_uF_IDV50.jpg b/docs/introvideos/images/basics/youtube-f8_uF_IDV50.jpg
new file mode 100644
index 0000000000..aa482bc9ef
--- /dev/null
+++ b/docs/introvideos/images/basics/youtube-f8_uF_IDV50.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:33d5946df5296964cc87de5882eaedc7bbaf47169026364f315458e146594bf9
+size 103374
diff --git a/docs/introvideos/images/codeediting/youtube-MNBwGGwvvKE.jpg b/docs/introvideos/images/codeediting/youtube-MNBwGGwvvKE.jpg
new file mode 100644
index 0000000000..db3ce7892d
--- /dev/null
+++ b/docs/introvideos/images/codeediting/youtube-MNBwGGwvvKE.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0d1d0d96fc8218b208928ceb9f9af75114350a5c46673146aaaa211e39a784ce
+size 44232
diff --git a/docs/introvideos/images/configure/youtube-HOShAQzOy4Q.jpg b/docs/introvideos/images/configure/youtube-HOShAQzOy4Q.jpg
new file mode 100644
index 0000000000..9b74ca3104
--- /dev/null
+++ b/docs/introvideos/images/configure/youtube-HOShAQzOy4Q.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:08fa4f22d53a9fdf858e0e54f330c8d32115b65baf9a872bb4dc7350d0adbf2c
+size 42428
diff --git a/docs/introvideos/images/customize/youtube-nORT3-kONgA.jpg b/docs/introvideos/images/customize/youtube-nORT3-kONgA.jpg
new file mode 100644
index 0000000000..dfa8d49750
--- /dev/null
+++ b/docs/introvideos/images/customize/youtube-nORT3-kONgA.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c3ff01968ad36784e4dd4622ce5b050530a6e96cd5d3abd91b2fe527098e77d7
+size 117779
diff --git a/docs/introvideos/images/debugging/youtube-3HiLLByBWkg.jpg b/docs/introvideos/images/debugging/youtube-3HiLLByBWkg.jpg
new file mode 100644
index 0000000000..7a0ba6c507
--- /dev/null
+++ b/docs/introvideos/images/debugging/youtube-3HiLLByBWkg.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6e31cc17ccf50881f5296cd1c0f0d749290261da8004d26b4fe739c45bed01a8
+size 98468
diff --git a/docs/introvideos/images/extend/youtube-SKcZ3cwX8lA.jpg b/docs/introvideos/images/extend/youtube-SKcZ3cwX8lA.jpg
new file mode 100644
index 0000000000..43ffd1f133
--- /dev/null
+++ b/docs/introvideos/images/extend/youtube-SKcZ3cwX8lA.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bce11de688f05a3eb47a0c3ae606bd7c51d6ceca9285f37a619072665e79e830
+size 109221
diff --git a/docs/introvideos/images/productivity/youtube-HIqONcVBEm0.jpg b/docs/introvideos/images/productivity/youtube-HIqONcVBEm0.jpg
new file mode 100644
index 0000000000..3dfeb9a2a0
--- /dev/null
+++ b/docs/introvideos/images/productivity/youtube-HIqONcVBEm0.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:31ac337c1e6148e957694d04fd88f12a6882bf536e1ad2452884f3386c2c3cdf
+size 75642
diff --git a/docs/introvideos/images/versioncontrol/youtube-i_23KUAEtUM.jpg b/docs/introvideos/images/versioncontrol/youtube-i_23KUAEtUM.jpg
new file mode 100644
index 0000000000..5e40fd2c8b
--- /dev/null
+++ b/docs/introvideos/images/versioncontrol/youtube-i_23KUAEtUM.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cb28daaef7b94d3865e9707cd0456694667025ccbf20bad2f1eab39e067d8bd7
+size 77079
diff --git a/docs/introvideos/productivity.md b/docs/introvideos/productivity.md
index 2b2746a819..5cc88092eb 100644
--- a/docs/introvideos/productivity.md
+++ b/docs/introvideos/productivity.md
@@ -8,7 +8,7 @@ MetaSocialImage: images/opengraph/introvideos-social.png
 
 In this {% data variables.product.prodname_vscode %} tutorial, we describe {% data variables.product.prodname_vscode %} features that help increase your coding productivity. Learning just a few tips can speed up your workflow and help you discover the full power of the {% data variables.product.prodname_vscode_shortname %} editor.
 
-<iframe src="https://www.youtube-nocookie.com/embed/HIqONcVBEm0" width="640" height="320" allowFullScreen="true" frameBorder="0" title="Productivity tips for {% data variables.product.prodname_vscode %}"></iframe>
+[![Watch Productivity tips for {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/productivity/youtube-HIqONcVBEm0.jpg)](https://www.youtube.com/watch?v=HIqONcVBEm0)
 
 Here's the next video we recommend: [Personalize {% data variables.product.prodname_vscode %}](/docs/introvideos/configure.md)
 
diff --git a/docs/introvideos/versioncontrol.md b/docs/introvideos/versioncontrol.md
index 053cc6a814..d0b4758bd8 100644
--- a/docs/introvideos/versioncontrol.md
+++ b/docs/introvideos/versioncontrol.md
@@ -8,7 +8,7 @@ MetaSocialImage: images/opengraph/introvideos-social.png
 
 In this tutorial, we will learn how to use the basics of Git version control in {% data variables.product.prodname_vscode %}. For more information about integrated Git support, including how to work with remote repositories, read on in the [related resources](/docs/introvideos/versioncontrol.md#related-resources) section below.
 
-<iframe src="https://www.youtube-nocookie.com/embed/i_23KUAEtUM?autoplay=true" width="640" height="320" allowFullScreen="true" frameBorder="0" title="Using Git with {% data variables.product.prodname_vscode %}"></iframe>
+[![Watch Using Git with {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/versioncontrol/youtube-i_23KUAEtUM.jpg)](https://www.youtube.com/watch?v=i_23KUAEtUM)
 
 Here's the next video we recommend: [Customize](/docs/introvideos/customize.md)
 
diff --git a/docs/python/images/tutorial-fastapi/youtube-fPCjEbRpK1M.jpg b/docs/python/images/tutorial-fastapi/youtube-fPCjEbRpK1M.jpg
new file mode 100644
index 0000000000..b03f77a444
--- /dev/null
+++ b/docs/python/images/tutorial-fastapi/youtube-fPCjEbRpK1M.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:be62cf9fcc841e6f20ca034788833d02f131cb4300c1066d132e578fe90c7a79
+size 88341
diff --git a/docs/python/tutorial-fastapi.md b/docs/python/tutorial-fastapi.md
index 89c14c1f4b..7c5eaed687 100644
--- a/docs/python/tutorial-fastapi.md
+++ b/docs/python/tutorial-fastapi.md
@@ -719,7 +719,7 @@ Note that this should be done with caution because it will delete all the keys i
 
 With GitHub Codespaces, you can host your application for testing purposes when using [GPT Actions](https://platform.openai.com/docs/actions/introduction). GPT Actions are tools that enable [ChatGPT](https://chatgpt.com/) to interact with existing APIs to enhance ChatGPT's abilities, allowing it to perform a wide range of actions. You can follow along the live stream recording below to create your own grocery list plugin for ChatGPT:
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/fPCjEbRpK1M" title="Build a GPT Action with {% data variables.product.prodname_vscode_shortname %} and Codespaces" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+[![Watch Build a GPT Action with {% data variables.product.prodname_vscode_shortname %} and Codespaces on YouTube (opens in new tab).](images/tutorial-fastapi/youtube-fPCjEbRpK1M.jpg)](https://www.youtube.com/watch?v=fPCjEbRpK1M)
 
 >**Note**: All personal GitHub.com accounts have a monthly quota of free use of GitHub Codespaces included in the Free or Pro plan. For more information, go to [About billing for GitHub Codespaces](https://docs.github.com/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).
 
diff --git a/docs/remote/images/tunnels/youtube-SyLHXdXhE1U.jpg b/docs/remote/images/tunnels/youtube-SyLHXdXhE1U.jpg
new file mode 100644
index 0000000000..e55fda42be
--- /dev/null
+++ b/docs/remote/images/tunnels/youtube-SyLHXdXhE1U.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b9e418c5540080b8c20de6e7fa2882f1a0030e0d56a55790f66ff38b4fa88352
+size 120469
diff --git a/docs/remote/images/vscode-web/youtube-2sdXMJZKLJE.jpg b/docs/remote/images/vscode-web/youtube-2sdXMJZKLJE.jpg
new file mode 100644
index 0000000000..6dd351f5d6
--- /dev/null
+++ b/docs/remote/images/vscode-web/youtube-2sdXMJZKLJE.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4d6d9b210d97e85b971de1facac938e8a350dd6a4ea5335ef968fec457169870
+size 133165
diff --git a/docs/remote/tunnels.md b/docs/remote/tunnels.md
index de23797ffc..8ddc3c795d 100644
--- a/docs/remote/tunnels.md
+++ b/docs/remote/tunnels.md
@@ -15,7 +15,7 @@ This can eliminate the need for source code to be on your {% data variables.prod
 
 {% data variables.product.prodname_vscode_shortname %} can provide a **local-quality development experience** - including full IntelliSense (completions), code navigation, and debugging - **regardless of where your code is hosted**.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/SyLHXdXhE1U?si=J8ndBzVB0RPEsB7R" title="Access your computer anywhere with {% data variables.product.prodname_vscode_shortname %}" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Access your computer anywhere with {% data variables.product.prodname_vscode_shortname %} on YouTube (opens in new tab).](images/tunnels/youtube-SyLHXdXhE1U.jpg)](https://www.youtube.com/watch?v=SyLHXdXhE1U)
 
 ## Getting Started
 
diff --git a/docs/remote/vscode-web.md b/docs/remote/vscode-web.md
index 4a45913b43..118c14ec58 100644
--- a/docs/remote/vscode-web.md
+++ b/docs/remote/vscode-web.md
@@ -13,7 +13,7 @@ MetaDescription: {% data variables.product.prodname_vscode %} for the Web and th
 
 The following video gives a quick overview of {% data variables.product.prodname_vscode %} for the Web.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/2sdXMJZKLJE" title="Introduction to {% data variables.product.prodname_vscode %} for the Web" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Introduction to {% data variables.product.prodname_vscode %} for the Web on YouTube (opens in new tab).](images/vscode-web/youtube-2sdXMJZKLJE.jpg)](https://www.youtube.com/watch?v=2sdXMJZKLJE)
 
 ## Relationship to {% data variables.product.prodname_vscode_shortname %} Desktop
 
diff --git a/docs/sourcecontrol/images/overview/youtube-i_23KUAEtUM.jpg b/docs/sourcecontrol/images/overview/youtube-i_23KUAEtUM.jpg
new file mode 100644
index 0000000000..5e40fd2c8b
--- /dev/null
+++ b/docs/sourcecontrol/images/overview/youtube-i_23KUAEtUM.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cb28daaef7b94d3865e9707cd0456694667025ccbf20bad2f1eab39e067d8bd7
+size 77079
diff --git a/docs/sourcecontrol/overview.md b/docs/sourcecontrol/overview.md
index a9b6a01f9d..183e473783 100644
--- a/docs/sourcecontrol/overview.md
+++ b/docs/sourcecontrol/overview.md
@@ -16,7 +16,7 @@ The integrated source control interface provides access to Git functionality thr
 
 Changes you make in the {% data variables.product.prodname_vscode_shortname %} interface are synced with your command-line Git operations, so you can use both the UI and terminal as needed. The source control interface works alongside the command line rather than replacing it.
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/i_23KUAEtUM" title="Video showing how to use Git with {% data variables.product.prodname_vscode %}." frameborder="0" allowfullscreen></iframe>
+[![Watch Video showing how to use Git with {% data variables.product.prodname_vscode %} on YouTube (opens in new tab).](images/overview/youtube-i_23KUAEtUM.jpg)](https://www.youtube.com/watch?v=i_23KUAEtUM)
 
 ## Prerequisites
 
diff --git a/learn/agents/1-using-tools-with-agents.md b/learn/agents/1-using-tools-with-agents.md
index d4778469bf..dab49e2671 100644
--- a/learn/agents/1-using-tools-with-agents.md
+++ b/learn/agents/1-using-tools-with-agents.md
@@ -15,7 +15,7 @@ Keywords:
 # Using tools with agents
 
 <!-- IMAGE PLACEHOLDER - YouTube thumbnail embed showing the Customization UI -->
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/wZrQ0TAfpFg" title="Using Tools with Agents" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Using Tools with Agents on YouTube (opens in new tab).](images/1-using-tools-with-agents/youtube-wZrQ0TAfpFg.jpg)](https://www.youtube.com/watch?v=wZrQ0TAfpFg)
 
 Tools are how agents act on your request. They search your workspace, read files, edit code, run terminal commands, fetch web content, and call external services. In this guide, you will start with a small task, choose only the tools the task needs, and decide when to use a tool set, approvals, or sandboxing.
 
diff --git a/learn/agents/2-extending-agents-with-mcp-servers.md b/learn/agents/2-extending-agents-with-mcp-servers.md
index 8ceb5bb748..9f6ad27635 100644
--- a/learn/agents/2-extending-agents-with-mcp-servers.md
+++ b/learn/agents/2-extending-agents-with-mcp-servers.md
@@ -14,7 +14,7 @@ Keywords:
 
 # Extending agents with MCP servers
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Sf4qD7SS2NA" title="Extending Agents With MCP Servers" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Extending Agents With MCP Servers on YouTube (opens in new tab).](images/2-extending-agents-with-mcp-servers/youtube-Sf4qD7SS2NA.jpg)](https://www.youtube.com/watch?v=Sf4qD7SS2NA)
 
 MCP servers connect agents to external tools and data sources. In this guide, you will install an MCP server, use one of its tools in chat, choose the right configuration scope, and decide when to sandbox the server.
 
diff --git a/learn/agents/3-agent-plugins.md b/learn/agents/3-agent-plugins.md
index 6c1ea874eb..8cec8bb747 100644
--- a/learn/agents/3-agent-plugins.md
+++ b/learn/agents/3-agent-plugins.md
@@ -15,7 +15,7 @@ Keywords:
 # Agent plugins
 
 <!-- IMAGE PLACEHOLDER - YouTube thumbnail embed showing the Customization UI -->
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/9lonfxt7dqU" title="Agent Plugins" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Agent Plugins on YouTube (opens in new tab).](images/3-agent-plugins/youtube-9lonfxt7dqU.jpg)](https://www.youtube.com/watch?v=9lonfxt7dqU)
 
 Agent plugins bundle multiple customizations into one installable package. In this guide, you will inspect a plugin before installing it, use a plugin-provided command, and decide when a plugin is a better fit than separate local customizations.
 
diff --git a/learn/agents/4-using-third-party-agents-in-vs-code.md b/learn/agents/4-using-third-party-agents-in-vs-code.md
index 05cdf4590c..aa99e7cd98 100644
--- a/learn/agents/4-using-third-party-agents-in-vs-code.md
+++ b/learn/agents/4-using-third-party-agents-in-vs-code.md
@@ -15,7 +15,7 @@ Keywords:
 # Using third-party agents in VS Code
 
 <!-- IMAGE PLACEHOLDER - YouTube thumbnail embed showing the Customization UI -->
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/OWYQ8Mn7KqE" title="Third Party Agents" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Third Party Agents on YouTube (opens in new tab).](images/4-using-third-party-agents-in-vs-code/youtube-OWYQ8Mn7KqE.jpg)](https://www.youtube.com/watch?v=OWYQ8Mn7KqE)
 
 Third-party agents let you use provider-specific agent experiences inside VS Code. In this guide, you will choose between local and cloud sessions, start a Claude or Codex session, and pick a permission mode that matches the task.
 
diff --git a/learn/agents/images/1-using-tools-with-agents/youtube-wZrQ0TAfpFg.jpg b/learn/agents/images/1-using-tools-with-agents/youtube-wZrQ0TAfpFg.jpg
new file mode 100644
index 0000000000..9961e66c58
--- /dev/null
+++ b/learn/agents/images/1-using-tools-with-agents/youtube-wZrQ0TAfpFg.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4a36e5a8d11b62dacf57235aa7af01e92d50d8575401c98222268abf329455cf
+size 106944
diff --git a/learn/agents/images/2-extending-agents-with-mcp-servers/youtube-Sf4qD7SS2NA.jpg b/learn/agents/images/2-extending-agents-with-mcp-servers/youtube-Sf4qD7SS2NA.jpg
new file mode 100644
index 0000000000..d1293a9bcd
--- /dev/null
+++ b/learn/agents/images/2-extending-agents-with-mcp-servers/youtube-Sf4qD7SS2NA.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:15255b058f5deb0f0606072ba53d837ee8868f7e3ba2010355aa9702318d8cdd
+size 133741
diff --git a/learn/agents/images/3-agent-plugins/youtube-9lonfxt7dqU.jpg b/learn/agents/images/3-agent-plugins/youtube-9lonfxt7dqU.jpg
new file mode 100644
index 0000000000..4cf285e07d
--- /dev/null
+++ b/learn/agents/images/3-agent-plugins/youtube-9lonfxt7dqU.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:aecf1a7b5add04a785f3a7f311a54c55bfce124bf03d67e20bc3edebb7c1b484
+size 92136
diff --git a/learn/agents/images/4-using-third-party-agents-in-vs-code/youtube-OWYQ8Mn7KqE.jpg b/learn/agents/images/4-using-third-party-agents-in-vs-code/youtube-OWYQ8Mn7KqE.jpg
new file mode 100644
index 0000000000..83ed924f4c
--- /dev/null
+++ b/learn/agents/images/4-using-third-party-agents-in-vs-code/youtube-OWYQ8Mn7KqE.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9d2c937b44d679d02a224ac855b01e9266491455db1311951b02b96142d77e32
+size 97717
diff --git a/learn/customizations/1-why-customization-matter.md b/learn/customizations/1-why-customization-matter.md
index bf7d440ceb..50582bbc21 100644
--- a/learn/customizations/1-why-customization-matter.md
+++ b/learn/customizations/1-why-customization-matter.md
@@ -8,7 +8,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 # Why agent customization matters
 
 <!-- IMAGE PLACEHOLDER - YouTube thumbnail embed showing the Customization UI -->
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/AZzCk-WGks4?si=pzfh99aDDFODSrG_" title="The Agent Customizations UI Nobody Knows About" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch The Agent Customizations UI Nobody Knows About on YouTube (opens in new tab).](images/1-why-customization-matter/youtube-AZzCk-WGks4.jpg)](https://www.youtube.com/watch?v=AZzCk-WGks4)
 
 Most developers are using VS Code the same way: open chat, type something, and hope for a good result. Sometimes it works. Sometimes it doesn't.
 
diff --git a/learn/customizations/2-instructions.md b/learn/customizations/2-instructions.md
index e01cff6ca0..c14e8122b8 100644
--- a/learn/customizations/2-instructions.md
+++ b/learn/customizations/2-instructions.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Introduction to custom instructions
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/dk2biPguo_E?si=O15sDX8Jf18pXZFr" title="Custom Instructions: How I Really Made Copilot Listen!" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Custom Instructions: How I Really Made Copilot Listen! on YouTube (opens in new tab).](images/2-instructions/youtube-dk2biPguo_E.jpg)](https://www.youtube.com/watch?v=dk2biPguo_E)
 
 You’ve probably been lied to about custom instructions.
 
diff --git a/learn/customizations/3-skills.md b/learn/customizations/3-skills.md
index f5d6ec7e8d..3712565f02 100644
--- a/learn/customizations/3-skills.md
+++ b/learn/customizations/3-skills.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Introduction to agent skills
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/mPjTZviv23s?si=ADTQ4EhKNhzvqrgZ" title="Agent Skills Explained in 5 Minutes" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Agent Skills Explained in 5 Minutes on YouTube (opens in new tab).](images/3-skills/youtube-mPjTZviv23s.jpg)](https://www.youtube.com/watch?v=mPjTZviv23s)
 
 Most developers are either using agent skills wrong… or not at all.
 
diff --git a/learn/customizations/4-custom-agent.md b/learn/customizations/4-custom-agent.md
index 0508713274..6d96305e75 100644
--- a/learn/customizations/4-custom-agent.md
+++ b/learn/customizations/4-custom-agent.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Introduction to custom agents
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Y7MPeZTIgqo?si=1vBjXBngpAg7Zm4x" title="Let's Build a Custom Agent!" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Let's Build a Custom Agent! on YouTube (opens in new tab).](images/4-custom-agent/youtube-Y7MPeZTIgqo.jpg)](https://www.youtube.com/watch?v=Y7MPeZTIgqo)
 
 Are custom agents really that powerful?
 
diff --git a/learn/customizations/5-hooks.md b/learn/customizations/5-hooks.md
index bf2531d48c..d33d647de7 100644
--- a/learn/customizations/5-hooks.md
+++ b/learn/customizations/5-hooks.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Introduction to hooks
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/ZsyiRa91XZg?si=tI_1D0AgRBSEMrel" title="Hooks: The Underestimated Feature" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Hooks: The Underestimated Feature on YouTube (opens in new tab).](images/5-hooks/youtube-ZsyiRa91XZg.jpg)](https://www.youtube.com/watch?v=ZsyiRa91XZg)
 
 It seems like nobody talks enough about hooks.
 
diff --git a/learn/customizations/6-prompt-files.md b/learn/customizations/6-prompt-files.md
index 9385fa3649..489dfda621 100644
--- a/learn/customizations/6-prompt-files.md
+++ b/learn/customizations/6-prompt-files.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Introduction to prompt files
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/d37Y28uU2JY?si=MAKB-3F4Bopmv_Q6" title="Stop Prompting So Much. Do This Instead!" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Stop Prompting So Much. Do This Instead! on YouTube (opens in new tab).](images/6-prompt-files/youtube-d37Y28uU2JY.jpg)](https://www.youtube.com/watch?v=d37Y28uU2JY)
 
 If you’re constantly repeating prompts, you’re doing too much.
 
diff --git a/learn/customizations/7-customization-features-explained.md b/learn/customizations/7-customization-features-explained.md
index a0647b4d86..0e92344410 100644
--- a/learn/customizations/7-customization-features-explained.md
+++ b/learn/customizations/7-customization-features-explained.md
@@ -6,7 +6,7 @@ MetaDescription: Understand the differences between custom instructions, agent s
 
 # Understanding VS Code customization features together
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/oyMMotLlcgQ?si=899IQZ3GAgGhtkze" title="Instructions vs Skills vs Hooks & More Explained By Copilot Itself" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Instructions vs Skills vs Hooks & More Explained By Copilot Itself on YouTube (opens in new tab).](images/7-customization-features-explained/youtube-oyMMotLlcgQ.jpg)](https://www.youtube.com/watch?v=oyMMotLlcgQ)
 
 There are quite a few customization options in VS Code.
 
diff --git a/learn/customizations/8-demo.md b/learn/customizations/8-demo.md
index 713c7d546c..84ad1139e3 100644
--- a/learn/customizations/8-demo.md
+++ b/learn/customizations/8-demo.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Customization features in practice
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Bb45ZoKfJf0?si=SgI3qnVLwYpLUxZV" title="Customization Features in Practice" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Customization Features in Practice on YouTube (opens in new tab).](images/8-demo/youtube-Bb45ZoKfJf0.jpg)](https://www.youtube.com/watch?v=Bb45ZoKfJf0)
 
 You may have seen quite a few videos about customization features in VS Code.
 
diff --git a/learn/customizations/images/1-why-customization-matter/youtube-AZzCk-WGks4.jpg b/learn/customizations/images/1-why-customization-matter/youtube-AZzCk-WGks4.jpg
new file mode 100644
index 0000000000..47d5b5b380
--- /dev/null
+++ b/learn/customizations/images/1-why-customization-matter/youtube-AZzCk-WGks4.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:df4d6172d5bc0bd504456a33dc00f24b2c2cd71a3987c45382306bf380eba2d7
+size 97206
diff --git a/learn/customizations/images/2-instructions/youtube-dk2biPguo_E.jpg b/learn/customizations/images/2-instructions/youtube-dk2biPguo_E.jpg
new file mode 100644
index 0000000000..57fa53aae7
--- /dev/null
+++ b/learn/customizations/images/2-instructions/youtube-dk2biPguo_E.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0ac01f944447a44b25fd26026861a758d41c7e3b3cf57d0df9b2f9c0cd78192c
+size 108073
diff --git a/learn/customizations/images/3-skills/youtube-mPjTZviv23s.jpg b/learn/customizations/images/3-skills/youtube-mPjTZviv23s.jpg
new file mode 100644
index 0000000000..9b080042d3
--- /dev/null
+++ b/learn/customizations/images/3-skills/youtube-mPjTZviv23s.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:01cd7b228a19b37323e7f28badf4a17818f4045fe51b4e913e584fb20119ab38
+size 115241
diff --git a/learn/customizations/images/4-custom-agent/youtube-Y7MPeZTIgqo.jpg b/learn/customizations/images/4-custom-agent/youtube-Y7MPeZTIgqo.jpg
new file mode 100644
index 0000000000..d8860d9cb3
--- /dev/null
+++ b/learn/customizations/images/4-custom-agent/youtube-Y7MPeZTIgqo.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0dd7b79a33fe8e32a3dd35a86aab44a040b2cad5003606019b59e4a54d87a9e0
+size 110511
diff --git a/learn/customizations/images/5-hooks/youtube-ZsyiRa91XZg.jpg b/learn/customizations/images/5-hooks/youtube-ZsyiRa91XZg.jpg
new file mode 100644
index 0000000000..36bd734129
--- /dev/null
+++ b/learn/customizations/images/5-hooks/youtube-ZsyiRa91XZg.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:10e371ac98715509546d3cf75096a6f6fab81b84210c316854cc8724519a0549
+size 102196
diff --git a/learn/customizations/images/6-prompt-files/youtube-d37Y28uU2JY.jpg b/learn/customizations/images/6-prompt-files/youtube-d37Y28uU2JY.jpg
new file mode 100644
index 0000000000..110316e30d
--- /dev/null
+++ b/learn/customizations/images/6-prompt-files/youtube-d37Y28uU2JY.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:500bb154878c059a643195759c56f16fc71624497403813a8edf21101533fec4
+size 124956
diff --git a/learn/customizations/images/7-customization-features-explained/youtube-oyMMotLlcgQ.jpg b/learn/customizations/images/7-customization-features-explained/youtube-oyMMotLlcgQ.jpg
new file mode 100644
index 0000000000..b282becc29
--- /dev/null
+++ b/learn/customizations/images/7-customization-features-explained/youtube-oyMMotLlcgQ.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:02489325e2039c388ee65787919e63476996e466b482bc44595ea3c1e636b179
+size 108013
diff --git a/learn/customizations/images/8-demo/youtube-Bb45ZoKfJf0.jpg b/learn/customizations/images/8-demo/youtube-Bb45ZoKfJf0.jpg
new file mode 100644
index 0000000000..0fb91026f1
--- /dev/null
+++ b/learn/customizations/images/8-demo/youtube-Bb45ZoKfJf0.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:07e85292cdf03a648b9dba58beec613a5a95b456b444db091c77ddddb0034078
+size 119061
diff --git a/learn/foundations/agent-sessions-and-where-agents-run.md b/learn/foundations/agent-sessions-and-where-agents-run.md
index dbbde482cc..3339a41bdd 100644
--- a/learn/foundations/agent-sessions-and-where-agents-run.md
+++ b/learn/foundations/agent-sessions-and-where-agents-run.md
@@ -6,7 +6,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 ---
 # Agent sessions and where agents run
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/0CsKOO7d35I?si=z020p9GwioCzmOH4" title="Video for agent sessions and where agents run." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video for agent sessions and where agents run on YouTube (opens in new tab).](images/agent-sessions-and-where-agents-run/youtube-0CsKOO7d35I.jpg)](https://www.youtube.com/watch?v=0CsKOO7d35I)
 
 As you work with agents, you accumulate multiple sessions across different features, bug fixes, and explorations. You also want to run several agents simultaneously, one working interactively while another handles background tasks, for example. This guide covers how to navigate and manage agent sessions, and the difference between the three places an agent can run, locally in VS Code, on the Agent Host with Copilot, and remotely in the cloud on GitHub infrastructure.
 
diff --git a/learn/foundations/approvals-autonomy-and-context-budget.md b/learn/foundations/approvals-autonomy-and-context-budget.md
index 8fb5cd4a2a..137d9f05bd 100644
--- a/learn/foundations/approvals-autonomy-and-context-budget.md
+++ b/learn/foundations/approvals-autonomy-and-context-budget.md
@@ -6,7 +6,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 ---
 # Your first agent session
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/WcN74XvZGes?si=OCbyVFSsIskUnHga" title="Video for approvals, autonomy, and context budget." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video for approvals, autonomy, and context budget on YouTube (opens in new tab).](images/approvals-autonomy-and-context-budget/youtube-WcN74XvZGes.jpg)](https://www.youtube.com/watch?v=WcN74XvZGes)
 
 Every action an agent takes on your machine, running a command, writing a file, or launching a server, happens through its tools. By default, terminal commands require explicit approval before they run. This guide covers how approvals work, how to set the right autonomy level for a session, and how to monitor context budget as work builds up.
 
diff --git a/learn/foundations/build-your-first-app-with-agent-mode.md b/learn/foundations/build-your-first-app-with-agent-mode.md
index d01922e3a6..9b120c6e6a 100644
--- a/learn/foundations/build-your-first-app-with-agent-mode.md
+++ b/learn/foundations/build-your-first-app-with-agent-mode.md
@@ -6,7 +6,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 ---
 # Build your first app with agent mode
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/hmfldW7dmgw?si=v9OJQDJZPMkGf-jt" title="Video for building your first app with agent mode." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video for building your first app with agent mode on YouTube (opens in new tab).](images/build-your-first-app-with-agent-mode/youtube-hmfldW7dmgw.jpg)](https://www.youtube.com/watch?v=hmfldW7dmgw)
 
 This guide is a capstone walkthrough that ties together everything covered in the series. You will build a URL shortener from scratch using agent-first development, FastAPI for the API, Python `sqlite3` for the database, a simple HTML frontend, and the base62 encoder from earlier in the series.
 
diff --git a/learn/foundations/debugging-and-whats-happening-behind-the-scenes.md b/learn/foundations/debugging-and-whats-happening-behind-the-scenes.md
index 6c8695adb9..bc57ee74d6 100644
--- a/learn/foundations/debugging-and-whats-happening-behind-the-scenes.md
+++ b/learn/foundations/debugging-and-whats-happening-behind-the-scenes.md
@@ -6,7 +6,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 ---
 # Debugging agent work
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/aW2jlbbUREc?si=EmrRxM6eNywWK7sK" title="Video for debugging and what's happening behind the scenes." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video for debugging and what's happening behind the scenes on YouTube (opens in new tab).](images/debugging-and-whats-happening-behind-the-scenes/youtube-aW2jlbbUREc.jpg)](https://www.youtube.com/watch?v=aW2jlbbUREc)
 
 When the agent does something unexpected, calls the wrong tool, produces an odd response, or ignores a customization file, you want to understand why. VS Code and GitHub Copilot Chat are open source, and that transparency extends to what happens at runtime. This guide covers the Agent Debug Log panel, the Chat Debug view, and how to use both to diagnose agent behavior.
 
diff --git a/learn/foundations/images/agent-sessions-and-where-agents-run/youtube-0CsKOO7d35I.jpg b/learn/foundations/images/agent-sessions-and-where-agents-run/youtube-0CsKOO7d35I.jpg
new file mode 100644
index 0000000000..ee38182a99
--- /dev/null
+++ b/learn/foundations/images/agent-sessions-and-where-agents-run/youtube-0CsKOO7d35I.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:da02b5133116eee5b9803d5d42ef24c51b41e8286a2826797f464151faf3a5e2
+size 149359
diff --git a/learn/foundations/images/approvals-autonomy-and-context-budget/youtube-WcN74XvZGes.jpg b/learn/foundations/images/approvals-autonomy-and-context-budget/youtube-WcN74XvZGes.jpg
new file mode 100644
index 0000000000..fe94d8e0f4
--- /dev/null
+++ b/learn/foundations/images/approvals-autonomy-and-context-budget/youtube-WcN74XvZGes.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ff850644e37c01477345becaa927baa1bc5e336d3370da12c1dbcf661bad09c7
+size 145045
diff --git a/learn/foundations/images/build-your-first-app-with-agent-mode/youtube-hmfldW7dmgw.jpg b/learn/foundations/images/build-your-first-app-with-agent-mode/youtube-hmfldW7dmgw.jpg
new file mode 100644
index 0000000000..314f30ea68
--- /dev/null
+++ b/learn/foundations/images/build-your-first-app-with-agent-mode/youtube-hmfldW7dmgw.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:53894ca6f1d2caa23c2f4a16e2ff2d21ed37bb6cbac3847c4a405cd6c72e83e9
+size 155751
diff --git a/learn/foundations/images/debugging-and-whats-happening-behind-the-scenes/youtube-aW2jlbbUREc.jpg b/learn/foundations/images/debugging-and-whats-happening-behind-the-scenes/youtube-aW2jlbbUREc.jpg
new file mode 100644
index 0000000000..6da713b5dc
--- /dev/null
+++ b/learn/foundations/images/debugging-and-whats-happening-behind-the-scenes/youtube-aW2jlbbUREc.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:483b850b2b4b19f84d0366b2c34fe74e8aabd5b50be4ebfb8f07ee12efe1920e
+size 163334
diff --git a/learn/foundations/images/introduction-to-agent-first-development/youtube-uu4sf8z9n8c.jpg b/learn/foundations/images/introduction-to-agent-first-development/youtube-uu4sf8z9n8c.jpg
new file mode 100644
index 0000000000..78e8e1ecc6
--- /dev/null
+++ b/learn/foundations/images/introduction-to-agent-first-development/youtube-uu4sf8z9n8c.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a6cbc115f4094e7201dd38e2c70dd53a17ce533e8f3364878c897cf8de5cf7e8
+size 147736
diff --git a/learn/foundations/images/reviewing-and-controlling-agent-changes/youtube-oFSJs6RnFt4.jpg b/learn/foundations/images/reviewing-and-controlling-agent-changes/youtube-oFSJs6RnFt4.jpg
new file mode 100644
index 0000000000..114b28588b
--- /dev/null
+++ b/learn/foundations/images/reviewing-and-controlling-agent-changes/youtube-oFSJs6RnFt4.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8a5f38b2b9787bec2ce6f008449b0a8dfdb2b327125deed025deb251cc0db6c7
+size 149936
diff --git a/learn/foundations/introduction-to-agent-first-development.md b/learn/foundations/introduction-to-agent-first-development.md
index f18c3a4b98..b918691105 100644
--- a/learn/foundations/introduction-to-agent-first-development.md
+++ b/learn/foundations/introduction-to-agent-first-development.md
@@ -6,7 +6,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 ---
 # Introduction to agent-first development
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/uu4sf8z9n8c?si=LCd-U0f2diDZ4JUE" title="Video for introduction to agent-first development." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video for introduction to agent-first development on YouTube (opens in new tab).](images/introduction-to-agent-first-development/youtube-uu4sf8z9n8c.jpg)](https://www.youtube.com/watch?v=uu4sf8z9n8c)
 
 How you write code is changing. You can still write every single line yourself, and that might be appropriate for specific use cases. But another pattern is emerging across the industry, using agents in programming, often called agentic programming or agent-first development.
 
diff --git a/learn/foundations/reviewing-and-controlling-agent-changes.md b/learn/foundations/reviewing-and-controlling-agent-changes.md
index b842c2c05c..cd12fe3d7a 100644
--- a/learn/foundations/reviewing-and-controlling-agent-changes.md
+++ b/learn/foundations/reviewing-and-controlling-agent-changes.md
@@ -6,7 +6,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 ---
 # Reviewing and controlling agent changes
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/oFSJs6RnFt4?si=jCPXRc6GxzgYG1y9" title="Video for reviewing and controlling agent changes." frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch Video for reviewing and controlling agent changes on YouTube (opens in new tab).](images/reviewing-and-controlling-agent-changes/youtube-oFSJs6RnFt4.jpg)](https://www.youtube.com/watch?v=oFSJs6RnFt4)
 
 When an agent finishes a round of work, it leaves behind proposed changes, edits to files, new files, and deleted files. Nothing is permanent until you say so. This guide covers how to review what the agent did, accept or undo changes at any granularity, and use the tools available to steer the agent, correct mistakes, and explore multiple directions without losing work.
 
diff --git a/learn/foundry-toolkit-extension/1-get-started.md b/learn/foundry-toolkit-extension/1-get-started.md
index ec27fee950..9fc4e205e3 100644
--- a/learn/foundry-toolkit-extension/1-get-started.md
+++ b/learn/foundry-toolkit-extension/1-get-started.md
@@ -14,7 +14,7 @@ Keywords:
 
 # Getting Started with Foundry Toolkit in Visual Studio Code
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/aQFSDGAk9DA" title="Chapter 1 Video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Chapter 1 Video on YouTube (opens in new tab).](images/1-get-started/youtube-aQFSDGAk9DA.jpg)](https://www.youtube.com/watch?v=aQFSDGAk9DA)
 
 You know that moment when a prototype looks great, but the team still feels slow? Usually it is not the model quality. It is workflow sprawl: model lookup in one place, prompt testing in another, deployment checks somewhere else.
 
diff --git a/learn/foundry-toolkit-extension/2-exploring-models.md b/learn/foundry-toolkit-extension/2-exploring-models.md
index b70b09d060..87d6ce412f 100644
--- a/learn/foundry-toolkit-extension/2-exploring-models.md
+++ b/learn/foundry-toolkit-extension/2-exploring-models.md
@@ -14,7 +14,7 @@ Keywords:
 
 # Exploring Models with Model Catalog
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/92tKoJOTays" title="Chapter 2 Video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Chapter 2 Video on YouTube (opens in new tab).](images/2-exploring-models/youtube-92tKoJOTays.jpg)](https://www.youtube.com/watch?v=92tKoJOTays)
 
 When building AI applications, one of the hardest parts is not implementation, it is picking the right model. You can have strong prompts and a clean workflow, but if the model is mismatched, quality and speed both take a hit.
 
diff --git a/learn/foundry-toolkit-extension/3-building-social-media-agent.md b/learn/foundry-toolkit-extension/3-building-social-media-agent.md
index 1ff62400d6..911a517fcf 100644
--- a/learn/foundry-toolkit-extension/3-building-social-media-agent.md
+++ b/learn/foundry-toolkit-extension/3-building-social-media-agent.md
@@ -14,7 +14,7 @@ Keywords:
 
 # Building a Social Media Content Agent with Agent Builder
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/NPGMgljY2Gs" title="Chapter 3 Video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Chapter 3 Video on YouTube (opens in new tab).](images/3-building-social-media-agent/youtube-NPGMgljY2Gs.jpg)](https://www.youtube.com/watch?v=NPGMgljY2Gs)
 
 This chapter walks through building a practical social media content agent using Agent Builder in Foundry Toolkit. The goal is not just to generate text, but to create an assistant that asks the right follow-up questions, uses trusted context, and returns output a team can actually review and ship.
 
diff --git a/learn/foundry-toolkit-extension/4-building-hosted-agent.md b/learn/foundry-toolkit-extension/4-building-hosted-agent.md
index e411d6a92a..cfd01af535 100644
--- a/learn/foundry-toolkit-extension/4-building-hosted-agent.md
+++ b/learn/foundry-toolkit-extension/4-building-hosted-agent.md
@@ -14,7 +14,7 @@ Keywords:
 
 # Building a Hosted Agent with GitHub Copilot and Microsoft Foundry
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/pxG-9Lh_a44" title="Chapter 4 Video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Chapter 4 Video on YouTube (opens in new tab).](images/4-building-hosted-agent/youtube-pxG-9Lh_a44.jpg)](https://www.youtube.com/watch?v=pxG-9Lh_a44)
 
 Low-code agents are great for proving behavior quickly, but most teams eventually need stronger control over code, deployment, and integration. In this chapter, we move into a code-first workflow and build a hosted agent that can be developed locally, debugged with tooling, and deployed into Microsoft Foundry.
 
diff --git a/learn/foundry-toolkit-extension/images/1-get-started/youtube-aQFSDGAk9DA.jpg b/learn/foundry-toolkit-extension/images/1-get-started/youtube-aQFSDGAk9DA.jpg
new file mode 100644
index 0000000000..b087efea07
--- /dev/null
+++ b/learn/foundry-toolkit-extension/images/1-get-started/youtube-aQFSDGAk9DA.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:89efc088acfde9fa747489611475ce59afc1e86a9f8d1546b304310fb8aed501
+size 101840
diff --git a/learn/foundry-toolkit-extension/images/2-exploring-models/youtube-92tKoJOTays.jpg b/learn/foundry-toolkit-extension/images/2-exploring-models/youtube-92tKoJOTays.jpg
new file mode 100644
index 0000000000..dde64caafa
--- /dev/null
+++ b/learn/foundry-toolkit-extension/images/2-exploring-models/youtube-92tKoJOTays.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:389503dd195143c822fb3f26944f79fe42f31b5b6b2d344f7c7064d6d2f83926
+size 107323
diff --git a/learn/foundry-toolkit-extension/images/3-building-social-media-agent/youtube-NPGMgljY2Gs.jpg b/learn/foundry-toolkit-extension/images/3-building-social-media-agent/youtube-NPGMgljY2Gs.jpg
new file mode 100644
index 0000000000..ebfd660462
--- /dev/null
+++ b/learn/foundry-toolkit-extension/images/3-building-social-media-agent/youtube-NPGMgljY2Gs.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:44c3609825f0ffa3d1430b0f1696cdf3cf5f1d827a648d0f32b3ee4a7ffbb724
+size 108556
diff --git a/learn/foundry-toolkit-extension/images/4-building-hosted-agent/youtube-pxG-9Lh_a44.jpg b/learn/foundry-toolkit-extension/images/4-building-hosted-agent/youtube-pxG-9Lh_a44.jpg
new file mode 100644
index 0000000000..94ac00743f
--- /dev/null
+++ b/learn/foundry-toolkit-extension/images/4-building-hosted-agent/youtube-pxG-9Lh_a44.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:63d33943565453bb2729b816cad5bfb8efb1ac821b1269cd6be3da30bd79f02c
+size 115907
diff --git a/learn/java-spring-boot/1-build-and-run.md b/learn/java-spring-boot/1-build-and-run.md
index 910412d194..7da4c72f6c 100644
--- a/learn/java-spring-boot/1-build-and-run.md
+++ b/learn/java-spring-boot/1-build-and-run.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Build and run your first Spring Boot app in Visual Studio Code
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/ZX8LEQpKPx0?si=HUjEWz0XHj_aDysn" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Getting started with your first Java app in VS Code on YouTube (opens in new tab).](images/1-build-and-run/youtube-ZX8LEQpKPx0.jpg)](https://www.youtube.com/watch?v=ZX8LEQpKPx0)
 
 You know that moment when you clone a Java repository, open it, and nothing happens? No
 run button, no green ticks, no clue which of the two hundred files is the one that
diff --git a/learn/java-spring-boot/2-debug-and-inspect.md b/learn/java-spring-boot/2-debug-and-inspect.md
index 99dbcab86f..a08a7be9ab 100644
--- a/learn/java-spring-boot/2-debug-and-inspect.md
+++ b/learn/java-spring-boot/2-debug-and-inspect.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Debug and inspect a Spring Boot request in Visual Studio Code
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/y8SdqmjEqq8?si=HCMMP-G-YbvPkhdg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Debugging your Java App in VS Code on YouTube (opens in new tab).](images/2-debug-and-inspect/youtube-y8SdqmjEqq8.jpg)](https://www.youtube.com/watch?v=y8SdqmjEqq8)
 
 A web app that works is not the same as a web app you understand. The page says the item
 was added. It does not say which method received the title, where the id came from, or
diff --git a/learn/java-spring-boot/3-expose-tools-with-mcp.md b/learn/java-spring-boot/3-expose-tools-with-mcp.md
index 4cd83a027d..c0691d6819 100644
--- a/learn/java-spring-boot/3-expose-tools-with-mcp.md
+++ b/learn/java-spring-boot/3-expose-tools-with-mcp.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Expose your Java operations to GitHub Copilot with MCP
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/gzyU4yn0qGw?si=uR_pS8uOGbbtjY80" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch Expose your Spring Boot API endpoints via MCP and GitHub Copilot on YouTube (opens in new tab).](images/3-expose-tools-with-mcp/youtube-gzyU4yn0qGw.jpg)](https://www.youtube.com/watch?v=gzyU4yn0qGw)
 
 GitHub Copilot is very good at writing Java. It is far less good at knowing what is
 currently in *your* running application, because it cannot see it.
diff --git a/learn/java-spring-boot/4-test-with-playwright.md b/learn/java-spring-boot/4-test-with-playwright.md
index 6548feb7f9..8bbd5e88f3 100644
--- a/learn/java-spring-boot/4-test-with-playwright.md
+++ b/learn/java-spring-boot/4-test-with-playwright.md
@@ -7,7 +7,7 @@ MetaSocialImage: ../images/shared/agent-first-development-social.png
 
 # Let GitHub Copilot test your Spring Boot app with Playwright
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/NR4YHj_9WFw?si=UBOLCtYL2T5gHIqA" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+[![Watch End-to-End Testing for Spring Boot apps with Playwright in VS Code on YouTube (opens in new tab).](images/4-test-with-playwright/youtube-NR4YHj_9WFw.jpg)](https://www.youtube.com/watch?v=NR4YHj_9WFw)
 
 Your unit tests pass. Your integration tests pass. And you still open the browser
 afterwards to check that the page actually works, because a green build has never proved
diff --git a/learn/java-spring-boot/images/1-build-and-run/youtube-ZX8LEQpKPx0.jpg b/learn/java-spring-boot/images/1-build-and-run/youtube-ZX8LEQpKPx0.jpg
new file mode 100644
index 0000000000..33498cc84e
--- /dev/null
+++ b/learn/java-spring-boot/images/1-build-and-run/youtube-ZX8LEQpKPx0.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bd45e82b404c88b65816a4571bf5438ff19aa8c66035e1715fe4a784e54222fc
+size 121094
diff --git a/learn/java-spring-boot/images/2-debug-and-inspect/youtube-y8SdqmjEqq8.jpg b/learn/java-spring-boot/images/2-debug-and-inspect/youtube-y8SdqmjEqq8.jpg
new file mode 100644
index 0000000000..c17c005afa
--- /dev/null
+++ b/learn/java-spring-boot/images/2-debug-and-inspect/youtube-y8SdqmjEqq8.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c1f5f4e2e88729da2d214f1136d13c0dd507d1bbbaa56bb0d7f837b78ebda06b
+size 102366
diff --git a/learn/java-spring-boot/images/3-expose-tools-with-mcp/youtube-gzyU4yn0qGw.jpg b/learn/java-spring-boot/images/3-expose-tools-with-mcp/youtube-gzyU4yn0qGw.jpg
new file mode 100644
index 0000000000..aa7a14a00f
--- /dev/null
+++ b/learn/java-spring-boot/images/3-expose-tools-with-mcp/youtube-gzyU4yn0qGw.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f64d7252055c05d68785f707c4f356e9107831340ef95ed22171af98117fe9ca
+size 129570
diff --git a/learn/java-spring-boot/images/4-test-with-playwright/youtube-NR4YHj_9WFw.jpg b/learn/java-spring-boot/images/4-test-with-playwright/youtube-NR4YHj_9WFw.jpg
new file mode 100644
index 0000000000..01424cc1ea
--- /dev/null
+++ b/learn/java-spring-boot/images/4-test-with-playwright/youtube-NR4YHj_9WFw.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9a02743e827e998f508381da8a330ae3376369f8737926002928cde944776778
+size 127100
diff --git a/release-notes/v1_61.md b/release-notes/v1_61.md
index 78f1344400..183fe1df5d 100644
--- a/release-notes/v1_61.md
+++ b/release-notes/v1_61.md
@@ -543,7 +543,7 @@ In the container documentation, you can learn how to:
 * [Work with multiple containers](https://code.visualstudio.com/remote/advancedcontainers/connect-multiple-containers)
 * And more...
 
-The advanced container configuration documentation has tips and code examples for setting up your development containers as well as short [YouTube videos](https://www.youtube-nocookie.com/embed/vEb7hKlagAU).
+The advanced container configuration documentation has tips and code examples for setting up your development containers as well as short [YouTube videos](https://www.youtube.com/watch?v=vEb7hKlagAU).
 
 ## Notable fixes
 
diff --git a/remote/advancedcontainers/add-local-file-mount.md b/remote/advancedcontainers/add-local-file-mount.md
index e69d75896a..fd2c895a1e 100644
--- a/remote/advancedcontainers/add-local-file-mount.md
+++ b/remote/advancedcontainers/add-local-file-mount.md
@@ -32,7 +32,7 @@ You can add a volume bound to any local folder by using the following appropriat
 
 ### Video: Add additional folders from your local machine to a dev container
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/L1-dx-ZD0Ao" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to add a folder from your local file system to a dev container on YouTube (opens in new tab).](images/add-local-file-mount/youtube-L1-dx-ZD0Ao.jpg)](https://www.youtube.com/watch?v=L1-dx-ZD0Ao)
 
 <br><br>
 
diff --git a/remote/advancedcontainers/change-default-source-mount.md b/remote/advancedcontainers/change-default-source-mount.md
index 4c582d66a5..e2d2b6e4e2 100644
--- a/remote/advancedcontainers/change-default-source-mount.md
+++ b/remote/advancedcontainers/change-default-source-mount.md
@@ -28,10 +28,10 @@ If you've already built the container and connected to it, run **Dev Containers:
 
 ### Video : Work with Monorepos in a dev container by changing default mount
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/o5coAL7oE0o" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to work with Monorepos in a dev container on YouTube (opens in new tab).](images/change-default-source-mount/youtube-o5coAL7oE0o.jpg)](https://www.youtube.com/watch?v=o5coAL7oE0o)
 
 <br><br>
 
 ### Video : Change the default location of your project in a container
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/4zX2XWTmr3c" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to change the default location of your project in a dev container on YouTube (opens in new tab).](images/change-default-source-mount/youtube-4zX2XWTmr3c.jpg)](https://www.youtube.com/watch?v=4zX2XWTmr3c)
diff --git a/remote/advancedcontainers/environment-variables.md b/remote/advancedcontainers/environment-variables.md
index 4417e088c4..7e8afa7bfd 100644
--- a/remote/advancedcontainers/environment-variables.md
+++ b/remote/advancedcontainers/environment-variables.md
@@ -35,7 +35,7 @@ Depending on what you reference in `devcontainer.json`:
 
 ### Video: Modify PATH in a dev container
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/vEb7hKlagAU" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe>
+[![Watch How to modify the PATH variable in a dev container on YouTube (opens in new tab).](images/environment-variables/youtube-vEb7hKlagAU.jpg)](https://www.youtube.com/watch?v=vEb7hKlagAU)
 
 <br><br>
 
@@ -100,4 +100,4 @@ If you've already built the container and connected to it, run **Dev Containers:
 
 ### Video: Load variables from an .env file
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/qTU7w3bWrOk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe>
+[![Watch How to use a .env file to load environment variables in a dev container on YouTube (opens in new tab).](images/environment-variables/youtube-qTU7w3bWrOk.jpg)](https://www.youtube.com/watch?v=qTU7w3bWrOk)
diff --git a/remote/advancedcontainers/images/add-local-file-mount/youtube-L1-dx-ZD0Ao.jpg b/remote/advancedcontainers/images/add-local-file-mount/youtube-L1-dx-ZD0Ao.jpg
new file mode 100644
index 0000000000..41a62b4f19
--- /dev/null
+++ b/remote/advancedcontainers/images/add-local-file-mount/youtube-L1-dx-ZD0Ao.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8459bac42ce722996c5c64233f134a0c8bee2affb70c32a9c63410ceac610b5f
+size 88187
diff --git a/remote/advancedcontainers/images/change-default-source-mount/youtube-4zX2XWTmr3c.jpg b/remote/advancedcontainers/images/change-default-source-mount/youtube-4zX2XWTmr3c.jpg
new file mode 100644
index 0000000000..28b8188211
--- /dev/null
+++ b/remote/advancedcontainers/images/change-default-source-mount/youtube-4zX2XWTmr3c.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b02854c41275bacd8c8ca39c1d84a28680edd29aed18cb5d9d5eb7dee02654d2
+size 90330
diff --git a/remote/advancedcontainers/images/change-default-source-mount/youtube-o5coAL7oE0o.jpg b/remote/advancedcontainers/images/change-default-source-mount/youtube-o5coAL7oE0o.jpg
new file mode 100644
index 0000000000..edb7b0211a
--- /dev/null
+++ b/remote/advancedcontainers/images/change-default-source-mount/youtube-o5coAL7oE0o.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c342bfe6752a10912d8c9e6e6316fb992178eaaf3b979234c0792b24643b3225
+size 74096
diff --git a/remote/advancedcontainers/images/environment-variables/youtube-qTU7w3bWrOk.jpg b/remote/advancedcontainers/images/environment-variables/youtube-qTU7w3bWrOk.jpg
new file mode 100644
index 0000000000..e6704f9b4a
--- /dev/null
+++ b/remote/advancedcontainers/images/environment-variables/youtube-qTU7w3bWrOk.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:007ad46716d14c54cd7d7f061397a67f203872fe5b5528ebe2ad274dd7a2399a
+size 101044
diff --git a/remote/advancedcontainers/images/environment-variables/youtube-vEb7hKlagAU.jpg b/remote/advancedcontainers/images/environment-variables/youtube-vEb7hKlagAU.jpg
new file mode 100644
index 0000000000..f027f5f1b1
--- /dev/null
+++ b/remote/advancedcontainers/images/environment-variables/youtube-vEb7hKlagAU.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ca792fe71846816a8613e2d5b5f8719b6cdc0ccbca8f839359ab86755a72807e
+size 81801
diff --git a/remote/advancedcontainers/images/improve-performance/youtube-MUsROtVmPJM.jpg b/remote/advancedcontainers/images/improve-performance/youtube-MUsROtVmPJM.jpg
new file mode 100644
index 0000000000..89a99ccb85
--- /dev/null
+++ b/remote/advancedcontainers/images/improve-performance/youtube-MUsROtVmPJM.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:da152e6e77ade29035f81a4f46e9fbcccee8bf3dce4aa2236ad74581a168701b
+size 130273
diff --git a/remote/advancedcontainers/images/improve-performance/youtube-iDdJWIPRUx4.jpg b/remote/advancedcontainers/images/improve-performance/youtube-iDdJWIPRUx4.jpg
new file mode 100644
index 0000000000..3ddc9ae878
--- /dev/null
+++ b/remote/advancedcontainers/images/improve-performance/youtube-iDdJWIPRUx4.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3388bf9c7d36ccaed769700224f9412b1950d8573b8719c62031b756b33a54ac
+size 121195
diff --git a/remote/advancedcontainers/images/persist-bash-history/youtube-12nZz-TjoZg.jpg b/remote/advancedcontainers/images/persist-bash-history/youtube-12nZz-TjoZg.jpg
new file mode 100644
index 0000000000..71f84031c2
--- /dev/null
+++ b/remote/advancedcontainers/images/persist-bash-history/youtube-12nZz-TjoZg.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0a22a8df92918b695cb9fe72a337364c83db365f2f666ed82099f0976f222841
+size 129684
diff --git a/remote/advancedcontainers/images/start-processes/youtube-9qRy_kxVCK8.jpg b/remote/advancedcontainers/images/start-processes/youtube-9qRy_kxVCK8.jpg
new file mode 100644
index 0000000000..4a47fa4414
--- /dev/null
+++ b/remote/advancedcontainers/images/start-processes/youtube-9qRy_kxVCK8.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a0c07ca259fbe495f7e8045370682ae17adc8c225172dcb37e41091650e41641
+size 127485
diff --git a/remote/advancedcontainers/images/start-processes/youtube-KuSNpZgDYDs.jpg b/remote/advancedcontainers/images/start-processes/youtube-KuSNpZgDYDs.jpg
new file mode 100644
index 0000000000..c8ad12fa2d
--- /dev/null
+++ b/remote/advancedcontainers/images/start-processes/youtube-KuSNpZgDYDs.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ca60733a005174a5a030f58d230cae70836791c20e2f1d678170a2a8d29cea21
+size 114509
diff --git a/remote/advancedcontainers/images/start-processes/youtube-zFzPnWgBx_I.jpg b/remote/advancedcontainers/images/start-processes/youtube-zFzPnWgBx_I.jpg
new file mode 100644
index 0000000000..60d0e852c8
--- /dev/null
+++ b/remote/advancedcontainers/images/start-processes/youtube-zFzPnWgBx_I.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c7359ca1a55d2466dc79708338b3246ea73bf635484520382ec5422700f32939
+size 112359
diff --git a/remote/advancedcontainers/improve-performance.md b/remote/advancedcontainers/improve-performance.md
index abcd8bc8c8..6ee8b5fe99 100644
--- a/remote/advancedcontainers/improve-performance.md
+++ b/remote/advancedcontainers/improve-performance.md
@@ -19,7 +19,7 @@ See [Open a WSL 2 folder in a container on Windows](/docs/devcontainers/containe
 
 ### Video: Speed up Dev Containers on Windows
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/MUsROtVmPJM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to speed up Remote-Containers on Windows on YouTube (opens in new tab).](images/improve-performance/youtube-MUsROtVmPJM.jpg)](https://www.youtube.com/watch?v=MUsROtVmPJM)
 
 ## Use Clone Repository in Container Volume
 
@@ -107,7 +107,7 @@ If you've already built the container and connected to it, run **Dev Containers:
 
 ### Video: Speed up npm install in a dev container
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/iDdJWIPRUx4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to speed up npm install in a dev container on YouTube (opens in new tab).](images/improve-performance/youtube-iDdJWIPRUx4.jpg)](https://www.youtube.com/watch?v=iDdJWIPRUx4)
 
 ## Use a named volume for your entire source tree
 
diff --git a/remote/advancedcontainers/persist-bash-history.md b/remote/advancedcontainers/persist-bash-history.md
index 8cbb830514..2d163068c0 100644
--- a/remote/advancedcontainers/persist-bash-history.md
+++ b/remote/advancedcontainers/persist-bash-history.md
@@ -67,4 +67,4 @@ Finally, if you've already built the container and connected to it, run **Dev Co
 
 ### Video: How to make your bash history persist in a dev container
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/12nZz-TjoZg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to make your bash history persist in a dev container on YouTube (opens in new tab).](images/persist-bash-history/youtube-12nZz-TjoZg.jpg)](https://www.youtube.com/watch?v=12nZz-TjoZg)
diff --git a/remote/advancedcontainers/start-processes.md b/remote/advancedcontainers/start-processes.md
index 302cfe1e62..c25385e818 100644
--- a/remote/advancedcontainers/start-processes.md
+++ b/remote/advancedcontainers/start-processes.md
@@ -17,7 +17,7 @@ When you are working in a development container, you may want to execute a comma
 
 ### Video: Run npm install when a container is created
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/9qRy_kxVCK8" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to automatically run npm install in a dev container on YouTube (opens in new tab).](images/start-processes/youtube-9qRy_kxVCK8.jpg)](https://www.youtube.com/watch?v=9qRy_kxVCK8)
 
 <br><br>
 
@@ -29,7 +29,7 @@ In other cases, you may want to start up a process and leave it running. This ca
 
 ### Video: Run 'npm start' whenever the container is started
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/zFzPnWgBx_I" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to run a project when a dev container starts on YouTube (opens in new tab).](images/start-processes/youtube-zFzPnWgBx_I.jpg)](https://www.youtube.com/watch?v=zFzPnWgBx_I)
 
 <br><br>
 
@@ -49,7 +49,7 @@ These systems also include a `service` command that will use `systemctl` or `/et
 
 ### Video: Start SSH service in a container
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/KuSNpZgDYDs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+[![Watch How to start the SSH service in a dev container on YouTube (opens in new tab).](images/start-processes/youtube-KuSNpZgDYDs.jpg)](https://www.youtube.com/watch?v=KuSNpZgDYDs)
 
 ## Adding startup commands to the Docker image instead
 

From c6dd1d4a57804e04e2d8852250f2d11b500b1f94 Mon Sep 17 00:00:00 2001
From: Nick Trogh <nicktrog@microsoft.com>
Date: Fri, 4 Sep 2026 13:26:33 +0200
Subject: [PATCH 3/3] Fix video thumbnails for blog posts

---
 .../instructions/docs-writing.instructions.md |   1 +
 blogs/2016/08/15/introvideos.md               |   2 +-
 .../introvideos => }/youtube-LUl_WXt8ohA.jpg  |   0
 blogs/2017/11/15/live-share.md                |   2 +-
 .../video-introducing-live-share.jpg          |   0
 blogs/2018/12/04/rich-navigation.md           |   2 +-
 .../youtube-DAqDEi0fGco.jpg                   |   0
 blogs/2019/05/02/remote-development.md        |   6 +-
 .../youtube-TVcoGLL6Smo.jpg                   |   0
 .../youtube-mIHprjsSO9o.jpg                   |   0
 .../youtube-rh1Ag41J6IA.jpg                   |   0
 blogs/2020/05/06/github-issues-integration.md |   2 +-
 .../youtube-T6sW1Dk9B4E.jpg                   |   0
 blogs/2021/06/02/build-2021.md                |  14 +-
 .../build-2021 => }/youtube-DyKYB76SDx0.jpg   |   0
 .../build-2021 => }/youtube-EWYYgEkGJfs.jpg   |   0
 .../build-2021 => }/youtube-Jk708pQJSyk.jpg   |   0
 .../build-2021 => }/youtube-WyAikmxLlhs.jpg   |   0
 .../build-2021 => }/youtube-eKJftIqv8Uo.jpg   |   0
 .../build-2021 => }/youtube-jN2INtCLRTo.jpg   |   0
 .../build-2021 => }/youtube-wiUzCG_mEGo.jpg   |   0
 blogs/2021/11/08/custom-notebooks.md          |   2 +-
 .../youtube-D-AXZZDTQhM.jpg                   |   0
 blogs/2024/12/18/free-github-copilot.md       |   2 +-
 .../youtube-MLWlWrRAb4w.jpg                   |   0
 blogs/2025/05/12/agent-mode-meets-mcp.md      |   2 +-
 .../youtube-VePxCcF99w4.jpg                   |   0
 blogs/2025/05/27/ai-and-remote.md             |   2 +-
 .../youtube-ErYP9LRo7e0.jpg                   |   0
 blogs/2025/10/22/bring-your-own-key.md        |   2 +-
 .../youtube-xXFTlPZJJoo.jpg                   |   0
 blogs/2025/11/18/PrivateMarketplace.md        |   2 +-
 .../youtube-nQLdmy50cb0.jpg                   |   0
 blogs/2026/01/26/mcp-apps-support.md          |   2 +-
 .../youtube-fbNH6_jdwQU.jpg                   |   0
 blogs/2026/02/05/multi-agent-development.md   |   2 +-
 .../youtube-BsAHunfVwNs.jpg                   |   0
 .../2026/03/13/how-VS-Code-Builds-with-AI.md  |   2 +-
 .../youtube-ee-obY-4rqk.jpg                   |   0
 blogs/2026/06/18/byok-vscode.md               |   2 +-
 .../byok-vscode => }/youtube-EB7dQv1ALCU.jpg  |   0
 blogs/2026/08/26/agent-host-architecture.md   |   2 +-
 .../youtube-k91ejc3G1YM.jpg                   |   0
 build/replace-youtube-embeds.js               |  19 ++-
 build/replace-youtube-embeds.test.js          |  25 +++
 docs/enterprise/policies.md                   | 151 ++++++++++--------
 docs/metadata.json                            |  64 +++++---
 47 files changed, 193 insertions(+), 117 deletions(-)
 rename blogs/2016/08/15/{images/introvideos => }/youtube-LUl_WXt8ohA.jpg (100%)
 rename blogs/2017/11/15/{images/live-share => }/video-introducing-live-share.jpg (100%)
 rename blogs/2018/12/04/{images/rich-navigation => }/youtube-DAqDEi0fGco.jpg (100%)
 rename blogs/2019/05/02/{images/remote-development => }/youtube-TVcoGLL6Smo.jpg (100%)
 rename blogs/2019/05/02/{images/remote-development => }/youtube-mIHprjsSO9o.jpg (100%)
 rename blogs/2019/05/02/{images/remote-development => }/youtube-rh1Ag41J6IA.jpg (100%)
 rename blogs/2020/05/06/{images/github-issues-integration => }/youtube-T6sW1Dk9B4E.jpg (100%)
 rename blogs/2021/06/02/{images/build-2021 => }/youtube-DyKYB76SDx0.jpg (100%)
 rename blogs/2021/06/02/{images/build-2021 => }/youtube-EWYYgEkGJfs.jpg (100%)
 rename blogs/2021/06/02/{images/build-2021 => }/youtube-Jk708pQJSyk.jpg (100%)
 rename blogs/2021/06/02/{images/build-2021 => }/youtube-WyAikmxLlhs.jpg (100%)
 rename blogs/2021/06/02/{images/build-2021 => }/youtube-eKJftIqv8Uo.jpg (100%)
 rename blogs/2021/06/02/{images/build-2021 => }/youtube-jN2INtCLRTo.jpg (100%)
 rename blogs/2021/06/02/{images/build-2021 => }/youtube-wiUzCG_mEGo.jpg (100%)
 rename blogs/2021/11/08/{images/custom-notebooks => }/youtube-D-AXZZDTQhM.jpg (100%)
 rename blogs/2024/12/18/{images/free-github-copilot => }/youtube-MLWlWrRAb4w.jpg (100%)
 rename blogs/2025/05/12/{images/agent-mode-meets-mcp => }/youtube-VePxCcF99w4.jpg (100%)
 rename blogs/2025/05/27/{images/ai-and-remote => }/youtube-ErYP9LRo7e0.jpg (100%)
 rename blogs/2025/10/22/{images/bring-your-own-key => }/youtube-xXFTlPZJJoo.jpg (100%)
 rename blogs/2025/11/18/{images/PrivateMarketplace => }/youtube-nQLdmy50cb0.jpg (100%)
 rename blogs/2026/01/26/{images/mcp-apps-support => }/youtube-fbNH6_jdwQU.jpg (100%)
 rename blogs/2026/02/05/{images/multi-agent-development => }/youtube-BsAHunfVwNs.jpg (100%)
 rename blogs/2026/03/13/{images/how-VS-Code-Builds-with-AI => }/youtube-ee-obY-4rqk.jpg (100%)
 rename blogs/2026/06/18/{images/byok-vscode => }/youtube-EB7dQv1ALCU.jpg (100%)
 rename blogs/2026/08/26/{images/agent-host-architecture => }/youtube-k91ejc3G1YM.jpg (100%)

diff --git a/.github/instructions/docs-writing.instructions.md b/.github/instructions/docs-writing.instructions.md
index d9cb5b984d..0eb007bc37 100644
--- a/.github/instructions/docs-writing.instructions.md
+++ b/.github/instructions/docs-writing.instructions.md
@@ -119,6 +119,7 @@ Use the agreed framing to guide the plan, scope, structure, terminology, prerequ
 * Use videos only when they add value.
 * Videos have a descriptive and meaningful title that starts with "Video showing" or "Video of" and ends with ".".
 * Do not embed YouTube videos with an `iframe`. Use linked-image Markdown with a locally stored thumbnail. The site automatically opens external Markdown links in a new tab.
+* Store blog post thumbnails alongside the Markdown file. For other content, store them in `images/<article-name>/`.
 * The thumbnail alt text is the link's accessible name. It must identify the video and announce that the link opens in a new tab, for example `[![Watch <video description> on YouTube (opens in new tab).](<thumbnail-path>)](<youtube-url>)`.
 * To migrate existing YouTube iframe embeds, run `npm run replace-youtube-embeds -- --write <file-or-directory>`. Omit `--write` to preview the migration.
 
diff --git a/blogs/2016/08/15/introvideos.md b/blogs/2016/08/15/introvideos.md
index b675954248..e5ab7a91fe 100644
--- a/blogs/2016/08/15/introvideos.md
+++ b/blogs/2016/08/15/introvideos.md
@@ -24,7 +24,7 @@ Navigate to [Intro Videos - Overview](/docs/getstarted/introvideos.md) to get st
 
 Below is the first video covering downloading, installing, and the basics of using VS Code:
 
-[![Watch Welcome to VS Code on YouTube (opens in new tab).](images/introvideos/youtube-LUl_WXt8ohA.jpg)](https://www.youtube.com/watch?v=LUl_WXt8ohA)
+[![Watch Welcome to VS Code on YouTube (opens in new tab).](youtube-LUl_WXt8ohA.jpg)](https://www.youtube.com/watch?v=LUl_WXt8ohA)
 
 You can see the video outline [here](/docs/introvideos/basics.md) as well as additional introductory learning resources.
 
diff --git a/blogs/2016/08/15/images/introvideos/youtube-LUl_WXt8ohA.jpg b/blogs/2016/08/15/youtube-LUl_WXt8ohA.jpg
similarity index 100%
rename from blogs/2016/08/15/images/introvideos/youtube-LUl_WXt8ohA.jpg
rename to blogs/2016/08/15/youtube-LUl_WXt8ohA.jpg
diff --git a/blogs/2017/11/15/live-share.md b/blogs/2017/11/15/live-share.md
index c85c015876..bd35a74c65 100755
--- a/blogs/2017/11/15/live-share.md
+++ b/blogs/2017/11/15/live-share.md
@@ -21,7 +21,7 @@ Live Share enables your team to quickly collaborate on the same codebase without
 
 When it comes to Live Share, seeing is believing.  Watch the following video to get an idea of what we are working on:
 
-[![Watch Introducing Visual Studio Live Share on Microsoft Learn (opens in new tab).](images/live-share/video-introducing-live-share.jpg)](https://learn.microsoft.com/shows/visual-studio-connect-event-2017/t254)
+[![Watch Introducing Visual Studio Live Share on Microsoft Learn (opens in new tab).](video-introducing-live-share.jpg)](https://learn.microsoft.com/shows/visual-studio-connect-event-2017/t254)
 
 When you share a collaborative session, your teammate sees the context of the workspace in their editor. This means your teammate can read the code you shared without having to clone a repo or install any dependencies your code relies on. They can use rich language features to navigate within the code; not only just opening other files as text but using semantic analysis-based navigation like Go to Definition or Peek.
 
diff --git a/blogs/2017/11/15/images/live-share/video-introducing-live-share.jpg b/blogs/2017/11/15/video-introducing-live-share.jpg
similarity index 100%
rename from blogs/2017/11/15/images/live-share/video-introducing-live-share.jpg
rename to blogs/2017/11/15/video-introducing-live-share.jpg
diff --git a/blogs/2018/12/04/rich-navigation.md b/blogs/2018/12/04/rich-navigation.md
index 33227fbc83..6e571bf159 100644
--- a/blogs/2018/12/04/rich-navigation.md
+++ b/blogs/2018/12/04/rich-navigation.md
@@ -15,7 +15,7 @@ Pull requests are a critical collaboration tool for millions of developers every
 
 In September, along with GitHub, [we announced the GitHub Pull Requests extension](https://code.visualstudio.com/blogs/2018/09/10/introducing-github-pullrequests), which enabled developers to review source code in the same place they write it: inside their familiar and highly-customized editor. Today, we're excited to share a sneak peek of a new experience that will further enhance in-editor PR reviews with support for **rich, multi-repository code navigations**.
 
-[![Watch First look at a rich code navigation experience on YouTube (opens in new tab).](images/rich-navigation/youtube-DAqDEi0fGco.jpg)](https://www.youtube.com/watch?v=DAqDEi0fGco)
+[![Watch First look at a rich code navigation experience on YouTube (opens in new tab).](youtube-DAqDEi0fGco.jpg)](https://www.youtube.com/watch?v=DAqDEi0fGco)
 
 ## Say goodbye to superficial reviews
 
diff --git a/blogs/2018/12/04/images/rich-navigation/youtube-DAqDEi0fGco.jpg b/blogs/2018/12/04/youtube-DAqDEi0fGco.jpg
similarity index 100%
rename from blogs/2018/12/04/images/rich-navigation/youtube-DAqDEi0fGco.jpg
rename to blogs/2018/12/04/youtube-DAqDEi0fGco.jpg
diff --git a/blogs/2019/05/02/remote-development.md b/blogs/2019/05/02/remote-development.md
index e0597fdf03..d401d6b56a 100644
--- a/blogs/2019/05/02/remote-development.md
+++ b/blogs/2019/05/02/remote-development.md
@@ -78,7 +78,7 @@ Commands and extensions are run directly in the Linux distro, so you don't have
 
 Check out this quick, 2-minute video to see how easy it is to develop in WSL.
 
-[![Watch Visual Studio Code WSL on YouTube (opens in new tab).](images/remote-development/youtube-mIHprjsSO9o.jpg)](https://www.youtube.com/watch?v=mIHprjsSO9o)
+[![Watch Visual Studio Code WSL on YouTube (opens in new tab).](youtube-mIHprjsSO9o.jpg)](https://www.youtube.com/watch?v=mIHprjsSO9o)
 
 For more information, please see the [Developing in WSL](https://aka.ms/vscode-remote/wsl) documentation.
 
@@ -96,7 +96,7 @@ You could use Vim over SSH or Jupyter Notebooks to edit your remote code, but yo
 
 Check out this quick, 2-minute video to see how easy it is to develop on a virtual machine over SSH.
 
-[![Watch Visual Studio Code Remote - SSH on YouTube (opens in new tab).](images/remote-development/youtube-rh1Ag41J6IA.jpg)](https://www.youtube.com/watch?v=rh1Ag41J6IA)
+[![Watch Visual Studio Code Remote - SSH on YouTube (opens in new tab).](youtube-rh1Ag41J6IA.jpg)](https://www.youtube.com/watch?v=rh1Ag41J6IA)
 
 For more information, please see the [Developing using SSH](https://aka.ms/vscode-remote/ssh) documentation.
 
@@ -112,7 +112,7 @@ A `devcontainer.json` file can be used to tell VS Code how to configure the deve
 
 Check out this quick, 2-minute video to see Development Containers in action.
 
-[![Watch Visual Studio Code Dev Containers on YouTube (opens in new tab).](images/remote-development/youtube-TVcoGLL6Smo.jpg)](https://www.youtube.com/watch?v=TVcoGLL6Smo)
+[![Watch Visual Studio Code Dev Containers on YouTube (opens in new tab).](youtube-TVcoGLL6Smo.jpg)](https://www.youtube.com/watch?v=TVcoGLL6Smo)
 
 For more information on development containers, please see the [Developing inside a Container](https://aka.ms/vscode-remote/containers) documentation as well as the [vscode-remote-try-* repositories](https://github.com/search?q=org%3AMicrosoft+vscode-remote-try-&unscoped_q=vscode-remote-try-) that contain samples you can use today.
 
diff --git a/blogs/2019/05/02/images/remote-development/youtube-TVcoGLL6Smo.jpg b/blogs/2019/05/02/youtube-TVcoGLL6Smo.jpg
similarity index 100%
rename from blogs/2019/05/02/images/remote-development/youtube-TVcoGLL6Smo.jpg
rename to blogs/2019/05/02/youtube-TVcoGLL6Smo.jpg
diff --git a/blogs/2019/05/02/images/remote-development/youtube-mIHprjsSO9o.jpg b/blogs/2019/05/02/youtube-mIHprjsSO9o.jpg
similarity index 100%
rename from blogs/2019/05/02/images/remote-development/youtube-mIHprjsSO9o.jpg
rename to blogs/2019/05/02/youtube-mIHprjsSO9o.jpg
diff --git a/blogs/2019/05/02/images/remote-development/youtube-rh1Ag41J6IA.jpg b/blogs/2019/05/02/youtube-rh1Ag41J6IA.jpg
similarity index 100%
rename from blogs/2019/05/02/images/remote-development/youtube-rh1Ag41J6IA.jpg
rename to blogs/2019/05/02/youtube-rh1Ag41J6IA.jpg
diff --git a/blogs/2020/05/06/github-issues-integration.md b/blogs/2020/05/06/github-issues-integration.md
index 98ea930f0a..57d4e55730 100644
--- a/blogs/2020/05/06/github-issues-integration.md
+++ b/blogs/2020/05/06/github-issues-integration.md
@@ -59,7 +59,7 @@ To fit more workflows, there are several options you can configure. If your flow
 
 You can watch this **What every GitHub user should know about VS Code** talk from [GitHub Satellite](https://githubsatellite.com) by Sana Ajani, [@sana_ajani](https://twitter.com/sana_ajani), and Burke Holland, [@burkeholland](https://twitter.com/burkeholland).
 
-[![Watch What every GitHub user should know about VS Code on YouTube (opens in new tab).](images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg)](https://www.youtube.com/watch?v=T6sW1Dk9B4E)
+[![Watch What every GitHub user should know about VS Code on YouTube (opens in new tab).](youtube-T6sW1Dk9B4E.jpg)](https://www.youtube.com/watch?v=T6sW1Dk9B4E)
 
 ---
 
diff --git a/blogs/2020/05/06/images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg b/blogs/2020/05/06/youtube-T6sW1Dk9B4E.jpg
similarity index 100%
rename from blogs/2020/05/06/images/github-issues-integration/youtube-T6sW1Dk9B4E.jpg
rename to blogs/2020/05/06/youtube-T6sW1Dk9B4E.jpg
diff --git a/blogs/2021/06/02/build-2021.md b/blogs/2021/06/02/build-2021.md
index b7282952e8..b616c22935 100644
--- a/blogs/2021/06/02/build-2021.md
+++ b/blogs/2021/06/02/build-2021.md
@@ -25,13 +25,13 @@ Among all the sessions that were presented, here is a hand-picked selection for
 
 Join Sana Ajani and Jeffrey Mew for some of the newest features of VS Code, including new debugging and testing features, custom notebooks, better support for Python, PyTorch, and Jupyter Notebooks.
 
-[![Watch What's new in Visual Studio Code | BRK212 on YouTube (opens in new tab).](images/build-2021/youtube-eKJftIqv8Uo.jpg)](https://www.youtube.com/watch?v=eKJftIqv8Uo)
+[![Watch What's new in Visual Studio Code | BRK212 on YouTube (opens in new tab).](youtube-eKJftIqv8Uo.jpg)](https://www.youtube.com/watch?v=eKJftIqv8Uo)
 
 ### Application development with Scott Hanselman & friends
 
 Why did this "not a keynote" keynote get so many rave reviews? Find out for yourself, and learn about what's new for developers from Microsoft, including with VS Code: custom notebooks, GitHub integration, GitHub Codespaces, and more.
 
-[![Watch Application Development with Scott Hanselman & Friends | KEY11D on YouTube (opens in new tab).](images/build-2021/youtube-EWYYgEkGJfs.jpg)](https://www.youtube.com/watch?v=EWYYgEkGJfs)
+[![Watch Application Development with Scott Hanselman & Friends | KEY11D on YouTube (opens in new tab).](youtube-EWYYgEkGJfs.jpg)](https://www.youtube.com/watch?v=EWYYgEkGJfs)
 
 ### What's new with TypeScript
 
@@ -51,13 +51,13 @@ VS Code developer Christof Marti gives a brief demo of developing in a container
 
 [Dapr](https://dapr.io/) is a distributed application runtime to build microservice-based apps and works with any programming language. Check out Dapr and how it is used with VS Code.
 
-[![Watch Microservices made easy with Dapr | OD521 on YouTube (opens in new tab).](images/build-2021/youtube-DyKYB76SDx0.jpg)](https://www.youtube.com/watch?v=DyKYB76SDx0)
+[![Watch Microservices made easy with Dapr | OD521 on YouTube (opens in new tab).](youtube-DyKYB76SDx0.jpg)](https://www.youtube.com/watch?v=DyKYB76SDx0)
 
 ### Build cloud-native applications that run anywhere
 
 Use VS Code and Azure to build, debug, and run serverless or containerized apps.
 
-[![Watch Build cloud-native applications that run anywhere | TS03 on YouTube (opens in new tab).](images/build-2021/youtube-jN2INtCLRTo.jpg)](https://www.youtube.com/watch?v=jN2INtCLRTo)
+[![Watch Build cloud-native applications that run anywhere | TS03 on YouTube (opens in new tab).](youtube-jN2INtCLRTo.jpg)](https://www.youtube.com/watch?v=jN2INtCLRTo)
 
 ## Learn new skills
 
@@ -67,19 +67,19 @@ This year's Build had a large "student zone", for beginners and perennial learne
 
 Learn how VS Code and GitHub can help student and beginning programmers learn to code. Hosted by Sana Ajani, from the VS Code team, and Meaghan Lewis.
 
-[![Watch Core tools for a dev career: an introduction to Visual Studio Code and GitHub | CON068 on YouTube (opens in new tab).](images/build-2021/youtube-Jk708pQJSyk.jpg)](https://www.youtube.com/watch?v=Jk708pQJSyk)
+[![Watch Core tools for a dev career: an introduction to Visual Studio Code and GitHub | CON068 on YouTube (opens in new tab).](youtube-Jk708pQJSyk.jpg)](https://www.youtube.com/watch?v=Jk708pQJSyk)
 
 ### The art of artificial intelligence: creating images with Python and Azure
 
 Learn how to use AI to generate images and photos, with Python and Jupyter Notebooks in VS Code.
 
-[![Watch The art of artificial intelligence: creating images with Python and Azure | CON070 on YouTube (opens in new tab).](images/build-2021/youtube-WyAikmxLlhs.jpg)](https://www.youtube.com/watch?v=WyAikmxLlhs)
+[![Watch The art of artificial intelligence: creating images with Python and Azure | CON070 on YouTube (opens in new tab).](youtube-WyAikmxLlhs.jpg)](https://www.youtube.com/watch?v=WyAikmxLlhs)
 
 ### Get started with popular programming languages: Intro to Python and C#
 
 James Montemagno and Christopher Harrison offer a beginner-friendly introduction to programming in C# and Python, and of course using VS Code.
 
-[![Watch Get started with popular programming languages: Intro to Python and C# | CON069 on YouTube (opens in new tab).](images/build-2021/youtube-wiUzCG_mEGo.jpg)](https://www.youtube.com/watch?v=wiUzCG_mEGo)
+[![Watch Get started with popular programming languages: Intro to Python and C# | CON069 on YouTube (opens in new tab).](youtube-wiUzCG_mEGo.jpg)](https://www.youtube.com/watch?v=wiUzCG_mEGo)
 
 ## Reach out
 
diff --git a/blogs/2021/06/02/images/build-2021/youtube-DyKYB76SDx0.jpg b/blogs/2021/06/02/youtube-DyKYB76SDx0.jpg
similarity index 100%
rename from blogs/2021/06/02/images/build-2021/youtube-DyKYB76SDx0.jpg
rename to blogs/2021/06/02/youtube-DyKYB76SDx0.jpg
diff --git a/blogs/2021/06/02/images/build-2021/youtube-EWYYgEkGJfs.jpg b/blogs/2021/06/02/youtube-EWYYgEkGJfs.jpg
similarity index 100%
rename from blogs/2021/06/02/images/build-2021/youtube-EWYYgEkGJfs.jpg
rename to blogs/2021/06/02/youtube-EWYYgEkGJfs.jpg
diff --git a/blogs/2021/06/02/images/build-2021/youtube-Jk708pQJSyk.jpg b/blogs/2021/06/02/youtube-Jk708pQJSyk.jpg
similarity index 100%
rename from blogs/2021/06/02/images/build-2021/youtube-Jk708pQJSyk.jpg
rename to blogs/2021/06/02/youtube-Jk708pQJSyk.jpg
diff --git a/blogs/2021/06/02/images/build-2021/youtube-WyAikmxLlhs.jpg b/blogs/2021/06/02/youtube-WyAikmxLlhs.jpg
similarity index 100%
rename from blogs/2021/06/02/images/build-2021/youtube-WyAikmxLlhs.jpg
rename to blogs/2021/06/02/youtube-WyAikmxLlhs.jpg
diff --git a/blogs/2021/06/02/images/build-2021/youtube-eKJftIqv8Uo.jpg b/blogs/2021/06/02/youtube-eKJftIqv8Uo.jpg
similarity index 100%
rename from blogs/2021/06/02/images/build-2021/youtube-eKJftIqv8Uo.jpg
rename to blogs/2021/06/02/youtube-eKJftIqv8Uo.jpg
diff --git a/blogs/2021/06/02/images/build-2021/youtube-jN2INtCLRTo.jpg b/blogs/2021/06/02/youtube-jN2INtCLRTo.jpg
similarity index 100%
rename from blogs/2021/06/02/images/build-2021/youtube-jN2INtCLRTo.jpg
rename to blogs/2021/06/02/youtube-jN2INtCLRTo.jpg
diff --git a/blogs/2021/06/02/images/build-2021/youtube-wiUzCG_mEGo.jpg b/blogs/2021/06/02/youtube-wiUzCG_mEGo.jpg
similarity index 100%
rename from blogs/2021/06/02/images/build-2021/youtube-wiUzCG_mEGo.jpg
rename to blogs/2021/06/02/youtube-wiUzCG_mEGo.jpg
diff --git a/blogs/2021/11/08/custom-notebooks.md b/blogs/2021/11/08/custom-notebooks.md
index 065de0c8a4..2adb45afe3 100644
--- a/blogs/2021/11/08/custom-notebooks.md
+++ b/blogs/2021/11/08/custom-notebooks.md
@@ -74,7 +74,7 @@ For both of these notebooks, it was great to have the VS Code Notebook UI to cre
 
 The VS Code team recorded a livestream several months ago about custom notebooks and in it, I showcased in a live coding demo of what it's like to create a custom notebook extension. You can watch it on YouTube: [VS Code Notebooks: A Deep Dive](https://youtu.be/D-AXZZDTQhM). Some of the Notebook APIs have changed since the video was published but the principles are still the same.
 
-[![Watch VS Code Notebooks: A Deep Dive on YouTube (opens in new tab).](images/custom-notebooks/youtube-D-AXZZDTQhM.jpg)](https://www.youtube.com/watch?v=D-AXZZDTQhM)
+[![Watch VS Code Notebooks: A Deep Dive on YouTube (opens in new tab).](youtube-D-AXZZDTQhM.jpg)](https://www.youtube.com/watch?v=D-AXZZDTQhM)
 
 For the most up to date and detailed information when you're ready to build your own notebook extension, you can reference the [Notebook extension authors guide](/api/extension-guides/notebook.md).
 
diff --git a/blogs/2021/11/08/images/custom-notebooks/youtube-D-AXZZDTQhM.jpg b/blogs/2021/11/08/youtube-D-AXZZDTQhM.jpg
similarity index 100%
rename from blogs/2021/11/08/images/custom-notebooks/youtube-D-AXZZDTQhM.jpg
rename to blogs/2021/11/08/youtube-D-AXZZDTQhM.jpg
diff --git a/blogs/2024/12/18/free-github-copilot.md b/blogs/2024/12/18/free-github-copilot.md
index e4da8c147b..7f985142dc 100644
--- a/blogs/2024/12/18/free-github-copilot.md
+++ b/blogs/2024/12/18/free-github-copilot.md
@@ -115,7 +115,7 @@ No more commits that say "changes". GitHub Copilot will suggest a commit message
 
 Every VS Code extension can tie directly into the GitHub Copilot APIs and offer a customized AI experience. Check out MongoDB with [their extension](https://marketplace.visualstudio.com/items?itemName=mongodb.mongodb-vscode) that can write impressively complex queries, use fuzzy search and a lot more...
 
-[![Watch VS Code MongoDB extension on YouTube (opens in new tab).](images/free-github-copilot/youtube-MLWlWrRAb4w.jpg)](https://www.youtube.com/watch?v=MLWlWrRAb4w)
+[![Watch VS Code MongoDB extension on YouTube (opens in new tab).](youtube-MLWlWrRAb4w.jpg)](https://www.youtube.com/watch?v=MLWlWrRAb4w)
 
 **Try this:** Build your own extension for GitHub Copilot using GitHub Copilot! We've created some new tutorials that show you how to [build a code tutor chat participant](https://code.visualstudio.com/api/extension-guides/chat-tutorial) or [generate AI-powered code annotations](https://code.visualstudio.com/api/extension-guides/language-model-tutorial).
 
diff --git a/blogs/2024/12/18/images/free-github-copilot/youtube-MLWlWrRAb4w.jpg b/blogs/2024/12/18/youtube-MLWlWrRAb4w.jpg
similarity index 100%
rename from blogs/2024/12/18/images/free-github-copilot/youtube-MLWlWrRAb4w.jpg
rename to blogs/2024/12/18/youtube-MLWlWrRAb4w.jpg
diff --git a/blogs/2025/05/12/agent-mode-meets-mcp.md b/blogs/2025/05/12/agent-mode-meets-mcp.md
index 1d00bc8ad8..d2414b4a3d 100644
--- a/blogs/2025/05/12/agent-mode-meets-mcp.md
+++ b/blogs/2025/05/12/agent-mode-meets-mcp.md
@@ -16,7 +16,7 @@ When we first introduced [agent mode](https://code.visualstudio.com/docs/agents/
 
 Our first attempt followed the familiar VS Code pattern: extensibility through the [Tools](https://code.visualstudio.com/api/extension-guides/tools) and [Chat participants](https://code.visualstudio.com/api/extension-guides/chat) APIs. This made sense given the thousands of extensions already in the ecosystem, but the industry was moving quickly toward a new standard: the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP). MCP is best understood as a protocol for connecting AI agents to a wide range of external tools and services in a consistent way, much like how HTTP standardized communication for the web. The goal is to let any client, not just VS Code, plug in powerful tool servers like databases, code search, and deployment systems, and have them “just work.”
 
-[![Watch Agent mode tools in VS Code on YouTube (opens in new tab).](images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg)](https://www.youtube.com/watch?v=VePxCcF99w4)
+[![Watch Agent mode tools in VS Code on YouTube (opens in new tab).](youtube-VePxCcF99w4.jpg)](https://www.youtube.com/watch?v=VePxCcF99w4)
 
 This shift to MCP unlocked a wider ecosystem almost overnight. Now, VS Code users can take advantage of servers like [Playwright MCP Server](https://github.com/microsoft/playwright-mcp) for frontend verification, [GitHub MCP Server](https://github.com/github/github-mcp-server/) for repository insights and pull requests, or [Context7](https://github.com/upstash/context7/) for smarter API usage. The [list of servers](https://github.com/modelcontextprotocol/servers) continues to grow, and MCP has quickly become a foundation for bringing additional capabilities across AI agents.
 
diff --git a/blogs/2025/05/12/images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg b/blogs/2025/05/12/youtube-VePxCcF99w4.jpg
similarity index 100%
rename from blogs/2025/05/12/images/agent-mode-meets-mcp/youtube-VePxCcF99w4.jpg
rename to blogs/2025/05/12/youtube-VePxCcF99w4.jpg
diff --git a/blogs/2025/05/27/ai-and-remote.md b/blogs/2025/05/27/ai-and-remote.md
index d4246f3fbf..3997693aa4 100644
--- a/blogs/2025/05/27/ai-and-remote.md
+++ b/blogs/2025/05/27/ai-and-remote.md
@@ -18,7 +18,7 @@ Now combine those capabilities with the flexibility and power of AI in VS Code,
 
 In this blog, we'll explore how your existing remote setups can be enhanced to "just work" with AI, along with some more customized AI + remote workflows that include custom instructions, chat participants, and agent auto-approvals.
 
-[![Watch AI and Remote Development in VS Code on YouTube (opens in new tab).](images/ai-and-remote/youtube-ErYP9LRo7e0.jpg)](https://www.youtube.com/watch?v=ErYP9LRo7e0)
+[![Watch AI and Remote Development in VS Code on YouTube (opens in new tab).](youtube-ErYP9LRo7e0.jpg)](https://www.youtube.com/watch?v=ErYP9LRo7e0)
 
 ## What is Remote Development?
 
diff --git a/blogs/2025/05/27/images/ai-and-remote/youtube-ErYP9LRo7e0.jpg b/blogs/2025/05/27/youtube-ErYP9LRo7e0.jpg
similarity index 100%
rename from blogs/2025/05/27/images/ai-and-remote/youtube-ErYP9LRo7e0.jpg
rename to blogs/2025/05/27/youtube-ErYP9LRo7e0.jpg
diff --git a/blogs/2025/10/22/bring-your-own-key.md b/blogs/2025/10/22/bring-your-own-key.md
index 0cfef81683..24f52d4a2c 100644
--- a/blogs/2025/10/22/bring-your-own-key.md
+++ b/blogs/2025/10/22/bring-your-own-key.md
@@ -18,7 +18,7 @@ In March, we released the [bring your own key (BYOK)](https://code.visualstudio.
 
 Now, we're taking BYOK to the next level. In the [v1.104 release](https://code.visualstudio.com/updates/v1_104), we introduced the [Language Model Chat Provider API](https://code.visualstudio.com/api/extension-guides/ai/language-model-chat-provider) that enables model providers to contribute their models directly through VS Code extensions.
 
-[![Watch BYOK in VS Code on YouTube (opens in new tab).](images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg)](https://www.youtube.com/watch?v=xXFTlPZJJoo)
+[![Watch BYOK in VS Code on YouTube (opens in new tab).](youtube-xXFTlPZJJoo.jpg)](https://www.youtube.com/watch?v=xXFTlPZJJoo)
 
 
 ## What is Bring Your Own Key (BYOK)?
diff --git a/blogs/2025/10/22/images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg b/blogs/2025/10/22/youtube-xXFTlPZJJoo.jpg
similarity index 100%
rename from blogs/2025/10/22/images/bring-your-own-key/youtube-xXFTlPZJJoo.jpg
rename to blogs/2025/10/22/youtube-xXFTlPZJJoo.jpg
diff --git a/blogs/2025/11/18/PrivateMarketplace.md b/blogs/2025/11/18/PrivateMarketplace.md
index e18affa63a..793ecf29e5 100644
--- a/blogs/2025/11/18/PrivateMarketplace.md
+++ b/blogs/2025/11/18/PrivateMarketplace.md
@@ -14,7 +14,7 @@ November 18, 2025 by [Sean Iyer](https://x.com/nuget)
 
 Developers shouldn't have to juggle manual installs, worry about unverified extensions, or chase compliance exceptions just to get their favorite tools. Today, we're excited to announce Private Marketplace for VS Code—a dedicated, enterprise-ready hub that puts you in full control of how extensions are sourced, reviewed, and distributed to your dev teams. 🔐✨
 
-[![Watch Video showing the VS Code private marketplace on YouTube (opens in new tab).](images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg)](https://www.youtube.com/watch?v=nQLdmy50cb0)
+[![Watch Video showing the VS Code private marketplace on YouTube (opens in new tab).](youtube-nQLdmy50cb0.jpg)](https://www.youtube.com/watch?v=nQLdmy50cb0)
 
 ## With the Private Marketplace, you can:
 
diff --git a/blogs/2025/11/18/images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg b/blogs/2025/11/18/youtube-nQLdmy50cb0.jpg
similarity index 100%
rename from blogs/2025/11/18/images/PrivateMarketplace/youtube-nQLdmy50cb0.jpg
rename to blogs/2025/11/18/youtube-nQLdmy50cb0.jpg
diff --git a/blogs/2026/01/26/mcp-apps-support.md b/blogs/2026/01/26/mcp-apps-support.md
index 910506ba7e..e1c796ae1a 100644
--- a/blogs/2026/01/26/mcp-apps-support.md
+++ b/blogs/2026/01/26/mcp-apps-support.md
@@ -52,7 +52,7 @@ We've built a few [demos](https://github.com/digitarald/mcp-apps-playground) to
 
 [Storybook](https://storybook.js.org) has [added MCP Apps support](https://github.com/storybookjs/mcp/pull/134) to their open source MCP server. Simply ask an agent to *"build a login form using our design system"* instead of describing the desired result in extensive detail, and the agent renders an interactive component preview directly in VS Code.
 
-[![Watch Storybook MCP Apps demo on YouTube (opens in new tab).](images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg)](https://www.youtube.com/watch?v=fbNH6_jdwQU)
+[![Watch Storybook MCP Apps demo on YouTube (opens in new tab).](youtube-fbNH6_jdwQU.jpg)](https://www.youtube.com/watch?v=fbNH6_jdwQU)
 
 > "We've been working with the VS Code team on MCP Apps and we're excited about the results. Users can now preview Storybook stories directly in the agent chat, eliminating the need to navigate between the chat and their Storybook to review changes." – Jeppe Reinhold (Storybook core contributor, Chromatic)
 
diff --git a/blogs/2026/01/26/images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg b/blogs/2026/01/26/youtube-fbNH6_jdwQU.jpg
similarity index 100%
rename from blogs/2026/01/26/images/mcp-apps-support/youtube-fbNH6_jdwQU.jpg
rename to blogs/2026/01/26/youtube-fbNH6_jdwQU.jpg
diff --git a/blogs/2026/02/05/multi-agent-development.md b/blogs/2026/02/05/multi-agent-development.md
index 0e8216fdb6..ee8964c104 100644
--- a/blogs/2026/02/05/multi-agent-development.md
+++ b/blogs/2026/02/05/multi-agent-development.md
@@ -24,7 +24,7 @@ The Agent Sessions view gives you one place to see all your agent sessions—loc
 
 Kick off a cloud agent for a well-defined refactor, then jump into a local session for something more exploratory. Monitor a background task or let it run as you work on something else.
 
-[![Watch Video showing the unified agent experience on YouTube (opens in new tab).](images/multi-agent-development/youtube-BsAHunfVwNs.jpg)](https://www.youtube.com/watch?v=BsAHunfVwNs)
+[![Watch Video showing the unified agent experience on YouTube (opens in new tab).](youtube-BsAHunfVwNs.jpg)](https://www.youtube.com/watch?v=BsAHunfVwNs)
 
 The above demo illustrates how developers are constantly tackling multiple things at once: planning improvements, building features, reviewing results, debugging errors. For each moment, you need to pick the right tool: local when needing to steer, background or cloud when wanting isolated changes, parallel subagents when needing multiple processes.
 
diff --git a/blogs/2026/02/05/images/multi-agent-development/youtube-BsAHunfVwNs.jpg b/blogs/2026/02/05/youtube-BsAHunfVwNs.jpg
similarity index 100%
rename from blogs/2026/02/05/images/multi-agent-development/youtube-BsAHunfVwNs.jpg
rename to blogs/2026/02/05/youtube-BsAHunfVwNs.jpg
diff --git a/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md b/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md
index 1ff764777b..7f161ad8b1 100644
--- a/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md
+++ b/blogs/2026/03/13/how-VS-Code-Builds-with-AI.md
@@ -16,7 +16,7 @@ We use AI every day to ship VS Code. It's made us so much faster that, after ten
 
 To kick off [Agent Sessions Day](https://youtube.com/live/tAezuMSJuFs), I sat down with Peng Lyu, Engineering Manager on the VS Code team, to walk through how the VS Code team actually uses AI for our day-to-day work. Not only for implementing features (that part's self-evident), but for everything *around* building features: triage, code review, release notes, validation, staying productive in a meeting-heavy schedule.
 
-[![Watch Agent Sessions Day: How VS Code Builds with AI on YouTube (opens in new tab).](images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg)](https://www.youtube.com/watch?v=ee-obY-4rqk)
+[![Watch Agent Sessions Day: How VS Code Builds with AI on YouTube (opens in new tab).](youtube-ee-obY-4rqk.jpg)](https://www.youtube.com/watch?v=ee-obY-4rqk)
 
 In that session, we probably only covered 5% of what the team does with agents on any given day. But it's representative of how a product that's used by millions of developers is built. So, we wanted to share more about these big recent changes to our workflow, and where we think we're going next.
 
diff --git a/blogs/2026/03/13/images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg b/blogs/2026/03/13/youtube-ee-obY-4rqk.jpg
similarity index 100%
rename from blogs/2026/03/13/images/how-VS-Code-Builds-with-AI/youtube-ee-obY-4rqk.jpg
rename to blogs/2026/03/13/youtube-ee-obY-4rqk.jpg
diff --git a/blogs/2026/06/18/byok-vscode.md b/blogs/2026/06/18/byok-vscode.md
index 84585eaa64..01face9d8a 100644
--- a/blogs/2026/06/18/byok-vscode.md
+++ b/blogs/2026/06/18/byok-vscode.md
@@ -145,7 +145,7 @@ To learn more, check out the VS Code docs on [AI language models](https://code.v
 
 We also have a video for how to [Bring Your Own AI... No Sign-In Required!](https://www.youtube.com/watch?v=EB7dQv1ALCU).
 
-[![Watch Bring Your Own AI... No Sign-In Required! on YouTube (opens in new tab).](images/byok-vscode/youtube-EB7dQv1ALCU.jpg)](https://www.youtube.com/watch?v=EB7dQv1ALCU)
+[![Watch Bring Your Own AI... No Sign-In Required! on YouTube (opens in new tab).](youtube-EB7dQv1ALCU.jpg)](https://www.youtube.com/watch?v=EB7dQv1ALCU)
 
 We are continuing to improve model choice in VS Code, and your feedback helps shape what comes next. Try BYOK with your workflow and let us know what you think in the [VS Code repository](https://github.com/microsoft/vscode).
 
diff --git a/blogs/2026/06/18/images/byok-vscode/youtube-EB7dQv1ALCU.jpg b/blogs/2026/06/18/youtube-EB7dQv1ALCU.jpg
similarity index 100%
rename from blogs/2026/06/18/images/byok-vscode/youtube-EB7dQv1ALCU.jpg
rename to blogs/2026/06/18/youtube-EB7dQv1ALCU.jpg
diff --git a/blogs/2026/08/26/agent-host-architecture.md b/blogs/2026/08/26/agent-host-architecture.md
index f8d3a6b243..9e63805492 100644
--- a/blogs/2026/08/26/agent-host-architecture.md
+++ b/blogs/2026/08/26/agent-host-architecture.md
@@ -19,7 +19,7 @@ We're introducing the **Agent Host**, a self-contained process that owns agent s
 
 In this post, we'll explain why we built the Agent Host, what it enables in VS Code (and how you can try it), how its architecture works, and how AHP opens that architecture to other clients.
 
-[![Watch Video showing an Agent Host session continuing across folders, VS Code surfaces, and remote connections on YouTube (opens in new tab).](images/agent-host-architecture/youtube-k91ejc3G1YM.jpg)](https://www.youtube.com/watch?v=k91ejc3G1YM)
+[![Watch Video showing an Agent Host session continuing across folders, VS Code surfaces, and remote connections on YouTube (opens in new tab).](youtube-k91ejc3G1YM.jpg)](https://www.youtube.com/watch?v=k91ejc3G1YM)
 
 ## Why we built the Agent Host
 
diff --git a/blogs/2026/08/26/images/agent-host-architecture/youtube-k91ejc3G1YM.jpg b/blogs/2026/08/26/youtube-k91ejc3G1YM.jpg
similarity index 100%
rename from blogs/2026/08/26/images/agent-host-architecture/youtube-k91ejc3G1YM.jpg
rename to blogs/2026/08/26/youtube-k91ejc3G1YM.jpg
diff --git a/build/replace-youtube-embeds.js b/build/replace-youtube-embeds.js
index 02e4644a6f..de985911db 100644
--- a/build/replace-youtube-embeds.js
+++ b/build/replace-youtube-embeds.js
@@ -149,7 +149,12 @@ function parseYouTubeIframe(iframe) {
   };
 }
 
-function getThumbnailPath(markdownPath, videoId) {
+function getThumbnailPath(markdownPath, videoId, root) {
+  const relativeMarkdownPath = path.relative(root || ROOT, path.resolve(markdownPath));
+  if (relativeMarkdownPath.split(path.sep)[0] === 'blogs') {
+    return path.join(path.dirname(markdownPath), `youtube-${videoId}.jpg`);
+  }
+
   const articleName = path.basename(markdownPath, path.extname(markdownPath));
   return path.join(path.dirname(markdownPath), 'images', articleName, `youtube-${videoId}.jpg`);
 }
@@ -199,7 +204,7 @@ function findIframeRanges(content) {
   return ranges;
 }
 
-function analyzeMarkdown(markdownPath, content, titleOverrides) {
+function analyzeMarkdown(markdownPath, content, titleOverrides, root) {
   const embeds = [];
   const issues = [];
   let output = '';
@@ -231,7 +236,7 @@ function analyzeMarkdown(markdownPath, content, titleOverrides) {
       return;
     }
 
-    const imagePath = getThumbnailPath(markdownPath, parsed.videoId);
+    const imagePath = getThumbnailPath(markdownPath, parsed.videoId, root);
     output += content.substring(lastIndex, range.start);
     output += renderLinkedThumbnail(parsed, imagePath, markdownPath);
     lastIndex = range.end;
@@ -440,7 +445,7 @@ function resolveIssueTitles(issues, getBuffer, logger) {
   });
 }
 
-function prepareMigration(files, titleOverrides) {
+function prepareMigration(files, titleOverrides, root) {
   const filePlans = [];
   const downloads = new Map();
   const issues = [];
@@ -448,7 +453,7 @@ function prepareMigration(files, titleOverrides) {
 
   files.forEach(function (file) {
     const originalContent = fs.readFileSync(file, 'utf8');
-    const analysis = analyzeMarkdown(file, originalContent, titleOverrides);
+    const analysis = analyzeMarkdown(file, originalContent, titleOverrides, root);
 
     embedCount += analysis.embeds.length;
     issues.push.apply(issues, analysis.issues);
@@ -598,7 +603,7 @@ function runMigration(options) {
   const logger = options.logger || console.log;
   const root = path.resolve(options.root || ROOT);
   const files = collectMarkdownFiles(options.inputs, root);
-  const initialPlan = prepareMigration(files);
+  const initialPlan = prepareMigration(files, undefined, root);
 
   if (options.write && initialPlan.issues.length > 0) {
     const unresolvableIssues = initialPlan.issues.filter(function (issue) {
@@ -609,7 +614,7 @@ function runMigration(options) {
     }
 
     return resolveIssueTitles(initialPlan.issues, options.getMetadataBuffer, logger).then(function (titles) {
-      return executeMigration(prepareMigration(files, titles), options, files, root, logger);
+      return executeMigration(prepareMigration(files, titles, root), options, files, root, logger);
     });
   }
 
diff --git a/build/replace-youtube-embeds.test.js b/build/replace-youtube-embeds.test.js
index 5d360b14b6..4626aac299 100644
--- a/build/replace-youtube-embeds.test.js
+++ b/build/replace-youtube-embeds.test.js
@@ -60,6 +60,31 @@ test('renders an accessible Markdown thumbnail link', function () {
   );
 });
 
+test('stores blog thumbnails beside the Markdown file', function () {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'youtube-embed-blog-'));
+  const blogDirectory = path.join(root, 'blogs', '2026', '09', '04');
+  const markdownPath = path.join(blogDirectory, 'article.md');
+
+  fs.mkdirSync(blogDirectory, { recursive: true });
+  fs.writeFileSync(markdownPath, '<iframe src="https://www.youtube.com/embed/3HiLLByBWkg" title="Video showing debugging."></iframe>\n');
+
+  return runMigration({
+    getBuffer: function () {
+      return Promise.resolve({ contentType: 'image/jpeg', data: JPEG });
+    },
+    inputs: [markdownPath],
+    logger: function () {},
+    root,
+    write: true
+  }).then(function () {
+    assert.match(fs.readFileSync(markdownPath, 'utf8'), /\]\(youtube-3HiLLByBWkg\.jpg\)\]\(https:\/\/www\.youtube\.com/);
+    assert.equal(fs.existsSync(path.join(blogDirectory, 'youtube-3HiLLByBWkg.jpg')), true);
+    assert.equal(fs.existsSync(path.join(blogDirectory, 'images')), false);
+  }).finally(function () {
+    fs.rmSync(root, { recursive: true, force: true });
+  });
+});
+
 test('falls back to the next valid JPEG thumbnail', function () {
   const requestedUrls = [];
 
diff --git a/docs/enterprise/policies.md b/docs/enterprise/policies.md
index 533d6c5997..e58c28ece7 100644
--- a/docs/enterprise/policies.md
+++ b/docs/enterprise/policies.md
@@ -3,36 +3,36 @@
 ContentId: 200bf922-3684-45ee-a8dd-43191d6b3f8b
 DateApproved: 9/2/2026
 
-VSCodeCommitHash: 5dbc18b9f6914161325aef30f3d86c2095ad2f0c
-VSCodeVersion: 1.122.0
+VSCodeCommitHash: db46a82c4f4a77c4853867dcdba5057229b5d099
+VSCodeVersion: 1.136.0
 
 # Summarize the whole topic in less than 300 characters for SEO purpose
-MetaDescription: Enterprise policies in {% data variables.product.prodname_vscode %} enable organizations to centrally manage settings for their development teams. This reference details the available policies and how to implement them.
+MetaDescription: Enterprise policies in Visual Studio Code enable organizations to centrally manage settings for their development teams. This reference details the available policies and how to implement them.
 ---
 
-# Centrally manage {% data variables.product.prodname_vscode_shortname %} settings with policies
+# Centrally manage VS Code settings with policies
 
-Enterprise policies in {% data variables.product.prodname_vscode %} enable organizations to centrally manage {% data variables.product.prodname_vscode_shortname %} settings for their development teams to ensure consistency and compatibility across their organization. When a policy value is set, the value overrides the {% data variables.product.prodname_vscode_shortname %} setting value configured at any level (default, user, and workspace).
+Enterprise policies in Visual Studio Code enable organizations to centrally manage VS Code settings for their development teams to ensure consistency and compatibility across their organization. When a policy value is set, the value overrides the VS Code setting value configured at any level (default, user, and workspace).
 
-IT admins can deploy and enforce specific {% data variables.product.prodname_vscode_shortname %} configurations on users' devices through different device management solutions. {% data variables.product.prodname_vscode_shortname %} supports applying policies on Windows, macOS, and Linux.
+IT admins can deploy and enforce specific VS Code configurations on users' devices through different device management solutions. VS Code supports applying policies on Windows, macOS, and Linux.
 
 ![Settings editor showing that the 'Extensions: Allowed' setting is managed by the organization.](images/policies/allowed-extensions-managed-by-organization.png)
 
-In this article, you learn which enterprise policies are available in {% data variables.product.prodname_vscode_shortname %} and how to configure them on different operating systems.
+In this article, you learn which enterprise policies are available in VS Code and how to configure them on different operating systems.
 
 ## Windows group policies
 
-{% data variables.product.prodname_vscode_shortname %} has support for [Windows Registry-based Group Policy](https://learn.microsoft.com/previous-versions/windows/desktop/policy/implementing-registry-based-policy).
+VS Code has support for [Windows Registry-based Group Policy](https://learn.microsoft.com/previous-versions/windows/desktop/policy/implementing-registry-based-policy).
 
 These profiles can be deployed using Mobile Device Management (MDM) solutions or installed manually on individual devices.
 
 ### Step 1: Obtain the sample ADMX and ADML files
 
-Starting from {% data variables.product.prodname_vscode_shortname %} version 1.69, each release ships with a `policies` directory containing ADMX template files that define the available policies.
+Starting from VS Code version 1.69, each release ships with a `policies` directory containing ADMX template files that define the available policies.
 
-You can get the ADMX and ADML files from either an existing installation or by downloading and extracting the {% data variables.product.prodname_vscode_shortname %} zip archive. Follow these steps to obtain the files:
+You can get the ADMX and ADML files from either an existing installation or by downloading and extracting the VS Code zip archive. Follow these steps to obtain the files:
 
-1. Download the [{% data variables.product.prodname_vscode_shortname %} zip archive](/download) for your version of {% data variables.product.prodname_vscode_shortname %}.
+1. Download the [VS Code zip archive](/download) for your version of VS Code.
 1. Extract the zip file to a temporary location.
 1. Navigate to the `policies` folder in the extracted files. This folder contains the ADMX template files (for example, `vscode.admx`) and a `locales` subfolder with ADML files for different languages.
 
@@ -40,8 +40,8 @@ You can get the ADMX and ADML files from either an existing installation or by d
 
 After installing the ADMX and ADML files, configure policy values through your management tool:
 
-- For Active Directory environments, use the Group Policy Editor (`gpedit.msc`) and navigate to **Computer Configuration** > **Administrative Templates** > **{% data variables.product.prodname_vscode %}**.
-- For cloud-managed devices, use your MDM solution (for example, Microsoft Intune) to configure the imported {% data variables.product.prodname_vscode_shortname %} administrative template policies.
+- For Active Directory environments, use the Group Policy Editor (`gpedit.msc`) and navigate to **Computer Configuration** > **Administrative Templates** > **Visual Studio Code**.
+- For cloud-managed devices, use your MDM solution (for example, Microsoft Intune) to configure the imported VS Code administrative template policies.
 - Open each policy, set it to **Enabled** or **Disabled**, and provide any required value in the policy UI.
 - Leave policies in the **Not Configured** state if you don't want to enforce them.
 
@@ -67,7 +67,7 @@ For Active Directory environments, copy the ADMX and ADML files to the [Central
 
 If you want to test the policies on a local Windows machine before deploying them at scale, you can manually install the ADMX/ADML files and configure the policies using the Local Group Policy Editor.
 
-Follow these steps to configure {% data variables.product.prodname_vscode_shortname %} policies on a local Windows machine:
+Follow these steps to configure VS Code policies on a local Windows machine:
 
 #### Step 1: Install the policy definition files
 
@@ -83,12 +83,12 @@ Follow these steps to configure {% data variables.product.prodname_vscode_shortn
 1. Type `gpedit.msc` and press Enter to open the Local Group Policy Editor.
 1. If prompted by User Account Control, select **Yes** to allow the app to make changes.
 
-#### Step 3: Navigate to {% data variables.product.prodname_vscode_shortname %} policies
+#### Step 3: Navigate to VS Code policies
 
-The {% data variables.product.prodname_vscode_shortname %} policies are available under both Computer Configuration and User Configuration:
+The VS Code policies are available under both Computer Configuration and User Configuration:
 
-* **Computer Configuration** > **Administrative Templates** > **Microsoft {% data variables.product.prodname_vscode_shortname %}**
-* **User Configuration** > **Administrative Templates** > **Microsoft {% data variables.product.prodname_vscode_shortname %}**
+* **Computer Configuration** > **Administrative Templates** > **Microsoft VS Code**
+* **User Configuration** > **Administrative Templates** > **Microsoft VS Code**
 
 > [!TIP]
 > Computer-level policies take precedence over user-level policies when both are configured.
@@ -96,14 +96,14 @@ The {% data variables.product.prodname_vscode_shortname %} policies are availabl
 #### Step 4: Configure a policy
 
 1. Select the policy category (either Computer Configuration or User Configuration).
-1. Navigate to **Administrative Templates** > **Microsoft {% data variables.product.prodname_vscode_shortname %}**.
+1. Navigate to **Administrative Templates** > **Microsoft VS Code**.
 1. Double-click on the policy you want to configure (for example, **Update Mode**).
 1. In the policy settings dialog, select **Enabled** to enforce the policy.
 1. Configure the policy value using the available options or text fields.
 1. Select **OK** to save the changes.
 1. Close the Local Group Policy Editor.
 
-The policy will take effect the next time {% data variables.product.prodname_vscode_shortname %} is started. Some policies may require restarting Windows to take effect.
+The policy will take effect the next time VS Code is started. Some policies may require restarting Windows to take effect.
 
 </details>
 
@@ -115,17 +115,17 @@ These profiles can be deployed using Mobile Device Management (MDM) solutions or
 
 ### Step 1: Obtain the sample configuration profile
 
-Starting from {% data variables.product.prodname_vscode_shortname %} version 1.99, each release ships with a sample `.mobileconfig` file. Follow these steps to locate the sample file on a macOS device with {% data variables.product.prodname_vscode_shortname %} installed:
+Starting from VS Code version 1.99, each release ships with a sample `.mobileconfig` file. Follow these steps to locate the sample file on a macOS device with VS Code installed:
 
 1. Open Finder and navigate to `/Applications`.
-1. Right-click on **{% data variables.product.prodname_vscode %}.app** (or your {% data variables.product.prodname_vscode_shortname %} variant) and select **Show Package Contents**.
+1. Right-click on **Visual Studio Code.app** (or your VS Code variant) and select **Show Package Contents**.
 1. Navigate to `Contents/Resources/app/policies`.
 1. Locate the sample `.mobileconfig` file (for example, `vscode-sample.mobileconfig`).
 
 ### Step 2: Configure policy values
 
 1. Copy the sample `.mobileconfig` file to a working location (for example, your Desktop or Documents folder).
-1. Open the copied file in a text editor (for example, TextEdit, {% data variables.product.prodname_vscode_shortname %}, or any XML editor).
+1. Open the copied file in a text editor (for example, TextEdit, VS Code, or any XML editor).
 1. Edit the policy values according to your requirements:
 
     Example `policy.json` configuration:
@@ -140,7 +140,7 @@ Starting from {% data variables.product.prodname_vscode_shortname %} version 1.9
     ```
 
     > [!IMPORTANT]
-    > If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in {% data variables.product.prodname_vscode_shortname %} for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
+    > If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in VS Code for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
 
     **Remove unwanted policies** - remove the corresponding JSON property for any policy you don't want to enforce.
 
@@ -167,7 +167,7 @@ For more information on configuration profiles, refer to [Apple's documentation]
 
 ### Configure policies manually
 
-Follow these steps to manually test your {% data variables.product.prodname_vscode_shortname %} policy configuration on a macOS device before deploying at scale:
+Follow these steps to manually test your VS Code policy configuration on a macOS device before deploying at scale:
 
 #### Step 1: Install the configuration profile
 
@@ -182,18 +182,18 @@ Follow these steps to manually test your {% data variables.product.prodname_vsco
 
 1. Open **System Settings** (macOS Ventura and later) or **System Preferences** (earlier versions).
 1. Navigate to **Privacy & Security** > **Profiles** (or **General** > **Device Management** on older versions).
-1. Verify that your {% data variables.product.prodname_vscode_shortname %} configuration profile appears in the list.
-1. Launch {% data variables.product.prodname_vscode_shortname %} to see the policies in effect.
+1. Verify that your VS Code configuration profile appears in the list.
+1. Launch VS Code to see the policies in effect.
 
 > [!NOTE]
-> Policies take effect immediately for new {% data variables.product.prodname_vscode_shortname %} instances. You may need to restart {% data variables.product.prodname_vscode_shortname %} if it's already running.
+> Policies take effect immediately for new VS Code instances. You may need to restart VS Code if it's already running.
 
 #### Remove a configuration profile
 
 To remove policies and revert to default settings:
 
 1. Open **System Settings** > **Privacy & Security** > **Profiles**.
-1. Select the {% data variables.product.prodname_vscode_shortname %} configuration profile.
+1. Select the VS Code configuration profile.
 1. Select the **Remove** (or **-**) button.
 1. Authenticate with your administrator credentials to confirm removal.
 
@@ -201,13 +201,13 @@ To remove policies and revert to default settings:
 
 ## Linux JSON policies
 
-Starting from {% data variables.product.prodname_vscode_shortname %} version 1.106, you can configure {% data variables.product.prodname_vscode_shortname %} setting policies on Linux devices by placing a JSON policy file at `/etc/vscode/policy.json`. This approach uses a simple JSON format to define policy values.
+Starting from VS Code version 1.106, you can configure VS Code setting policies on Linux devices by placing a JSON policy file at `/etc/vscode/policy.json`. This approach uses a simple JSON format to define policy values.
 
 These profiles can be deployed using Mobile Device Management (MDM) solutions or installed manually on individual devices.
 
 ### Step 1: Obtain the sample policy file
 
-Starting from {% data variables.product.prodname_vscode_shortname %} version 1.106, each release ships with a sample `.policy.json` file. You can obtain it from either an existing installation or by downloading and extracting the {% data variables.product.prodname_vscode_shortname %} archive. The file is located in the `resources/app/policies` directory.
+Starting from VS Code version 1.106, each release ships with a sample `.policy.json` file. You can obtain it from either an existing installation or by downloading and extracting the VS Code archive. The file is located in the `resources/app/policies` directory.
 
 ### Step 2: Configure policy values
 
@@ -241,7 +241,7 @@ Starting from {% data variables.product.prodname_vscode_shortname %} version 1.1
     ```
 
     > [!IMPORTANT]
-    > If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in {% data variables.product.prodname_vscode_shortname %} for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
+    > If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in VS Code for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
 
     **Remove unwanted policies** - remove the corresponding JSON property for any policy you don't want to enforce.
 
@@ -289,27 +289,27 @@ These tools allow administrators to deploy, update, and remove policies remotely
 
 #### Step 2: Verify the policy installation
 
-1. Launch {% data variables.product.prodname_vscode_shortname %} (or restart it if already running).
+1. Launch VS Code (or restart it if already running).
 1. Open **File** > **Preferences** > **Settings** (or press `Ctrl+,`).
 1. Look for settings that correspond to your configured policies - they should show as "managed by your organization" or have a lock icon.
 1. Hover over managed settings to see that they are controlled by policy.
 
 > [!TIP]
-> You can verify the policy file is being read by checking {% data variables.product.prodname_vscode_shortname %}'s logs or by attempting to change a managed setting (the change will be prevented).
+> You can verify the policy file is being read by checking VS Code's logs or by attempting to change a managed setting (the change will be prevented).
 
 #### Remove policies
 
-To remove all policies and revert to default settings, delete the `/etc/vscode/policy.json` file and restart {% data variables.product.prodname_vscode_shortname %}.
+To remove all policies and revert to default settings, delete the `/etc/vscode/policy.json` file and restart VS Code.
 
 </details>
 
 ## Verify policy enforcement
 
-After you deploy enterprise policies to a device, you can confirm that {% data variables.product.prodname_vscode_shortname %} is reading and enforcing them with the **Developer: Policy Diagnostics** command. The command opens a new untitled Markdown document with a report of the current policy state on the device. It works the same way on Windows, macOS, and Linux.
+After you deploy enterprise policies to a device, you can confirm that VS Code is reading and enforcing them with the **Developer: Policy Diagnostics** command. The command opens a new untitled Markdown document with a report of the current policy state on the device. It works the same way on Windows, macOS, and Linux.
 
 The report includes the following sections:
 
-* **System Information**: {% data variables.product.prodname_vscode_shortname %} product name, version, and commit, useful for matching the report to a specific build.
+* **System Information**: VS Code product name, version, and commit, useful for matching the report to a specific build.
 * **Account Information**: details of the default account that is signed in, including the raw account-level policy data returned by the account provider.
 * **Account Policy Gate**: state of the [approved GitHub organizations gate](/docs/enterprise/ai-settings.md#restrict-ai-features-to-approved-github-organizations) that controls AI features. Possible states are `inactive`, `satisfied`, and `restricted`. When the state is `restricted`, the report also lists a reason such as `noAccount`, `wrongProvider`, `orgNotApproved`, or `policyNotResolved`.
 * **Policy-Controlled Settings**: two tables that list the policy state for each registered setting:
@@ -323,42 +323,67 @@ The report includes the following sections:
 > [!TIP]
 > If the **Account Policy Gate** state is `policyNotResolved`, run the **Developer: Sync Account Policy** command to force a refresh of the account-side policy data, then regenerate the report.
 
-## {% data variables.product.prodname_vscode_shortname %} enterprise policy reference
+## VS Code enterprise policy reference
 
-The following table lists all available enterprise policies in {% data variables.product.prodname_vscode_shortname %}.
+The following table lists all available enterprise policies in VS Code.
 
 | Policy<br>Setting ID | Description |
 |:--|:--|
-| `McpGalleryServiceUrl` | <span data-min-version="1.101">Configure the MCP Gallery service URL to connect to</span> |
+| `ChatAgentAllowedNetworkDomains`<br>`setting(chat.agent.allowedNetworkDomains)` | <span data-min-version="1.116">Allowed domains for network access by agent tools (fetch tool, integrated browser). Applies when `#chat.agent.networkFilter#` or `#chat.agent.sandbox.enabled#` is enabled. When `#chat.agent.sandbox.allowNetwork#` is enabled, all domains are allowed. Supports wildcards like `*.example.com`. When both allowed and denied lists are empty, all domains are blocked. Denied domains (see `#chat.agent.deniedNetworkDomains#`) take precedence.</span> |
+| `ChatAgentDeniedNetworkDomains`<br>`setting(chat.agent.deniedNetworkDomains)` | <span data-min-version="1.116">Denied domains for network access by agent tools (fetch tool, integrated browser). Applies when `#chat.agent.networkFilter#` or `#chat.agent.sandbox.enabled#` is enabled. This does not apply when `#chat.agent.sandbox.allowNetwork#` is enabled. Takes precedence over `#chat.agent.allowedNetworkDomains#`. Supports wildcards like `*.example.com`.</span> |
+| `ChatAgentMode`<br>`setting(chat.agent.enabled)` | <span data-min-version="1.99">When enabled, agent mode can be activated from chat and tools in agentic contexts with side effects can be used.</span> |
+| `ChatAgentNetworkFilter`<br>`setting(chat.agent.networkFilter)` | <span data-min-version="1.116">When enabled, network access by agent tools (fetch tool, integrated browser) is restricted according to `#chat.agent.allowedNetworkDomains#` and `#chat.agent.deniedNetworkDomains#`. Domain filtering is also applied to those tools when `#chat.agent.sandbox.enabled#` is enabled.</span> |
+| `ChatAgentSandboxAllowAutoApprove`<br>`setting(chat.agent.sandbox.allowAutoApprove)` | <span data-min-version="1.116">Controls whether agent mode terminal commands that run inside the sandbox are auto-approved. When disabled, the run in terminal tool uses the existing approval flow. This applies only when `#chat.agent.sandbox.enabled#` is enabled.</span> |
+| `ChatAgentSandboxAllowNetwork`<br>`setting(chat.agent.sandbox.allowNetwork)` | <span data-min-version="1.127">When `#chat.agent.sandbox.enabled#` is enabled, controls whether to allow all network domains in the sandbox. When enabled, the sandbox preserves file system restrictions while relaxing all network restrictions.</span> |
+| `ChatAgentSandboxAllowUnsandboxedCommands`<br>`setting(chat.agent.sandbox.allowUnsandboxedCommands)` | <span data-min-version="1.116">Controls whether agent mode terminal commands can run outside the sandbox after user confirmation when a sandboxed command fails or when sandbox restrictions would block the command. This applies only when `#chat.agent.sandbox.enabled#` is enabled.</span> |
+| `ChatAgentSandboxEnabled`<br>`setting(chat.agent.sandbox.enabled)` | <span data-min-version="1.116">Controls whether agent mode uses sandboxing to restrict what tools can do. When enabled, tools like the terminal are run in a sandboxed environment to limit access to the system. Use `#chat.agent.sandbox.allowNetwork#` to allow all network domains.</span> |
+| `Claude3PIntegration`<br>`setting(chat.agentHost.claudeAgent.enabled)`<br>`setting(github.copilot.chat.claudeAgent.enabled)` | <span data-min-version="1.113">Enable Claude Agent sessions in VS Code. Start and resume agentic coding sessions powered by Anthropic Claude Agent SDK directly in the editor. Uses your existing Copilot subscription.</span> |
+| `Codex3PIntegration`<br>`setting(chat.agentHost.codexAgent.enabled)` | <span data-min-version="1.126">Enable Codex Agent sessions in VS Code. Start and resume agentic coding sessions powered by OpenAI Codex. Usage can be routed through GitHub Copilot or authenticated directly with an OpenAI account.</span> |
+| `CopilotOtelCaptureContent`<br>`setting(chat.agentHost.otel.captureContent)`<br>`setting(github.copilot.chat.otel.captureContent)` | <span data-min-version="1.127">Controls whether Copilot OpenTelemetry export captures prompt, response, and tool content.</span> |
+| `CopilotOtelEnabled`<br>`setting(chat.agentHost.otel.enabled)`<br>`setting(github.copilot.chat.otel.enabled)` | <span data-min-version="1.127">Controls whether Copilot OpenTelemetry export is enabled. When managed, users cannot override the enterprise value.</span> |
+| `CopilotOtelProtocol`<br>`setting(chat.agentHost.otel.exporterType)`<br>`setting(github.copilot.chat.otel.exporterType)` | <span data-min-version="1.127">Controls the enterprise-managed OTLP protocol for Copilot OpenTelemetry export.</span> |
+| `CopilotOtelHeaders`<br>`setting(github.copilot.chat.otel.headers)` | <span data-min-version="1.127">Controls the enterprise-managed OTLP exporter headers for Copilot OpenTelemetry export.</span> |
+| `CopilotOtelEndpoint`<br>`setting(chat.agentHost.otel.otlpEndpoint)`<br>`setting(github.copilot.chat.otel.otlpEndpoint)` | <span data-min-version="1.127">Controls the enterprise-managed OTLP collector endpoint for Copilot OpenTelemetry export.</span> |
+| `CopilotOtelOtlpProtocol`<br>`setting(github.copilot.chat.otel.protocol)` | <span data-min-version="1.127">Controls the enterprise-managed OTLP wire protocol (protobuf vs JSON) for Copilot OpenTelemetry export.</span> |
+| `CopilotOtelOutfile`<br>`setting(chat.agentHost.otel.outfile)`<br>`setting(github.copilot.chat.otel.outfile)` | <span data-min-version="1.127">Prevents local file export when enterprise-managed Copilot OpenTelemetry export is configured.</span> |
+| `CopilotOtelResourceAttributes`<br>`setting(github.copilot.chat.otel.resourceAttributes)` | <span data-min-version="1.127">Controls the enterprise-managed OTel resource attributes for Copilot OpenTelemetry export.</span> |
+| `CopilotOtelServiceName`<br>`setting(github.copilot.chat.otel.serviceName)` | <span data-min-version="1.127">Controls the enterprise-managed OTel `service.name` resource attribute for Copilot OpenTelemetry export.</span> |
 | `ChatApprovedAccountOrganizations` | <span data-min-version="1.118">Setting this policy to a non-empty list activates the Approved Account gate: all AI features are disabled until the user signs into a GitHub account whose organizations intersect this list AND the account-side policy data has resolved. Comparison is case-insensitive. Use '*' as a wildcard to accept any signed-in GitHub or GHE account (use this for GHE deployments where the organization list is not surfaced).</span> |
-| `ExtensionGalleryServiceUrl` | <span data-min-version="1.99">Configure the Marketplace service URL to connect to</span> |
-| `AllowedExtensions`<br>`setting(extensions.allowed)` | <span data-min-version="1.96">Specify a list of extensions that are allowed to use. This helps maintain a secure and consistent development environment by restricting the use of unauthorized extensions. More information: https://aka.ms/vscode/enterprise/extensions/allowed</span> |
-| `ChatToolsAutoApprove`<br>`setting(chat.tools.global.autoApprove)` | <span data-min-version="1.99">Global auto approve also known as "YOLO mode" disables manual approval completely for all tools in all workspaces, allowing the agent to act fully autonomously. This is extremely dangerous and is *never* recommended, even containerized environments like Codespaces and Dev Containers have user keys forwarded into the container that could be compromised. This feature disables critical security protections and makes it much easier for an attacker to compromise the machine. Note: This setting only controls tool approval and does not prevent the agent from asking questions. To automatically answer agent questions, use the `#chat.autoReply#` setting.</span> |
-| `CopilotSessionSync`<br>`setting(chat.sessionSync.enabled)` | <span data-min-version="1.121">Enable session sync to GitHub.com for cross-device Copilot session history. When disabled by organization policy, session data is kept local only.</span> |
-| `ChatToolsEligibleForAutoApproval`<br>`setting(chat.tools.eligibleForAutoApproval)` | <span data-min-version="1.107">Controls which tools are eligible for automatic approval. Tools set to 'false' will always present a confirmation and will never offer the option to auto-approve. The default behavior (or setting a tool to 'true') may result in the tool offering auto-approval options.</span> |
-| `ChatMCP`<br>`setting(chat.mcp.access)` | <span data-min-version="1.99">Controls access to installed Model Context Protocol servers.</span> |
+| `ChatStrictPluginOnlyCustomization` | <span data-min-version="1.132">Blocks standalone user and workspace skills, agents, hooks, instructions, and MCP servers while keeping eligible plugin customizations available.</span> |
+| `ChatDefaultModel`<br>`setting(chat.defaultModel)` | <span data-min-version="1.127">Sets the default chat model for new conversations. Accepts "auto", a model family name (such as "opus" or "gemini"), or a full model id. Users can still switch the model within a conversation.</span> |
+| `ChatEditorPreferCopilotHarness`<br>`setting(chat.editor.preferCopilotHarness)` | <span data-min-version="1.134">Configure whether VS Code uses the Agent Host Copilot SDK instead of the local harness for new editor chat sessions.</span> |
 | `ChatAgentExtensionTools`<br>`setting(chat.extensionTools.enabled)` | <span data-min-version="1.99">Enable using tools contributed by third-party extensions.</span> |
+| `ChatAllowManagedHooksOnly` | <span data-min-version="1.132">Allows hooks only from enterprise-managed sources and plugins force-enabled by policy.</span> |
+| `ChatMCP`<br>`setting(chat.mcp.access)` | <span data-min-version="1.99">Controls access to installed Model Context Protocol servers.</span> |
+| `ChatAllowedMcpServers` | <span data-min-version="1.130">Allowlist of Model Context Protocol servers. When set, only servers matching an entry may be installed or run; omit entirely to allow all servers (subject to the deny list).</span> |
+| `ChatAllowManagedMcpServersOnly` | <span data-min-version="1.132">Use only the enterprise-managed MCP allowlist when deciding which servers may run.</span> |
+| `ChatDeniedMcpServers` | <span data-min-version="1.130">Denylist of Model Context Protocol servers. Servers matching any entry are blocked from being installed or run, even if they also match the allow list; deny rules always take precedence.</span> |
+| `McpGalleryServiceUrl` | <span data-min-version="1.101">Configure the MCP Gallery service URL to connect to</span> |
 | `ChatPluginsEnabled`<br>`setting(chat.plugins.enabled)` | <span data-min-version="1.116">Enable agent plugin integration in chat.</span> |
-| `ChatAgentMode`<br>`setting(chat.agent.enabled)` | <span data-min-version="1.99">When enabled, agent mode can be activated from chat and tools in agentic contexts with side effects can be used.</span> |
-| `ChatAgentNetworkFilter`<br>`setting(chat.agent.networkFilter)` | <span data-min-version="1.116">When enabled, network access by agent tools (fetch tool, integrated browser) is restricted according to `#chat.agent.allowedNetworkDomains#` and `#chat.agent.deniedNetworkDomains#`. Domain filtering is also applied to those tools when `#chat.agent.sandbox.enabled#` is enabled.</span> |
-| `ChatAgentAllowedNetworkDomains`<br>`setting(chat.agent.allowedNetworkDomains)` | <span data-min-version="1.116">Allowed domains for network access by agent tools (fetch tool, integrated browser). Applies when `#chat.agent.networkFilter#` or `#chat.agent.sandbox.enabled#` is enabled. When `#chat.agent.sandbox.enabled#` is set to `allowNetwork`, all domains are allowed. Supports wildcards like `*.example.com`. When both allowed and denied lists are empty, all domains are blocked. Denied domains (see `#chat.agent.deniedNetworkDomains#`) take precedence.</span> |
-| `ChatAgentDeniedNetworkDomains`<br>`setting(chat.agent.deniedNetworkDomains)` | <span data-min-version="1.116">Denied domains for network access by agent tools (fetch tool, integrated browser). Applies when `#chat.agent.networkFilter#` or `#chat.agent.sandbox.enabled#` is enabled. This does not apply when `#chat.agent.sandbox.enabled#` is set to `allowNetwork`. Takes precedence over `#chat.agent.allowedNetworkDomains#`. Supports wildcards like `*.example.com`.</span> |
-| `DeprecatedEditModeHidden`<br>`setting(chat.editMode.hidden)` | <span data-min-version="1.112">When enabled, hides the Edit mode from the chat mode picker.</span> |
-| `ChatHooks`<br>`setting(chat.useHooks)` | <span data-min-version="1.109">Controls whether chat hooks are executed at strategic points during an agent's workflow. Hooks are loaded from the files configured in `#chat.hookFilesLocations#`.</span> |
+| `ChatEnabledPlugins`<br>`setting(chat.plugins.enabledPlugins)` | <span data-min-version="1.122">Plugin enablement. Keys are plugin IDs in `{plugin}@{marketplace}` form; values enable or disable the plugin.</span> |
+| `ChatExtraMarketplaces` | <span data-min-version="1.122">Additional plugin marketplaces to query. Keys are marketplace names; values are GitHub shorthand (`owner/repo[#ref]`) or Git URIs (`{url}[#ref]`), optionally with an enterprise-managed auto-update override.</span> |
+| `ChatStrictMarketplaces`<br>`setting(chat.plugins.strictMarketplaces)` | <span data-min-version="1.122">Allowlist of plugin marketplace sources. When set, only marketplaces matching an entry are trusted; an empty array blocks all marketplaces.</span> |
+| `CopilotSessionSync`<br>`setting(chat.sessionSync.enabled)` | <span data-min-version="1.121">Enable session sync to GitHub.com for cross-device Copilot session history. When disabled by organization policy, session data is kept local only.</span> |
+| `ChatToolsEligibleForAutoApproval`<br>`setting(chat.tools.eligibleForAutoApproval)` | <span data-min-version="1.107">Controls which tools are eligible for automatic approval. Tools set to 'false' will always present a confirmation and will never offer the option to auto-approve. The default behavior (or setting a tool to 'true') may result in the tool offering auto-approval options.</span> |
+| `ChatToolsAutoApprove`<br>`setting(chat.tools.global.autoApprove)` | <span data-min-version="1.99">Global auto approve also known as "YOLO mode" disables manual approval completely for all tools in all workspaces, allowing the agent to act fully autonomously. This is extremely dangerous and is *never* recommended, even containerized environments like Codespaces and Dev Containers have user keys forwarded into the container that could be compromised. This feature disables critical security protections and makes it much easier for an attacker to compromise the machine. Note: This setting only controls tool approval and does not prevent the agent from asking questions. To automatically answer agent questions, use the `#chat.autoReply#` setting.</span> |
 | `ChatToolsTerminalEnableAutoApprove`<br>`setting(chat.tools.terminal.enableAutoApprove)` | <span data-min-version="1.104">Controls whether to allow auto approval in the run in terminal tool.</span> |
-| `ChatAgentSandboxEnabled`<br>`setting(chat.agent.sandbox.enabled)` | <span data-min-version="1.116">Controls whether agent mode uses sandboxing to restrict what tools can do. When enabled, tools like the terminal are run in a sandboxed environment to limit access to the system.</span> |
-| `ChatAgentSandboxAllowUnsandboxedCommands`<br>`setting(chat.agent.sandbox.allowUnsandboxedCommands)` | <span data-min-version="1.116">Controls whether agent mode terminal commands can run outside the sandbox after user confirmation when a sandboxed command fails or when sandbox restrictions would block the command. This applies only when `#chat.agent.sandbox.enabled#` is enabled.</span> |
-| `ChatAgentSandboxAutoApproveUnsandboxedCommands`<br>`setting(chat.agent.sandbox.autoApproveUnsandboxedCommands)` | <span data-min-version="1.116">Controls whether agent mode terminal commands that run outside the sandbox are auto-approved. This applies only when both `#chat.agent.sandbox.enabled#` and `#chat.agent.sandbox.allowUnsandboxedCommands#` are enabled.</span> |
-| `ChatAgentSandboxAllowAutoApprove`<br>`setting(chat.agent.sandbox.allowAutoApprove)` | <span data-min-version="1.116">Controls whether agent mode terminal commands that run inside the sandbox are auto-approved. When disabled, the run in terminal tool uses the existing approval flow. This applies only when `#chat.agent.sandbox.enabled#` is enabled.</span> |
-| `UpdateMode`<br>`setting(update.mode)` | <span data-min-version="1.67">Configure whether you receive automatic updates. Requires a restart after change. The updates are fetched from a Microsoft online service.</span> |
-| `TelemetryLevel`<br>`setting(telemetry.telemetryLevel)` | <span data-min-version="1.99">Controls the level of telemetry.</span> |
+| `ChatHooks`<br>`setting(chat.useHooks)` | <span data-min-version="1.109">Controls whether chat hooks are executed at strategic points during an agent's workflow. Hooks are loaded from the files configured in `#chat.hookFilesLocations#`. This setting is only used by the Local agent harness.</span> |
+| `DictationEnabled`<br>`setting(dictation.enabled)` | <span data-min-version="1.131">Controls whether dictation is available across the product (chat input, editor, and terminal).</span> |
+| `DictationLLMCleanup`<br>`setting(dictation.experimental.llmCleanup)` | <span data-min-version="1.136">Controls whether final dictation transcripts are sent to a language model for cleanup.</span> |
+| `DictationModel`<br>`setting(dictation.model)` | <span data-min-version="1.136">Controls the transcription model used for dictation.</span> |
+| `AllowedExtensions`<br>`setting(extensions.allowed)` | <span data-min-version="1.96">Specify a list of extensions that are allowed to use. This helps maintain a secure and consistent development environment by restricting the use of unauthorized extensions. More information: https://aka.ms/vscode/enterprise/extensions/allowed</span> |
+| `ExtensionsAutoUpdate`<br>`setting(extensions.autoUpdate)` | <span data-min-version="1.125">Controls the automatic update behavior of extensions. The updates are fetched from a Microsoft online service.</span> |
+| `ExtensionsAutoUpdateDelay`<br>`setting(extensions.autoUpdateDelay)` | <span data-min-version="1.125">Controls the delay in hours after an extension update is published before it is automatically installed. Only applies when `#extensions.autoUpdate#` is set to `on`. This delay helps avoid installing potentially problematic updates immediately after release.</span> |
+| `ExtensionGalleryServiceUrl` | <span data-min-version="1.99">Configure the Marketplace service URL to connect to</span> |
+| `CopilotReviewAgent`<br>`setting(github.copilot.chat.reviewAgent.enabled)` | <span data-min-version="1.104">Enables the code review agent.</span> |
+| `CopilotReviewSelection`<br>`setting(github.copilot.chat.reviewSelection.enabled)` | <span data-min-version="1.104">Enables code review on current selection.</span> |
+| `CopilotNextEditSuggestions`<br>`setting(github.copilot.nextEditSuggestions.enabled)` | <span data-min-version="1.99">Whether to enable next edit suggestions (NES). NES can propose a next edit based on your recent changes.</span> |
+| `McpEnterpriseManagedAuthIdp` | <span data-min-version="1.122">The OAuth/OIDC IdP configuration used for enterprise-managed Model Context Protocol (MCP) server authentication.</span> |
 | `EnableFeedback`<br>`setting(telemetry.feedback.enabled)` | <span data-min-version="1.99">Enable feedback mechanisms such as the issue reporter, surveys, and other feedback options.</span> |
+| `TelemetryLevel`<br>`setting(telemetry.telemetryLevel)` | <span data-min-version="1.99">Controls the level of telemetry.</span> |
+| `UpdateMode`<br>`setting(update.mode)` | <span data-min-version="1.67">Configure whether you receive automatic updates. The updates are fetched from a Microsoft online service.</span> |
 | `BrowserChatTools`<br>`setting(workbench.browser.enableChatTools)` | <span data-min-version="1.110">When enabled, chat agents can use browser tools to open and interact with pages in the Integrated Browser.</span> |
-| `CopilotNextEditSuggestions`<br>`setting(github.copilot.nextEditSuggestions.enabled)` | <span data-min-version="1.99">Whether to enable next edit suggestions (NES). NES can propose a next edit based on your recent changes.</span> |
-| `CopilotReviewSelection`<br>`setting(github.copilot.chat.reviewSelection.enabled)` | <span data-min-version="1.104">Enables code review on current selection.</span> |
-| `CopilotReviewAgent`<br>`setting(github.copilot.chat.reviewAgent.enabled)` | <span data-min-version="1.104">Enables the code review agent.</span> |
-| `Claude3PIntegration`<br>`setting(github.copilot.chat.claudeAgent.enabled)` | <span data-min-version="1.113">Enable Claude Agent sessions in {% data variables.product.prodname_vscode_shortname %}. Start and resume agentic coding sessions powered by Anthropic Claude Agent SDK directly in the editor. Uses your existing Copilot subscription.</span> |
 
 
 > [!NOTE]
-> If you want to enact more policies, open an issue in the [{% data variables.product.prodname_vscode_shortname %} GitHub repository](https://github.com/microsoft/vscode/issues). The team will determine if there is already a corresponding setting for the behavior or if a new setting and policy should be created.
+> If you want to enact more policies, open an issue in the [VS Code GitHub repository](https://github.com/microsoft/vscode/issues). The team will determine if there is already a corresponding setting for the behavior or if a new setting and policy should be created.
diff --git a/docs/metadata.json b/docs/metadata.json
index 7858ea657d..9ce490eb00 100644
--- a/docs/metadata.json
+++ b/docs/metadata.json
@@ -1,30 +1,50 @@
 {
 	"OrgSettings": [
-		"extensions.allowed",
-		"chat.tools.global.autoApprove",
-		"chat.sessionSync.enabled",
-		"chat.tools.eligibleForAutoApproval",
-		"chat.mcp.access",
-		"chat.extensionTools.enabled",
-		"chat.plugins.enabled",
-		"chat.agent.enabled",
-		"chat.agent.networkFilter",
 		"chat.agent.allowedNetworkDomains",
 		"chat.agent.deniedNetworkDomains",
-		"chat.editMode.hidden",
-		"chat.useHooks",
-		"chat.tools.terminal.enableAutoApprove",
-		"chat.agent.sandbox.enabled",
-		"chat.agent.sandbox.allowUnsandboxedCommands",
-		"chat.agent.sandbox.autoApproveUnsandboxedCommands",
+		"chat.agent.enabled",
+		"chat.agent.networkFilter",
 		"chat.agent.sandbox.allowAutoApprove",
-		"update.mode",
-		"telemetry.telemetryLevel",
-		"telemetry.feedback.enabled",
-		"workbench.browser.enableChatTools",
-		"github.copilot.nextEditSuggestions.enabled",
-		"github.copilot.chat.reviewSelection.enabled",
+		"chat.agent.sandbox.allowNetwork",
+		"chat.agent.sandbox.allowUnsandboxedCommands",
+		"chat.agent.sandbox.enabled",
+		"chat.agentHost.claudeAgent.enabled",
+		"github.copilot.chat.claudeAgent.enabled",
+		"chat.agentHost.codexAgent.enabled",
+		"chat.agentHost.otel.captureContent",
+		"github.copilot.chat.otel.captureContent",
+		"chat.agentHost.otel.enabled",
+		"github.copilot.chat.otel.enabled",
+		"chat.agentHost.otel.exporterType",
+		"github.copilot.chat.otel.exporterType",
+		"chat.agentHost.otel.otlpEndpoint",
+		"github.copilot.chat.otel.otlpEndpoint",
+		"chat.agentHost.otel.outfile",
+		"github.copilot.chat.otel.outfile",
+		"chat.defaultModel",
+		"chat.editor.preferCopilotHarness",
+		"chat.extensionTools.enabled",
+		"chat.mcp.access",
+		"chat.plugins.enabled",
+		"chat.plugins.enabledPlugins",
+		"chat.plugins.strictMarketplaces",
+		"chat.sessionSync.enabled",
+		"chat.tools.eligibleForAutoApproval",
+		"chat.tools.global.autoApprove",
+		"chat.tools.terminal.enableAutoApprove",
+		"chat.useHooks",
+		"dictation.enabled",
+		"dictation.experimental.llmCleanup",
+		"dictation.model",
+		"extensions.allowed",
+		"extensions.autoUpdate",
+		"extensions.autoUpdateDelay",
 		"github.copilot.chat.reviewAgent.enabled",
-		"github.copilot.chat.claudeAgent.enabled"
+		"github.copilot.chat.reviewSelection.enabled",
+		"github.copilot.nextEditSuggestions.enabled",
+		"telemetry.feedback.enabled",
+		"telemetry.telemetryLevel",
+		"update.mode",
+		"workbench.browser.enableChatTools"
 	]
 }
\ No newline at end of file