Writing & StyleStyle guide

Setting Image Localization Scope

Setting Image Localization Scope records a distinct Microsoft Learn authoring convention and keeps it scoped to that documentation environment rather than presenting it as a universal writing rule.

Quick answer

Use the Microsoft Learn image extension’s `loc-scope` property when image localization scope must be declared; it is optional for content and complex images and required for screenshots when the product’s localization scope differs.

Key details

Core Issueimage localization scope
RegisterMicrosoft Learn technical documentation

Important caveats

Scope Boundary

This is Microsoft Learn localization metadata, not a universal Markdown attribute. Apply it only where the contributor reference calls for that scope information.

Further guidance

Content

Use the Microsoft Learn image extension’s `loc-scope` property when image localization scope must be declared; it is optional for content and complex images and required for screenshots when the product’s localization scope differs.

Purpose

Keep Microsoft Learn source readable, accessible, reusable, and predictable while following current contributor-platform conventions.

Sources and evidence

Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.

  1. Markdown reference for Microsoft Learn — Contributor guide (opens in a new tab)Microsoft · Current Microsoft Learn contributor reference for Markdown authoring, including headings/navigation, conceptual images and icons, includes, lists/checklists, nonlocalized strings, alerts, comments, tables, and other Learn extensions.

Explore the topic