Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Magento does not have one universal native switch that guarantees a product’s main image becomes its Open Graph image. The right method depends on your storefront: Adobe Commerce Storefront documents adding an og:image value in its metadata table; a conventional Magento theme or custom storefront may need a theme or module change. In either case, verify the rendered product-page HTML and the public image URL.

Choose the implementation for your storefront

Storefront What to do What to verify
Adobe Commerce Storefront using its documented metadata-table workflow Add an og:image metadata property with the full image URL. Confirm the metadata table applies to the product page and that the generated document contains the intended tag.
Conventional Magento theme Check the product image roles and inspect the rendered page. If no suitable tag exists, add it through the theme or a module that generates page metadata. Confirm the tag appears in the product page’s <head> and points to the intended public image.
Headless or custom storefront Set the metadata in the storefront’s own page-rendering implementation. Check the actual rendered output; the conventional theme workflow may not apply.

Adobe’s Storefront metadata documentation describes the metadata-table method; it does not establish that every Magento theme or custom storefront uses that mechanism. Adobe Commerce Storefront: Page Metadata

Set the image in Adobe Commerce Storefront

  1. Open the metadata table used by the relevant page in your Adobe Commerce Storefront setup.
  2. Add a property named og:image.
  3. Set its value to the full URL of the intended product image, including the scheme and hostname.
  4. Save the metadata and inspect the rendered product page to confirm that the tag is present and its value is correct.

The same metadata system supports related properties such as og:type, og:title, and og:description. This documented workflow is specific to a storefront that uses the metadata table; do not assume it configures a conventional Magento theme automatically. Adobe Commerce Storefront: Page Metadata

Set up a conventional Magento theme or custom storefront

Check the product image roles first

In the Magento Admin, inspect the product’s images and their roles, ordering, and visibility for the relevant store view. Adobe documents Base as the main image on the product detail page. Small Image, Thumbnail, and Swatch are distinct roles for other storefront uses. These assignments help identify the intended product image, but Adobe does not say that Base is always emitted as og:image. Image assignments can vary by store view, so inspect the view customers actually use. Adobe Experience League: Manage product images and videos

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Inspect the generated metadata

  1. Open the live product URL in a browser and view its page source or inspect the document’s <head>.
  2. Search for og:image. Check whether a theme or installed module already emits it and whether it points to the correct image.
  3. If the tag is missing or wrong, add or adjust it at the point where your storefront generates page metadata. Use the intended product image’s absolute, publicly accessible URL.
  4. Reload the page and inspect the rendered output again after clearing or accounting for the caches used by your store and delivery stack.

Adobe documents theme image properties in <theme_dir>/etc/view.xml, under <media><images module="Magento_Catalog">...</images></media>. Image IDs and properties configure storefront image types and locations, including dimensions. This is useful when customizing image presentation, but the documentation does not describe a universal view.xml setting that maps a product image to og:image. Adobe Developer: Configure Theme Properties

Choose the intended source image carefully

Keep the distinction between the image role, the displayed rendition, and the Open Graph URL clear. Base identifies the main product-detail image in Adobe’s role documentation; theme image properties can describe storefront image types and dimensions. Neither fact alone determines the URL your page’s Open Graph tag must use. Validate the actual URL emitted by your implementation.

Adobe’s product image upload configuration documents frontend resizing and placeholders, with a suggested JPG quality range of 80–90% and default maximum dimensions of 1920 × 1200 pixels. Those figures describe Adobe Commerce configuration, not universal Open Graph requirements or limits imposed by social platforms. Adobe Experience League: Product image configuration

Consider an extension only after checking compatibility

The Adobe Commerce Marketplace listing for Apptrian’s Open Graph Meta Tags extension says it generates Open Graph metadata from Magento data and uses the full-size primary product image for a product’s og:image. Treat that as the listing’s description, not a guarantee for every installation. Before choosing it, check supported Commerce versions, compatibility with your theme or headless storefront, control over image selection, and maintenance status. Adobe Commerce Marketplace: Open Graph Meta Tags

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Validate the product page and image URL

  • Tag: The rendered product document includes an og:image property in its head.
  • Value: The value is the full URL of the image you intend to share, not a relative path.
  • Accessibility: The image URL is public and resolves to the expected image when opened directly.
  • Store view: The product image assignment and metadata are correct for the store view associated with the URL.
  • Delivery: Check the deployed page and image through the same host and CDN path visitors reach; caching or delivery behavior can affect what is served.

The documented Storefront workflow specifies a full image URL. Adobe’s documentation does not establish universal crawler behavior or a version-by-version compatibility matrix for themes and extensions, so validate the live implementation you operate.

Troubleshooting

The page has no og:image

Check whether the storefront uses Adobe Commerce Storefront’s metadata table or a conventional theme/custom renderer. The metadata-table instructions apply only where that mechanism is in use. For a theme, check whether an installed module already generates metadata before adding a second implementation.

The wrong product image appears in the tag

Review the product’s image roles, ordering, visibility, and store-view-specific assignments. Then inspect the theme or module logic that constructs metadata: Adobe’s Base role documentation does not guarantee that every implementation uses Base for og:image.

The tag points to an image that does not load

Use a full public URL and open it directly. Check the deployed host and CDN path, then inspect the rendered tag again after relevant cache changes. A correct-looking URL in Admin is not a substitute for checking the URL served to visitors.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The tag is correct in Admin but not in page source

Confirm that you edited the metadata source actually used by that storefront and page. If it is a conventional theme or custom storefront, the Storefront metadata table may not control its output; locate the renderer or module that creates the page head.

An extension does not behave as expected

Recheck its supported Commerce versions, theme or headless compatibility, image-selection controls, and maintenance status. A Marketplace listing’s description does not establish compatibility with every current installation.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

To capture and inspect a product page, ScreenshotNeo offers a website screenshot API and MCP server. Its cleanup can accept cookie or consent banners and remove 60+ known consent platforms, newsletter popups, and chat widgets before capture; each step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, and responses identify the page verdict and billing status. AI agents can use its MCP server tools, including take_screenshot, get_page_info, and capture_pdf.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://your-store.example/product-url -o shot.webp

See the ScreenshotNeo API documentation for request options. ScreenshotNeo returns a screenshot or PDF; it does not set Magento’s og:image metadata. Free includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. ScreenshotNeo is an option when you need to capture and inspect the live page. Sign up for 1,000 free screenshots a month, with no card required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quick Recap

SaleBestseller No. 1
Bestseller No. 2
Bestseller No. 3
SaleBestseller No. 5

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.