Hướng dẫn về ImageObject Schema

Tóm tắt — ImageObject là way để mô tả image để các công cụ tìm kiếm với nhiều hơn hơn chỉ của nó web address — ai owns nó, Cách nó có thể là licensed, của nó caption. phần lớn của time bạn không cần nó: Khi piece của schema asks cho image, đơn giản URL là đủ. bạn reach cho đầy đủ ImageObject Khi bạn muốn để attach đó extra information — phần lớn commonly để earn “Licensable” badge trong Google Images.

Điều gì ImageObject là

Khi bạn thêm dữ liệu có cấu trúc để trang, bạn’re labeling của bạn nội dung so các công cụ tìm kiếm understand nó. ImageObject là schema.org loại đó labels * image* — không words on trang, nhưng picture, described as dữ liệu machine có thể đọc.

Ở đây part gần như mỗi hướng dẫn skips: ImageObject là rarely được sử dụng on của nó own. Của nó thực job là để là giá trị của một loại image thuộc tính. Khi bạn mark lên sản phẩm, bài viết, hoặc recipe, mỗi của những điều đó có spot cho image. bạn có thể fill đó spot hai ways:

• Với một đơn giản URL — chỉ đó web address of đó picture. Này là all bạn cần hầu hết of đó time.
• Với một đầy đủ ImageObject — khi bạn muốn để chẳng hạn hơn “here’s the file,” (bản dịch) «ở đây đó file,» như ai took đó photo hoặc cách ai đó có thể license điều này.

So think of ImageObject ít hơn as “a thing that gets its own search result” (bản dịch) «một điều đó nhận của nó own tìm kiếm kết quả» và hơn as “a richer way to describe the image inside some other piece of schema.” (bản dịch) «một richer way để mô tả đó image bên trong some other piece of schema.»

Khi bạn thực ra cần đầy đủ version

bạn upgrade từ đơn giản URL để đầy đủ ImageObject Khi bạn muốn để attach metadata về image itself — phần lớn thường cho licensing. nếu bạn’re photographer, stock agency, hoặc publisher ai wants của bạn images để hiển thị Licensable badge trong Google Images ( nhỏ label đó links để nơi mọi người có thể buy license), đó badge là main reason để bother với đầy đủ ImageObject.

single thuộc tính đó unlocks đó badge là license — link để của bạn licensing terms. Bạn có thể thêm nhiều hơn (ai đã tạo image, credit line, copyright notice), nhưng license là một đó flips chuyển.

điều phần lớn mọi người nhận sai

ImageObject không earn của nó own rich kết quả. có không “image card” nó produces. nó either feeds một loại eligibility (như recipe rich kết quả) hoặc nó unlocks tách biệt Licensable badge — đó nó.

Và là very skeptical of bất kỳ hướng dẫn promising một cụ thể traffic hoặc nhấp number từ thêm image schema (“+30% clicks!” (bản dịch) «+30% clicks!»). I’ve looked tại nơi những numbers come từ, và đó honest câu trả lời là nowhere — họ là bịa ra. Schema là worth đang làm, nhưng không làm một đã làm-lên percentage.

Muốn deep version — chính xác properties, Cách Licensable badge hoạt động, Vì sao Recipe images không control của bạn thumbnail, và Sản phẩm-image myth? Chuyển để Nâng cao tab.

Tóm tắt — ImageObject (Thing > CreativeWork > MediaObject > ImageObject) là primarily nested giá trị loại, không standalone đích schema. nó giá trị của Product.image, Article.image, Recipe.image, Organization.logo, WebPage.primaryImageOfPage. đơn giản URL hoạt động Khi bạn không cần metadata; upgrade để đầy đủ object cho licensing/attribution. Licensable-badge recipe là contentUrl + ít nhất một của creator/creditText/copyrightNotice/license — nhưng license cụ thể là Điều gì làm badge eligible. sử dụng contentUrl over url (Google calls nó nhiều hơn precise). Hai commonly-missed facts: Recipe image là bắt buộc nhưng có không impact on của bạn text-kết quả thumbnail (Google, June 2025), và Sản phẩm image là không trong Google formal bắt buộc/được khuyến nghị lists. nó không xếp hạng factor — giống nhau gián tiếp story as all schema.

nơi ImageObject sits, và Cách nó thực ra được sử dụng

On schema.org, ImageObject sits trong hierarchy as Thing > CreativeWork > MediaObject > ImageObject. đó lineage là toàn bộ story của nó properties: nó inherits licensing và attribution các trường từ CreativeWork (license, acquireLicensePage, creditText, copyrightNotice, creator, author) và file các trường từ MediaObject (contentUrl, encodingFormat, height, width, contentSize, uploadDate), plus một vài của nó own như caption và exifData.

nó nhận được sử dụng hai ways:

• Standalone — trên một trang whose toàn bộ point là describing một image ( photo-licensing landing trang). reason để làm Đây là gần như luôn Licensable badge.
• Nested — as giá trị của một loại image, logo, hoặc primaryImageOfPage thuộc tính. Đây là by far nhiều hơn phổ biến case, và nó Vì sao ImageObject là best được diễn đạt as utility loại CreativeWork subtypes âm thầm phụ thuộc on thay vì schema loại bạn point mọi người tại. (nó thematic cousin của creative-hoạt động schema bucket — Bài viết, Recipe, và VideoObject all lean on ImageObject qua của họ image properties không có bao giờ đang làm nó của họ headline.)

Đó key mental unlock: schema.org và Google cả hai accept “a URL or a fully described ImageObject” (bản dịch) «một URL hoặc một fully described ImageObject» cho an image thuộc tính. MỘT bare URL string là một perfectly hợp lệ ImageObject giá trị. Bạn chỉ pay đó cost of đó đầy đủ object khi bạn có metadata worth attaching.

cốt lõi properties

contentUrl so với url — sử dụng contentUrl

Cả hai point tại đó image file, nhưng Google là rõ ràng về mà để ưu tiên. Từ đó image-metadata tài liệu: Google dùng contentUrl “to determine which image the photo metadata applies to.” (bản dịch) «để determine mà image đó photo metadata áp dụng để.» Và on đó lựa chọn giữa đó hai: “While the url property is not as precise and we recommend you use contentUrl instead, existing markup may still use url.” (bản dịch) «Trong khi đó url thuộc tính không phải as precise và we khuyến nghị bạn dùng contentUrl thay vì, existing markup có thể vẫn dùng url.» Translation: contentUrl pins xuống mà image đó metadata mô tả; url là một looser legacy fallback đó vẫn hoạt động nhưng không nên là của bạn default.

license và acquireLicensePage — Licensable pair

Này là đó part với một visible payoff. license links để một trang describing đó image licensing terms; acquireLicensePage links để nơi ai đó có thể thực ra buy một license. They pair naturally — một says “here are the terms,” (bản dịch) «ở đây là đó terms,» đó other says “here’s where to buy one” (bản dịch) «ở đây nơi để buy một» — nhưng họ là không equal trong weight, mà đó tiếp theo section covers.

creator, creditText, copyrightNotice — attribution trio

Những credit đó image. Một nuance worth giữ: creator không nhất thiết một person. Google doc: “This is usually the photographer, but it may be a company or organization (if appropriate).” (bản dịch) «Này là thường đó photographer, nhưng điều này có thể là một company hoặc organization (nếu appropriate).»

caption, exifData, height/width, thumbnail

Descriptive và kỹ thuật metadata. hữu ích, occasionally surfaced, nhưng none của them trigger tìm kiếm feature on của họ own.

Getting Licensable badge

Đây là một chính xác recipe worth memorizing, vì requirement là subtle.

Đó bắt buộc structure: bạn cần contentUrl, và ít nhất một of creator, creditText, copyrightNotice, hoặc license. Google doc: “In addition to contentUrl, you must include one of the following properties: creator, creditText, copyrightNotice, license. Once you include one of these properties, the other three properties become recommended in the Rich Results Test.” (bản dịch) «Ngoài ra để contentUrl, bạn phải bao gồm một of đó sau properties: creator, creditText, copyrightNotice, license. Khi bạn bao gồm một of những properties, đó other three properties become được khuyến nghị trong đó Rich Kết quả Kiểm thử.»

Nhưng đó badge itself có một stricter trigger. Passing validation không phải đó giống nhau as đang badge-eligible. Google: “If you’re using structured data to specify an image, you must include the license property for your image to be eligible to be shown with the Licensable badge.” (bản dịch) «Nếu bạn là dùng dữ liệu có cấu trúc để specify an image, bạn phải bao gồm đó license thuộc tính cho của bạn image để là eligible để là shown với đó Licensable badge.» So creator hoặc creditText alone sẽ validate fine — và nhận bạn không badge. Đó license thuộc tính là đó chuyển. Google adds: “We recommend that you also add the acquireLicensePage property if you have that information.” (bản dịch) «We khuyến nghị đó bạn cũng thêm đó acquireLicensePage thuộc tính nếu bạn có đó information.»

Dữ liệu có cấu trúc không đó chỉ path. IPTC embedded photo metadata là an equally hợp lệ way để earn đó giống nhau eligibility — không schema.org markup bắt buộc tại all. Nhưng nếu bạn dùng cả hai và they disagree, Google là rõ ràng về đó tiebreaker: “If you choose to use both IPTC photo metadata and structured data, and if any information conflicts between the two, Google will use the structured data information.” (bản dịch) «Nếu bạn chọn để dùng cả hai IPTC photo metadata và dữ liệu có cấu trúc, và nếu bất kỳ information conflicts giữa đó hai, Google sẽ dùng đó dữ liệu có cấu trúc information.» đó là đó reverse of điều gì một lot of mọi người assume (đó file embedded metadata là đó hơn “authoritative” (bản dịch) «có thẩm quyền» nguồn).

Một policy đó catches mọi người: đó image URL có để là reachable. Google structured-dữ liệu policies chẳng hạn “All image URLs specified in structured data must be crawlable and indexable” (bản dịch) «All image URLs specified trong dữ liệu có cấu trúc phải được crawlable và indexable» — block đó image host trong robots.txt và đó toàn bộ điều silently fails.

ImageObject bên trong cụ thể types

Recipe — bắt buộc, và June 2025 clarification

Cho Recipe, image là bắt buộc, và điều này có real hướng dẫn: crawlable và indexable, phải represent đó dish, và Google “recommend[s] providing multiple high-resolution images (minimum of 50K pixels when multiplying width and height) with the following aspect ratios: 16x9, 4x3, and 1x1.” (bản dịch) «khuyến nghị[s] providing multiple cao-resolution images (minimum of 50K pixels khi multiplying width và height) với đó sau aspect ratios: 16x9, 4x3, và 1x1.»

Ở đây đó counterintuitive part hầu hết các hướng dẫn haven’t caught lên để. As of một June 2025 doc cập nhật, Google trạng thái plainly: “Specifying the image property in Recipe markup has no impact on the image chosen for a text result image.” (bản dịch) «Specifying đó image thuộc tính trong Recipe markup có không impact on đó image chosen cho một text kết quả image.» Nói cách khác, của bạn Recipe image governs recipe rich-kết quả eligibility — không đó thumbnail đó cho thấy tiếp theo để của bạn thông thường blue-link kết quả. đó là một tách biệt hệ thống hoàn toàn (covered dưới). Barry Schwartz reported này thay đổi tại Search Engine Land on June 5, 2025.

Sản phẩm — không formally bắt buộc ( myth-bust)

Gần như mọi người asserts đó images là “bắt buộc” cho Sản phẩm rich kết quả. họ’re không — ít nhất không theo Google được ghi lại lists. sản phẩm-snippet doc formal Bắt buộc properties là name plus một của review/aggregateRating/offers; Được khuyến nghị list là aggregateRating, offers, review. image thuộc tính xuất hiện chỉ bên trong worked các ví dụ, không bao giờ trong bắt buộc/được khuyến nghị các bảng. Thêm sản phẩm images anyway — listing không có photo converts tệ hơn — nhưng know đó UX-và-Shopping argument, không được ghi lại schema requirement. (và không conflate nó với Merchant Center tách biệt, stricter sản phẩm-image resolution rules — khác hệ thống từ ImageObject hoàn toàn.)

Bài viết và Organization

cho Bài viết, image là được khuyến nghị thuộc tính đó feeds Bài viết eligibility; nó không produce dedicated image card của nó own. cho Organization.logo, logo có của nó own tách biệt requirements (và là image Google có thể sử dụng cho điều như knowledge-panel và some rich-kết quả branding) — worth marking lên, nhưng nó logo-cụ thể job, không chung ImageObject licensing.

Controlling của bạn Tìm kiếm / Discover thumbnail

Nếu bạn thực ra muốn để influence đó image Google cho thấy as trang của bạn preview, đó là một khác nhau mechanism từ bất kỳ of đó trên — và Google clarified điều này trong một March 2026 tài liệu cập nhật. Từ đó image-SEO best-practices doc: “Google’s selection of an image preview is completely automated and takes into account a number of different sources to select which image on a given page is shown on Google.” (bản dịch) «Google selection of an image preview là completely automated và takes vào account một number of khác nhau sources để select mà image on một được cho trang là shown on Google.»

Three parallel, non-exclusive các tín hiệu feed đó lựa chọn:

1. schema.org primaryImageOfPage thuộc tính on của bạn WebPage.
2. image thuộc tính attached qua mainEntity / mainEntityOfPage.
3. og:image meta tag.

Google hướng dẫn cho all three: “Choose an image that’s relevant and representative of the page. Avoid using a generic image (for example, your site logo) or an image with text in the schema.org markup or og:image meta tag.” (bản dịch) «Chọn an image đó là relevant và representative of đó trang. Tránh dùng một generic image (ví dụ, trang web của bạn logo) hoặc an image với text trong đó schema.org markup hoặc og:image meta tag.» Matt G. Southern covered đó cập nhật tại Search Engine Journal on March 2, 2026, noting đó key point: schema markup và og:image cả hai count — họ là parallel inputs, không an either/hoặc.

C2PA / “About this image” (bản dịch) «Về hình ảnh này» — liền kề, không ImageObject

Một forward-looking sibling worth một mention, rõ ràng scoped as tách biệt từ ImageObject licensing: C2PA nội dung-provenance metadata (embedded trong đó image file, không schema.org). Google: “If an image contains C2PA metadata, Google can extract those details and may show information in the ‘About this image’ feature, such as how the image was created or if it was edited with AI tools.” (bản dịch) «Nếu an image contains C2PA metadata, Google có thể extract những details và có thể cho thấy information trong đó ‘Về hình ảnh này’ feature, such as cách đó image đã là đã tạo hoặc nếu điều này đã là edited với AI tools.» Này là an AI-provenance tín hiệu on đó giống nhau “About this image” (bản dịch) «Về hình ảnh này» surface as licensing info — nhưng điều này lives trong đó file manifest, không trong của bạn ImageObject markup. không fold đó hai together.

là ImageObject xếp hạng factor?

Không — giống nhau gián tiếp story as all dữ liệu có cấu trúc. Đó standing Google position (Gary Illyes, John Mueller) là đó schema helps engines understand nội dung và có thể unlock eligibility cho features, nhưng điều này không một trực tiếp xếp hạng input. Cho ImageObject cụ thể, đó wins là concrete nhưng hẹp: đó Licensable badge (qua license), rich-kết quả eligibility cho parent types như Recipe (qua một hợp lệ image), và thumbnail-selection input (qua primaryImageOfPage). None of những là “rank higher,” (bản dịch) «xếp hạng cao hơn,» và Google own khắc phục sự cố hướng dẫn là rõ ràng đó ngay cả một fully hợp lệ image-metadata block không guaranteed để display. Đó giống nhau reviewed sources không establish an AI-citation effect từ ImageObject either — I haven’t được tìm thấy một nguồn đó cho thấy điều này improves của bạn odds of đang cited trong an AI câu trả lời. Anyone selling bạn một cụ thể percentage traffic lift từ image schema là quoting một number đó traces để không nguồn.

phổ biến mistakes

• Dùng url thay vì contentUrl. Cả hai hoạt động; Google prefers contentUrl as hơn precise.
• Forgetting license cụ thể. Đó other three attribution properties validate nhưng không trigger đó Licensable badge.
• Assuming Recipe image controls của bạn text-kết quả thumbnail. Điều này không (Google, June 2025) — điều này chỉ ảnh hưởng recipe rich-kết quả eligibility.
• Assuming Sản phẩm images là formally bắt buộc schema. họ là không trong Google được ghi lại lists (vẫn thêm them cho UX/Shopping).
• Blocking đó image URL. MỘT robots.txt-disallowed hoặc noindexed image host có nghĩa là đó markup silently fails Google crawlable-và-indexable requirement.
• Repeating bịa ra performance số liệu. Nearly mỗi competing hướng dẫn cites an uncited “+X% CTR/traffic” (bản dịch) «+X% CTR/traffic» hình. None trace để một nguồn.

nơi điều này fits

ImageObject là một deep dive trong đó structured-dữ liệu sub-cluster, alongside của nó sibling schema-loại các bài viết (article-schema, recipe-schema, product-schema, videoobject-schema, organization-schema). Thematically đây là đó utility loại đó creative-hoạt động schema family leans on, và điều này lives dưới đó Dữ liệu có cấu trúc cho SEO hub. Cho đó rộng hơn picture of alt text, formats, image sitemaps, và lazy-loading, đó là một tách biệt image-SEO topic; này bài viết là cụ thể đó “how do I describe an image as data” (bản dịch) «cách làm I mô tả an image as dữ liệu» piece những others âm thầm phụ thuộc on.

AI summary

condensed take on Nâng cao version:

• ImageObject là một nested giá trị loại, không một standalone rich kết quả. Hierarchy: Thing > CreativeWork > MediaObject > ImageObject. đây là đó giá trị of Product.image, Article.image, Recipe.image, Organization.logo, WebPage.primaryImageOfPage. MỘT đơn giản URL là một hợp lệ image giá trị; upgrade để một đầy đủ object chỉ khi bạn có metadata để attach.
• Licensable badge recipe: contentUrl + ít nhất một of creator/creditText/copyrightNotice/license để validate — nhưng đó license thuộc tính cụ thể là điều gì làm đó badge eligible. Thêm acquireLicensePage cũng nếu bạn có điều này.
• contentUrl over url — Google says contentUrl là hơn precise cho pinning xuống mà image đó metadata mô tả; url là một legacy fallback.
• IPTC là an equal alternative path để đó giống nhau eligibility — nhưng nếu IPTC và dữ liệu có cấu trúc conflict, Google dùng đó dữ liệu có cấu trúc.
• Recipe: image là bắt buộc (50K px² min; 16x9/4x3/1x1) nhưng có không impact on của bạn text-kết quả thumbnail (Google clarified June 2025).
• Sản phẩm: image là không trong Google formal bắt buộc/được khuyến nghị lists — thêm điều này anyway cho UX/Shopping, nhưng đây là không một được ghi lại schema requirement.
• Thumbnail control là một tách biệt March 2026 mechanism: primaryImageOfPage, main-entity image, và og:image as three parallel các tín hiệu.
• C2PA feeds “About this image” (bản dịch) «Về hình ảnh này» (AI-provenance) nhưng lives trong đó file, không trong ImageObject markup — không conflate.
• Không phải là yếu tố xếp hạng — gián tiếp nhiều nhất, display itself không guaranteed, và không nguồn establishes an AI-citation effect either; bỏ qua bịa ra “+X%” số liệu.

Tài liệu chính thức

Chính-nguồn tài liệu từ Google và schema.org.

Google

• Image Metadata (Google Images SEO) — đó cốt lõi ImageObject/licensing doc: bắt buộc properties, contentUrl so với url, đó license/Licensable-badge rule, IPTC-so với-structured-dữ liệu conflicts, và C2PA.
• Dữ liệu có cấu trúc Chung Guidelines — đó crawlable-và-indexable và relevance requirements đó apply để bất kỳ image trong dữ liệu có cấu trúc.
• Recipe dữ liệu có cấu trúc — image bắt buộc, đó size/aspect-ratio hướng dẫn, và đó “no impact on the text-result image” (bản dịch) «không impact on đó text-kết quả image» clarification.
• Sản phẩm snippet dữ liệu có cấu trúc — đó formal Bắt buộc/Được khuyến nghị thuộc tính lists (note image là trong neither).
• Image SEO thực hành tốt nhất — primaryImageOfPage, main-entity image, và og:image as thumbnail-selection các tín hiệu.

schema.org

• ImageObject — loại definition, hierarchy (Thing > CreativeWork > MediaObject > ImageObject), và đầy đủ thuộc tính list.
• contentUrl · license · acquireLicensePage — properties Google licensing hướng dẫn leans on.

Quotes từ nguồn

On—record statements từ Google. mỗi link là deep link đó jumps để quoted passage on nguồn trang.

Google — contentUrl so với URL

• “Google uses contentUrl to determine which image the photo metadata applies to.” (bản dịch) «Google dùng contentUrl để determine mà image đó photo metadata áp dụng để.» — Google Search Central tài liệu. Nhảy đến trích dẫn
• “While the url property is not as precise and we recommend you use contentUrl instead, existing markup may still use url.” (bản dịch) «Trong khi đó url thuộc tính không phải as precise và we khuyến nghị bạn dùng contentUrl thay vì, existing markup có thể vẫn dùng url.» Nhảy đến trích dẫn

Google — bắt buộc structure và Licensable-badge trigger

• “In addition to contentUrl, you must include one of the following properties: creator, creditText, copyrightNotice, license.” (bản dịch) «Ngoài ra để contentUrl, bạn phải bao gồm một of đó sau properties: creator, creditText, copyrightNotice, license.» Nhảy đến trích dẫn
• “If you’re using structured data to specify an image, you must include the license property for your image to be eligible to be shown with the Licensable badge.” (bản dịch) «Nếu bạn là dùng dữ liệu có cấu trúc để specify an image, bạn phải bao gồm đó license thuộc tính cho của bạn image để là eligible để là shown với đó Licensable badge.» Nhảy đến trích dẫn
• “We recommend that you also add the acquireLicensePage property if you have that information.” (bản dịch) «We khuyến nghị đó bạn cũng thêm đó acquireLicensePage thuộc tính nếu bạn có đó information.» Nhảy đến trích dẫn

Google — IPTC so với dữ liệu có cấu trúc, và creator

• “If you choose to use both IPTC photo metadata and structured data, and if any information conflicts between the two, Google will use the structured data information.” (bản dịch) «Nếu bạn chọn để dùng cả hai IPTC photo metadata và dữ liệu có cấu trúc, và nếu bất kỳ information conflicts giữa đó hai, Google sẽ dùng đó dữ liệu có cấu trúc information.» Nhảy đến trích dẫn
• On creator: “This is usually the photographer, but it may be a company or organization (if appropriate).” (bản dịch) «Này là thường đó photographer, nhưng điều này có thể là một company hoặc organization (nếu appropriate).» Nhảy đến trích dẫn

Google — image policy, Recipe, và thumbnail selection

• “All image URLs specified in structured data must be crawlable and indexable.” (bản dịch) «All image URLs specified trong dữ liệu có cấu trúc phải được crawlable và indexable.» Nhảy đến trích dẫn
• “Specifying the image property in Recipe markup has no impact on the image chosen for a text result image.” (bản dịch) «Specifying đó image thuộc tính trong Recipe markup có không impact on đó image chosen cho một text kết quả image.» Nhảy đến trích dẫn
• “Specify the schema.org primaryImageOfPage property with a URL or ImageObject.” (bản dịch) «Specify đó schema.org primaryImageOfPage thuộc tính với một URL hoặc ImageObject.» Nhảy đến trích dẫn

Đơn giản URL hoặc đầy đủ ImageObject? và mà feature am I ngay cả sau khi?

Đó hầu hết phổ biến real câu hỏi với ImageObject không “how do I write it” (bản dịch) «cách làm I ghi điều này» — đây là “do I need the full object at all, and if so, why.” (bản dịch) «làm I cần đó đầy đủ object tại all, và nếu so, vì sao.» Câu trả lời cho đó image bạn là marking lên.

ImageObject — bảng tra nhanh

Standalone so với. nested

** Licensable-badge recipe**

contentUrl so với URL

Image thuộc tính by parent loại

Fast facts

• Hierarchy: Thing > CreativeWork > MediaObject > ImageObject.
• Không phải là yếu tố xếp hạng — earns eligibility, không xếp hạng.
• IPTC là an equal path để đó badge; on conflict, dữ liệu có cấu trúc wins.
• Image URLs phải được crawlable và indexable hoặc đó markup fails silently.
• Thumbnail control = primaryImageOfPage / main-entity image / og:image (March 2026), một tách biệt mechanism.
• C2PA ≠ ImageObject — đây là file-embedded provenance cho “About this image.” (bản dịch) «Về hình ảnh này.»

Anti-patterns — ImageObject mistakes I see phần lớn

Thêm creator hoặc creditText và expecting Licensable badge. phần lớn phổ biến near-miss. những điều đó validate, nhưng badge là gated on license cụ thể. Credit không có license link earns bạn không có gì visible.

Reaching cho đầy đủ ImageObject Khi URL string sẽ làm. nếu bạn có không metadata để attach, bare URL là đúng giá trị cho image thuộc tính — schema.org và Google cả hai accept nó. Wrapping mỗi image trong đầy đủ object chỉ adds surface area để nhận sai.

sử dụng url vì generator emitted nó. Plenty của tools vẫn output url. nó hoạt động, nhưng Google prefers contentUrl cho precision. Ưu tiên contentUrl trong new markup.

Believing Recipe image sets của bạn tìm kiếm thumbnail. nó bắt buộc cho recipe rich kết quả, nhưng Google explicitly nói nó có không impact on text-kết quả thumbnail. nếu bạn muốn để influence đó image, đó tách biệt job (primaryImageOfPage / og:image).

Treating Sản phẩm images as một bắt buộc schema trường. họ là không trong Google được ghi lại bắt buộc/được khuyến nghị lists. Thêm them cho conversion và Shopping, nhưng không cite “required schema” (bản dịch) «bắt buộc schema» as đó reason — và không confuse này với Merchant Center tách biệt image-resolution rules.

Blocking image host. robots.txt-disallowed hoặc noindexed image URL fails crawlable-và-indexable requirement. markup có thể là perfect và vẫn làm không có gì.

Repeating bịa ra percentage số liệu. “ImageObject schema gives a 30% CTR lift” (bản dịch) «ImageObject schema cho một 30% CTR lift» và friends trace để không nguồn. Schema là worth đang làm on của nó thực tế merits (eligibility, understanding), không một đã làm-lên number.

Conflating C2PA provenance với ImageObject licensing. “About this image” (bản dịch) «Về hình ảnh này» AI-provenance info xuất hiện từ C2PA metadata trong đó file, không từ của bạn schema. Hai khác nhau các hệ thống on đó giống nhau surface.

Implementation các ví dụ

Hai patterns cover gần như mọi thứ: standalone licensing image, và ImageObject nested bên trong parent loại.

1. Standalone photo-licensing image (chasing Licensable badge)

license thuộc tính là Điều gì làm điều này badge-eligible; acquireLicensePage, creator, creditText, và copyrightNotice round nó out.

{
  "@context": "https://schema.org/",
  "@type": "ImageObject",
  "contentUrl": "https://example.com/photos/harbor-at-dawn.jpg",
  "license": "https://example.com/licenses/standard/",
  "acquireLicensePage": "https://example.com/photos/harbor-at-dawn/buy/",
  "creator": {
    "@type": "Person",
    "name": "Alex Rivera"
  },
  "creditText": "Alex Rivera / Example Studio",
  "copyrightNotice": "© 2026 Example Studio",
  "caption": "The harbor at dawn, long exposure",
  "width": 2400,
  "height": 1600
}

2. ImageObject nested bên trong Sản phẩm

Ở đây đó ImageObject là đó giá trị of Product.image. Note đó image không một formally bắt buộc Sản phẩm thuộc tính — này là đó “attach metadata” (bản dịch) «attach metadata» upgrade over một đơn giản URL string.

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Trailhead 30L Backpack",
  "image": {
    "@type": "ImageObject",
    "contentUrl": "https://example.com/products/trailhead-30l.jpg",
    "license": "https://example.com/licenses/product-photography/",
    "creditText": "Example Gear Co."
  },
  "offers": {
    "@type": "Offer",
    "price": "129.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}

3. Khi đơn giản URL là right câu trả lời

nếu bạn có không metadata để attach, không over-engineer nó — bare URL string là hợp lệ image giá trị:

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Trailhead 30L Backpack",
  "image": "https://example.com/products/trailhead-30l.jpg",
  "offers": {
    "@type": "Offer",
    "price": "129.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}

Validate bất kỳ của những điều này trong Rich Kết quả Kiểm thử và schema.org validator trước khi shipping.

Tools cho building và kiểm tra ImageObject markup

kiểm tra nó với Schema Markup Validator: paste của bạn JSON-LD (hoặc đầy đủ HTML trang, hoặc fetch trực tiếp URL) và nó detects ImageObject block — standalone hoặc nested bên trong Product, Article, hoặc Recipe — và flags các vấn đề by severity. nó fastest way để kiểm tra chính xác patterns từ Các ví dụ tab: làm nó catch contentUrl so với. url, là license present (không chỉ creator/creditText/copyrightNotice), và làm nested Product.image parse correctly as ImageObject thay vì bare string Khi bạn meant để attach metadata.

sau đó xác nhận eligibility với Rich-Kết quả Eligibility Checker: validating sạch JSON-LD không phải giống nhau as là eligible cho feature. Chạy URL qua điều này checker để see liệu parent loại (Recipe, Sản phẩm) thực ra các báo cáo as eligible cho của nó rich kết quả — hữu ích since, as covered trong Nâng cao, Sản phẩm image không phải formally bắt buộc thuộc tính và bị thiếu hoặc malformed một có thể silently sit bên ngoài Google bắt buộc/được khuyến nghị lists không có failing validation.

thứ ba-party — Google Rich Kết quả Kiểm thử: nguồn Google itself points để cho Licensable-badge requirements quoted throughout điều này bài viết. sử dụng nó as thứ hai kiểm tra on badge eligibility cụ thể, since đó stricter bar hơn passing basic JSON-LD validation (bạn cần license, không chỉ một của khác three attribution properties).

Validation các kiểm thử — đã làm của bạn ImageObject thay đổi thực ra take effect?

Proof đó cụ thể ImageObject edit shipped correctly, không chỉ đó nó looks right trong nguồn.

Kiểm thử 1 — JSON-LD parses với không các lỗi

• Kiểm thử để chạy — Paste trang JSON-LD (hoặc fetch trực tiếp URL) vào Schema Markup Validator.
• Dự kiến kết quả — ImageObject block (standalone hoặc nested) là detected với không syntax/parse các lỗi, và contentUrl resolves để trường bạn dự kiến.
• thất bại interpretation — parse thất bại thường có nghĩ là templating bug — malformed nested object nơi Product.image nên hold ImageObject nhưng đã nhận hỏng JSON, hoặc stray string nơi object là dự kiến.
• Monitoring window — Immediate.
• Rollback trigger — validator có thể’t detect ImageObject tại all sau khi template deploy — markup không phải kết xuất; roll lại thay đổi.

Kiểm thử 2 — Licensable-badge validation truyền (nhưng kiểm tra stricter trigger)

• Kiểm thử để chạy — Chạy đó giống nhau URL qua đó Schema Markup Validator hoặc Google Rich Kết quả Kiểm thử, kiểm tra cụ thể cho contentUrl plus ít nhất một of creator/creditText/ copyrightNotice/license.
• Dự kiến kết quả — Đó image-metadata block validates với không bắt buộc-thuộc tính các lỗi.
• Failure interpretation — đó “validates but no badge” (bản dịch) «validates nhưng không badge» chế độ: validation passing là không đó giống nhau as badge eligibility. Nếu bạn đã thêm creator hoặc creditText nhưng không license, đó block sẽ validate cleanly và vẫn không bao giờ cho thấy đó Licensable badge — Google doc là rõ ràng đó license cụ thể là đó trigger. không đọc một validation truyền as xác nhận đó badge sẽ xuất hiện.
• Monitoring window — Immediate cho validation; đó Licensable badge itself có thể take lâu hơn để surface trong Google Images sau một successful crawl, so cho phép vài weeks trước concluding đây là bị thiếu.
• Rollback trigger — Nếu license là present, validation truyền, và đó badge vẫn hasn’t appeared sau một reasonable crawl window, kiểm tra rằng đó image URL itself là crawlable và indexable (một robots.txt block on đó image host làm đó markup fail silently) trước assuming đó markup là sai.

Kiểm thử 3 — Recipe eligibility không phải confused với thumbnail control

• Kiểm thử để chạy — cho Recipe các trang, chạy URL qua Rich-Kết quả Eligibility Checker để xác nhận recipe rich kết quả các báo cáo eligible, riêng từ kiểm tra mà image hiển thị tiếp theo để của bạn thông thường text kết quả trong Tìm kiếm.
• Dự kiến kết quả — recipe rich kết quả hiển thị eligible với hợp lệ image present. Riêng, text-kết quả thumbnail là whatever primaryImageOfPage, main-entity image, hoặc og:image selects — không nhất thiết giống nhau image.
• thất bại interpretation — nếu recipe rich kết quả là ineligible, vấn đề là image thuộc tính on Recipe loại itself (bị thiếu, sai aspect ratio, không crawlable). nếu text-kết quả thumbnail looks sai, đó tách biệt tín hiệu hoàn toàn (theo Google June 2025 clarification, Recipe image không control nó) — kiểm tra primaryImageOfPage và og:image thay vì.
• Monitoring window — Rich-kết quả eligibility có thể là checked immediately sau khi thành công crawl; thumbnail selection là automated và có thể take lâu hơn để settle trong trực tiếp kết quả tìm kiếm — cho phép một vài weeks trước khi khắc phục sự cố further.
• Rollback trigger — Recipe rich-kết quả eligibility drops sau khi template thay đổi — roll lại và re-kiểm tra image thuộc tính crawlability và size.

các tài nguyên worth của bạn time

My related writing

• Dữ liệu có cấu trúc: Điều gì nó là và Cách sử dụng nó — my Ahrefs hướng dẫn để schema types, formats, validation, và sameAs entity angle; rộng hơn context ImageObject sits bên trong.
• Người mới bắt đầu Hướng dẫn để kỹ thuật SEO — nơi dữ liệu có cấu trúc (và images) fit vào bigger kỹ thuật picture.

My speaking

• Cách Tìm kiếm Hoạt động (SlideShare) — my walkthrough of crawling, kết xuất, lập chỉ mục, và cách markup feeds understanding. (My standing disclaimer áp dụng: “This is my understanding of systems… not going to be 100% complete or accurate.” (bản dịch) «Này là my understanding of các hệ thống… không going để là 100% hoàn tất hoặc chính xác.»)

Chính thức

• Google Image Metadata doc — canonical ImageObject/licensing reference.
• Google Recipe và Sản phẩm snippet tài liệu — cho bắt buộc/được khuyến nghị thuộc tính realities.
• Google Image SEO thực hành tốt nhất — primaryImageOfPage / og:image thumbnail-selection hướng dẫn.
• schema.org/ImageObject — loại definition và đầy đủ thuộc tính list.

Từ khoảng đó ngành

• Google cập nhật Event và Recipe dữ liệu có cấu trúc (Barry Schwartz, Search Engine Land, June 5, 2025) — đó nguồn cho đó “Recipe image doesn’t affect the text-result thumbnail” (bản dịch) «Recipe image không ảnh hưởng đó text-kết quả thumbnail» clarification.
• Google clarifies cách điều này picks thumbnails cho Tìm kiếm & Discover (Matt G. Southern, Search Engine Journal, March 2, 2026) — đó primaryImageOfPage / main-entity image / og:image thumbnail cập nhật.
• Nhanh hướng dẫn để IPTC Photo Metadata và Google Images (IPTC) — đó IPTC-trường-để-schema.org mapping cho đó alternative licensing path.
• Yoast — đó Image schema piece (Yoast nhà phát triển portal) — một solid kỹ thuật reference cho ImageObject bên trong một JSON-LD @graph, referenced by @id khi đó giống nhau image là reused.
• r/TechSEO — đó community cho structured-dữ liệu và image-markup gỡ lỗi.

Tự kiểm tra: ImageObject Schema

Five nhanh các câu hỏi on Cách ImageObject thực ra hoạt động. Pick câu trả lời cho mỗi, sau đó kiểm tra.

Nhật ký thay đổi