width

width · Not mentioned by Google

Appears in

• ImageObject

What is it?

The horizontal dimension of an image in pixels. width tells search engines and AI systems the exact size of an image file, which helps with layout decisions, image selection for featured snippets, and ensuring images meet minimum size requirements for rich results.

Why this matters for AEO

AI answer engines select images to accompany their responses. When choosing between multiple images for a query like "what does a Labrador Retriever look like?", the AI uses width and height to pick an image with sufficient resolution. Images with declared dimensions are preferred over images where the AI must fetch and inspect the file to determine size.

What the specs say

Schema.org: Distance or QuantitativeValue. The width of the item. schema.org/width

Google: Not mentioned. Field not listed in Google's structured data documentation for ImageObject. Google Image License docs

How to find your value

• Image file properties — Right-click > Properties/Get Info > Dimensions
• CMS upload — Webflow shows dimensions on upload
• Browser dev tools — Inspect element > check natural width
• Image editing software — File > Image Size (Photoshop, Figma)

Format and code

For images, use a plain integer representing pixels. No unit suffix needed.

{
  "@context": "https://schema.org",
  "@type": "ImageObject",
  "url": "https://example.com/photos/labrador.jpg",
  "contentUrl": "https://example.com/photos/labrador.jpg",
  "width": 1200,
  "height": 630,
  "caption": "Black Labrador puppy in a garden"
}

String format (also valid):

{
  "@type": "ImageObject",
  "url": "https://example.com/image.jpg",
  "width": "1200",
  "height": "348"
}

Webflow implementation

Static pages

Include dimensions in the ImageObject JSON-LD block in Page Settings > Custom Code:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ImageObject",
  "url": "https://example.com/photo.jpg",
  "width": 1200,
  "height": 630,
  "caption": "Image description"
}
</script>

CMS template pages

Webflow does not expose image dimensions as dynamic fields natively. For CMS images, either hardcode standard dimensions (if all images are the same size) or create custom number fields for width and height.

In Schema HQ

The width field can include height in ImageObject markup when the values are available from the CMS or from image metadata.

Real examples

Yoast Schema ImageObject:

{
  "@type": "ImageObject",
  "@id": "https://example.com/image.jpg",
  "url": "https://example.com/image.jpg",
  "contentUrl": "https://example.com/image.jpg",
  "width": 1200,
  "height": 630,
  "caption": "Descriptive image caption"
}

JayHoltslander Structured Data reference:

{
  "@context": "http://schema.org/",
  "@type": "ImageObject",
  "@id": "#image01",
  "url": "http://placehold.it/2560x1080",
  "width": "1200",
  "height": "348",
  "caption": "Caption for the image"
}

Related fields

• height
• caption
• creditText
• contentUrl
• url

FAQ

Should width be a number or string?

Both are valid. Schema.org accepts Distance or QuantitativeValue, but in practice, a plain integer (1200) or string ("1200") representing pixels works. Most implementations use the integer format.

What is the minimum width for Google rich results?

Google requires images to be at least 1200 pixels wide for some rich result types (like Article). While this requirement is on the image property of the parent type rather than on ImageObject's width field, declaring dimensions helps validators confirm compliance.

Is width required for ImageObject?

No. Neither schema.org nor Google requires width on ImageObject. However, Yoast SEO includes it by default in ImageObject output, and it is considered best practice for complete image metadata.