How to Validate Image Object Schema
ImageObject schema describes images, their technical properties, content, and usage context, helping search engines understand visual content and enabling rich image search results with proper attribution and metadata.
Everything you need to know about ImageObject schema markup. Learn how to optimize images for search engines, improve image search visibility, and provide rich metadata for visual content.
What is Image Object Schema?
ImageObject schema provides structured metadata for images, describing their technical properties, content, licensing, and usage context. It's essential for image search optimization and helps search engines understand what your images depict and how they should be displayed.
Why ImageObject Schema Matters
Images are increasingly important in search results, appearing in image carousels, rich snippets, and knowledge panels. Without ImageObject schema, search engines have limited understanding of your visual content. With it, you can provide rich metadata that improves image discoverability and attribution.
The key insight: ImageObject schema transforms your images from anonymous visual files into rich, searchable content objects that search engines can understand and feature prominently. For product images, combine with Product schema for e-commerce optimization.
What ImageObject Schema Includes
SEO Benefits You Get
Ready to validate your ImageObject schema? Test your image content and media markup.
✓Validate Imageobject Schema→JSON-LD Example
{
"@context": "https://schema.org",
"@type": "ImageObject",
"@id": "https://example.com/images/professional-camera-main.jpg",
"url": "https://example.com/images/professional-camera-main.jpg",
"name": "Professional DSLR Camera - Canon EOS R5 Main Product Image",
"description": "High-resolution product photograph of the Canon EOS R5 professional DSLR camera showing the camera body, lens, and key features from multiple angles",
"caption": "Canon EOS R5 professional mirrorless camera with RF 24-70mm f/2.8L IS USM lens",
"alternateName": [
"Canon EOS R5 product photo",
"Canon R5 camera main image",
"Professional DSLR camera photograph"
],
"width": 2000,
"height": 1333,
"image": {
"@type": "ImageObject",
"url": "https://example.com/images/professional-camera-thumbnail.jpg",
"width": 400,
"height": 267,
"representativeOfPage": false
},
"thumbnail": {
"@type": "ImageObject",
"url": "https://example.com/images/professional-camera-thumb.jpg",
"width": 150,
"height": 100
},
"contentUrl": "https://example.com/images/professional-camera-main.jpg",
"encodingFormat": "image/jpeg",
"fileFormat": "image/jpeg",
"contentSize": "2.4MB",
"uploadDate": "2024-01-15T10:30:00-08:00",
"dateModified": "2024-01-15T14:45:00-08:00",
"acquireLicensePage": "https://example.com/licensing",
"creditText": "Photo by John Smith Photography",
"creator": {
"@type": "Person",
"name": "John Smith",
"jobTitle": "Senior Product Photographer",
"worksFor": {
"@type": "Organization",
"name": "Example Corp Product Photography"
}
},
"copyrightHolder": {
"@type": "Organization",
"name": "Example Corp",
"url": "https://example.com"
},
"license": "https://creativecommons.org/licenses/by-sa/4.0/",
"acquireLicensePage": "https://example.com/image-licensing",
"about": [
{
"@type": "Product",
"name": "Canon EOS R5",
"brand": {
"@type": "Brand",
"name": "Canon"
},
"category": "Digital Cameras"
},
{
"@type": "Thing",
"name": "Professional Photography",
"description": "High-end digital photography equipment for professional photographers"
}
],
"isPartOf": {
"@type": "WebPage",
"@id": "https://example.com/products/canon-eos-r5",
"url": "https://example.com/products/canon-eos-r5",
"name": "Canon EOS R5 Professional Camera"
},
"mainEntityOfPage": {
"@type": "Product",
"@id": "https://example.com/products/canon-eos-r5"
},
"representativeOfPage": true,
"associatedArticle": {
"@type": "Article",
"@id": "https://example.com/guides/canon-eos-r5-review"
},
"keywords": [
"Canon EOS R5",
"professional camera",
"DSLR camera",
"mirrorless camera",
"product photography",
"camera equipment"
],
"exifData": {
"@type": "PropertyValue",
"name": "Camera Model",
"value": "Canon EOS R5"
},
"locationCreated": {
"@type": "Place",
"name": "Example Corp Photography Studio",
"address": {
"@type": "PostalAddress",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US"
}
}
}Breaking Down the Structure
@type: Must be "ImageObject"url: Direct image URLwidth/height: Image dimensionsencodingFormat: File type (MIME)
name: Descriptive titledescription: Detailed captionabout: What the image depictskeywords: Searchable terms
Practical Use Cases
🛍️ E-commerce Product Images
Product photography uses ImageObject schema to provide detailed product information, specifications, and licensing terms directly in image search results.
Impact: Customers can see detailed product information and licensing terms directly in Google Images, improving conversion rates and reducing support queries.
📷 Photography & Stock Images
Professional photographers and stock image sites use ImageObject schema to provide copyright information, licensing terms, and technical metadata.
Impact: Images become more discoverable in relevant searches while protecting intellectual property and providing clear licensing information.
📰 News & Article Images
News organizations and blogs use ImageObject schema to provide context for article images, improving image search relevance and rich results appearance.
Impact: Article images appear more prominently in image search and provide better context for users browsing visual content.
Common Mistakes & How to Avoid Them
❌ Wrong Image URLs
Mistake: Using relative URLs, placeholder images, or URLs that don't match the actual image location.
Fix: Always use absolute URLs that exactly match the image src attribute. Test that URLs are accessible and return the correct image file.
❌ Inaccurate Dimensions
Mistake: Specifying wrong width and height values that don't match the actual image dimensions.
Fix: Check actual image dimensions using browser dev tools or image editing software. Provide accurate measurements for proper display optimization.
⚠️ Missing Alt Text Relationship
Mistake: ImageObject schema name/description doesn't correspond to the image's alt text attribute.
Fix: Ensure the ImageObject name and description align with the img alt attribute. This creates consistency across different accessibility and search contexts.
⚠️ Over-complicating Context
Mistake: Including too many unrelated "about" entities that dilute the image's primary subject matter.
Fix: Focus the "about" property on the image's main subject. Add secondary associations only when they genuinely relate to the image content.
SEO Tip: Image Licensing & Copyright
Clear licensing information in ImageObject schema helps search engines understand usage rights and improves image attribution in search results.
Validate Your Image Object Schema
Test your ImageObject schema implementation to ensure proper image metadata and search optimization.
Our comprehensive validation tool
Official Google testing tool
Additional JSON-LD Examples
Photography Portfolio Image
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "ImageObject",
"@id": "https://example.com/photography/golden-gate-sunset/#image",
"name": "Golden Gate Bridge at Sunset",
"description": "Stunning sunset photograph of the Golden Gate Bridge with dramatic lighting and fog rolling in from the Pacific Ocean",
"url": "https://example.com/photography/golden-gate-sunset.jpg",
"contentUrl": "https://example.com/photography/golden-gate-sunset.jpg",
"license": "https://creativecommons.org/licenses/by-nc/4.0/",
"acquireLicensePage": "https://example.com/photography/licensing",
"creditText": "Photo by Marcus Rodriguez Photography",
"creator": {
"@type": "Person",
"name": "Marcus Rodriguez",
"jobTitle": "Professional Photographer",
"sameAs": "https://www.instagram.com/marcusrodriguezphoto"
},
"copyrightHolder": {
"@type": "Person",
"name": "Marcus Rodriguez"
},
"width": 4000,
"height": 2667,
"fileFormat": "image/jpeg",
"caption": "The iconic Golden Gate Bridge bathed in the warm glow of a San Francisco sunset, with the city skyline visible in the background",
"representativeOfPage": true,
"contentLocation": {
"@type": "Place",
"name": "Golden Gate Bridge",
"address": {
"@type": "PostalAddress",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": "37.8199",
"longitude": "-122.4783"
}
},
"exifData": [
{
"@type": "PropertyValue",
"name": "Camera Model",
"value": "Canon EOS 5D Mark IV"
},
{
"@type": "PropertyValue",
"name": "Lens",
"value": "EF 24-70mm f/2.8L II USM"
},
{
"@type": "PropertyValue",
"name": "Focal Length",
"value": "35mm"
},
{
"@type": "PropertyValue",
"name": "Aperture",
"value": "f/8"
},
{
"@type": "PropertyValue",
"name": "Shutter Speed",
"value": "1/125"
},
{
"@type": "PropertyValue",
"name": "ISO",
"value": "100"
}
],
"thumbnail": {
"@type": "ImageObject",
"url": "https://example.com/photography/golden-gate-sunset-thumb.jpg",
"width": 400,
"height": 267
},
"datePublished": "2024-01-15T00:00:00Z",
"dateModified": "2024-01-15T00:00:00Z",
"associatedArticle": {
"@type": "Article",
"@id": "https://example.com/guides/golden-gate-photography-tips/#article",
"headline": "Photography Tips: Capturing the Golden Gate Bridge"
},
"about": [
{
"@type": "Place",
"name": "Golden Gate Bridge",
"description": "Iconic suspension bridge connecting San Francisco to Marin County"
},
{
"@type": "City",
"name": "San Francisco",
"description": "Major city in Northern California known for its landmarks and cultural significance"
}
],
"keywords": ["Golden Gate Bridge", "sunset photography", "San Francisco", "landscape photography", "landmarks"],
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/photography/golden-gate-sunset"
}
}
</script>Stock Photo Image
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "ImageObject",
"@id": "https://example.com/stock/business-meeting-teamwork/#image",
"name": "Business Meeting Teamwork",
"description": "Professional business team collaborating in a modern office setting. Diverse group of colleagues working together on a project with laptops and documents.",
"url": "https://example.com/stock/business-meeting-teamwork.jpg",
"contentUrl": "https://example.com/stock/business-meeting-teamwork.jpg",
"license": "https://example.com/stock/license",
"acquireLicensePage": "https://example.com/stock/purchase/business-meeting-teamwork",
"creditText": "StockPhoto Inc.",
"creator": {
"@type": "Organization",
"name": "StockPhoto Inc.",
"url": "https://example.com"
},
"copyrightHolder": {
"@type": "Organization",
"name": "StockPhoto Inc."
},
"width": 3000,
"height": 2000,
"fileFormat": "image/jpeg",
"caption": "A diverse team of business professionals engaged in collaborative work around a conference table in a bright, modern office",
"keywords": ["business meeting", "teamwork", "corporate", "office", "collaboration", "business people", "meeting room"],
"associatedMedia": [
{
"@type": "ImageObject",
"name": "Business Meeting Teamwork - PNG",
"contentUrl": "https://example.com/stock/business-meeting-teamwork.png",
"fileFormat": "image/png",
"width": 3000,
"height": 2000
},
{
"@type": "ImageObject",
"name": "Business Meeting Teamwork - WebP",
"contentUrl": "https://example.com/stock/business-meeting-teamwork.webp",
"fileFormat": "image/webp",
"width": 3000,
"height": 2000
}
],
"thumbnail": [
{
"@type": "ImageObject",
"url": "https://example.com/stock/business-meeting-teamwork-thumb-400.jpg",
"width": 400,
"height": 267
},
{
"@type": "ImageObject",
"url": "https://example.com/stock/business-meeting-teamwork-thumb-200.jpg",
"width": 200,
"height": 133
}
],
"about": [
{
"@type": "DefinedTerm",
"name": "Business Meeting",
"description": "Gathering of business professionals to discuss and work on projects"
},
{
"@type": "DefinedTerm",
"name": "Teamwork",
"description": "Collaborative effort by a group to achieve a common goal"
},
{
"@type": "DefinedTerm",
"name": "Corporate Culture",
"description": "Values, behaviors, and practices that characterize an organization"
}
],
"datePublished": "2023-06-15T00:00:00Z",
"contentSize": "2457600",
"encodingFormat": "image/jpeg",
"isFamilyFriendly": true,
"usageInfo": "https://example.com/stock/terms",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/stock/business-meeting-teamwork"
}
}
</script>SEO & Rich Results Notes
SEO Benefits
ImageObject schema enhances image discoverability and search visibility:
- • Rich image metadata for better search engine understanding
- • Enhanced visibility in Google Images search results
- • Improved image licensing and attribution information
- • Better targeting for visual content and image searches
- • Enhanced accessibility and image context provision
Rich Results Eligibility
ImageObject schema enables enhanced image displays:
- • Detailed image information in Google Images
- • Licensing and usage information display
- • Caption and description integration
- • Creator and copyright attribution
- • Technical image metadata display
Reference: Google's Search Central recommends ImageObject markup for enhanced image search appearance and metadata provision.
Important Warnings
- Copyright Compliance: Only markup images you have rights to describe. Respect copyright and licensing agreements for image content.
- URL Accuracy: Image URLs must be functional and direct to the actual image file. Broken image links harm user experience and search visibility.
- Licensing Clarity: Clearly specify usage rights and licensing terms. Misleading licensing information can result in legal issues.
- Content Accuracy: Captions and descriptions must accurately represent the image content. Misleading image metadata harms user trust.
Official Documentation
- Schema.org: ImageObject specification
- Google Search Central: Structured Data Guidelines
- Rich Results Test: Validate ImageObject markup
Frequently Asked Questions
What is ImageObject schema used for?
ImageObject schema describes images, photographs, and visual content on the web. It provides metadata about image files including dimensions, licensing, captions, and relationships to help search engines understand and display images properly.
How do I add ImageObject schema to my images?
Add JSON-LD structured data with required properties like contentUrl and url. Include optional properties like name, caption, width, height, and license for enhanced image metadata.
What are the required properties for ImageObject schema?
The only required property is url (image URL). However, for rich results eligibility, you'll typically need contentUrl and descriptive information like name or caption.
Does ImageObject schema enable rich results?
Yes! ImageObject schema enables rich image displays in Google Images and can enhance image search results with metadata like captions, licensing, and context information.
How do I specify image licensing and copyright?
Use license property for Creative Commons licenses or copyright information. Include acquireLicensePage for licensing details and creditText for attribution requirements.
Can ImageObject schema include technical image information?
Yes, include width, height, fileFormat (e.g., "image/jpeg"), and exifData for camera settings, location, and other technical metadata.
What's the difference between ImageObject and image properties in other schemas?
ImageObject is a standalone schema for individual images, while image properties in other schemas (like Article, Product) reference images. Use ImageObject for dedicated image galleries or detailed image metadata.
How do I add image captions and alt text?
Use caption for image descriptions and accessibility information. Include representativeOfPage for images that represent the main content of a page.
Can ImageObject schema include thumbnail information?
Yes, use thumbnail property with Thumbnail schema for smaller preview images. Include thumbnailUrl for direct thumbnail access.
How do I handle multiple image formats?
Use associatedMedia array for different formats or resolutions of the same image. Include fileFormat and contentSize for each version.
Does ImageObject schema help with Google Images?
Yes, ImageObject schema provides rich metadata that helps images appear in Google Images search with proper captions, licensing, and context information.
How do I add image location and geolocation data?
Use contentLocation with Place schema for where the image was taken. Include geo coordinates and location names for geographical context.
How often should I update ImageObject schema?
Update when images change, URLs are modified, or licensing information updates. Keep captions and metadata current for ongoing search visibility.
Related Schema Types
Related: Article, Product, Recipe, CreativeWork, Place, Organization