umum data terstruktur Errors (dan cara Perbaiki Them)
data terstruktur errors Google's Rich hasil Test dan Search Console surface sebagian besar — missing diperlukan fields, wrong nilai jenis, konten mismatch, malformed JSON-LD, dan deprecated jenis — dan persis cara debug setiap satu.
data terstruktur errors split ke dua jenis: parsing errors itu break markup entirely (malformed JSON-LD — trailing commas, unescaped quotes, sebuah missing colon atau brace) dan eligibility errors itu parse fine tetapi fail sebuah rich-hasil aturan (missing diperlukan property, wrong nilai jenis, sebuah colliding/duplicate @id, atau markup describing konten tidak terlihat pada halaman). sebuah missing diperlukan property atau unparsable JSON blocks rich hasil outright; sebuah missing recommended property adalah hanya sebuah warning — rich hasil biasanya masih menampilkan, lebih sedikit richly. konten mismatch adalah satu error class dengan nyata teeth: ini adalah sebuah policy violation itu dapat trigger sebuah manual tindakan, tidak hanya silent ineligibility. sebuah distinct failure mode tidak sebuah error di semua — sebuah deprecated/unsupported jenis (FAQ, dihapus oleh dapat 2026) adalah valid markup itu hanya Tidak lebih lama earns sebuah visual. Debug dengan three berbeda alat: Rich hasil Test (Google eligibility + SERP preview, single URL), Schema Markup Validator (schema.org syntax/vocabulary, apa pun jenis), dan Search Console's Rich hasil report (situs-wide, sampled, di atas time) — sebuah lulus di satu jawaban hanya itu alat's own pertanyaan. Memperbaiki errors restores rich-hasil eligibility — data terstruktur tidak sebuah peringkat factor, so sebuah perbaiki wins back sebuah SERP visual, tidak sebuah peringkat.
Bukti untuk klaim ini Google structured data must follow technical, quality, relevance, and feature-specific guidelines; valid syntax alone is insufficient for eligibility. Cakupan: Current Google structured-data policies. Tingkat keyakinan: tinggi · Diverifikasi: Google Search Central: Structured data general guidelines Bukti untuk klaim ini Google recommends Rich Results Test for supported feature validation and URL Inspection for deployed-page status; warnings may preserve eligibility while errors can block it. Cakupan: Current Google structured-data validation workflow. Tingkat keyakinan: tinggi · Diverifikasi: Google Search Central: Generate structured data with JavaScriptTL;DR — sebuah data terstruktur error berarti schema markup pada Anda halaman memiliki sebuah masalah. Either ini adalah ditulis wrong dan mesin pencari dapat’t baca ini di semua, atau ini membaca fine tetapi adalah missing sesuatu Google perlu untuk tampilkan fancy hasil (star ratings, product prices, breadcrumbs). Memperbaiki errors wins back itu fancy hasil — ini melakukan tidak move Anda up di rankings, karena data terstruktur tidak sebuah peringkat factor.
Apa sebuah data terstruktur error adalah
data terstruktur (juga called schema markup) adalah extra code Anda tambahkan untuk sebuah halaman itu tells mesin pencari apa Anda konten berarti — “ini adalah itu price,” (terjemahan) “ini adalah price,” “this is the author,” (terjemahan) “ini adalah author,” “this is the rating.” (terjemahan) “ini adalah rating.” Ketika itu code memiliki sebuah masalah, Anda mendapatkan sebuah data terstruktur error, dan reward ini adalah supposed untuk earn — sebuah richer, lebih eye-catching penelusuran listing called sebuah rich hasil — tidak tampilkan up.
Errors come di dua flavors:
- ** code adalah rusak.** sebuah typo like sebuah extra comma atau sebuah unclosed quote dapat membuat seluruh block unreadable. mesin pencari dapat’t bahkan tell apa Anda adalah trying untuk deskripsikan.
- ** code membaca fine tetapi adalah incomplete atau wrong.** Anda left out sesuatu Google memerlukan (like sebuah product image), atau Anda put text di mana Google yang diharapkan sebuah angka, atau Anda marked up sesuatu itu tidak sebenarnya terlihat pada halaman.
Errors vs. warnings — melakukan I memiliki untuk perbaiki ini hari ini?
ini pembedaan saves sebuah lot dari panic:
- sebuah error berarti sebuah diperlukan piece adalah missing atau rusak. rich hasil dapat’t tampilkan di semua until Anda perbaiki ini.
- sebuah warning berarti sebuah recommended (tetapi opsional) piece adalah missing. rich hasil dapat masih tampilkan — ini adalah hanya sebuah little lebih sedikit menyelesaikan.
So sebuah error adalah “fix this to get the feature,” (terjemahan) “perbaiki ini untuk mendapatkan fitur,” dan sebuah warning adalah “you could make this better.” (terjemahan) “Anda dapat membuat ini better.” Tidak semuanya Google flags adalah urgent.
Di mana Anda’ll see ini errors
Three places, dan orang mix them up constantly:
- ** Rich hasil Test** — Anda paste di satu URL atau sebuah code snippet, dan Google tells Anda apa rich hasil ini ditemukan dan apa pun errors. ini juga previews bagaimana hasil mungkin look.
- Search Console’s Rich hasil report — sebuah ongoing, situs-wide view itu watches untuk errors di seluruh Anda halaman di atas time.
- ** Schema Markup Validator** — jalankan oleh schema.org (tidak Google). ini memeriksa apakah Anda code adalah ditulis correctly, untuk apa pun jenis dari schema, apakah Google menggunakan ini untuk sebuah rich hasil atau tidak.
hal sebagian besar orang mendapatkan wrong
Memperbaiki data terstruktur errors tidak akan membuat Anda peringkat lebih tinggi. data terstruktur tidak sebuah peringkat factor. alasan untuk perbaiki errors adalah untuk win back appearance — stars, price, breadcrumbs — yang dapat mendapatkan Anda lebih clicks. itu’s sebuah nyata benefit, tetapi ini adalah tidak yang sama sebagai peringkat.
Satu lebih: hanya mark up hal itu adalah sebenarnya pada halaman. Describing konten sebuah pengunjung dapat’t see breaks Google’s aturan dan dapat earn Anda sebuah penalty — lebih serious daripada hanya diam-diam losing rich hasil. (Lebih pada itu, plus dua-alat trap dan “why does my markup validate but still not show?” (terjemahan) “mengapa melakukan my markup validate tetapi masih tidak tampilkan?” mystery, di Advanced tab.)
ingin penuh taxonomy dari error jenis, malformed-JSON gotchas, deprecated FAQ situation, dan cara debug setiap satu? Switch untuk Advanced tab.
Bukti untuk klaim ini Google structured data must follow technical, quality, relevance, and feature-specific guidelines; valid syntax alone is insufficient for eligibility. Cakupan: Current Google structured-data policies. Tingkat keyakinan: tinggi · Diverifikasi: Google Search Central: Structured data general guidelines Bukti untuk klaim ini Google recommends Rich Results Test for supported feature validation and URL Inspection for deployed-page status; warnings may preserve eligibility while errors can block it. Cakupan: Current Google structured-data validation workflow. Tingkat keyakinan: tinggi · Diverifikasi: Google Search Central: Generate structured data with JavaScriptTL;DR — data terstruktur errors split ke parsing errors (malformed JSON-LD — trailing commas, unescaped quotes, missing colons atau braces — itu break markup so badly Google dapat’t determine jenis; ini land di Unparsable data terstruktur report) dan eligibility errors ( markup parses tetapi fails sebuah rich-hasil aturan: missing diperlukan property, wrong nilai jenis, atau markup describing konten tidak terlihat pada halaman). Errors dapat block; warnings adalah non-critical — sebuah missing diperlukan property dapat kill fitur eligibility, sementara sebuah missing recommended satu umumnya preserves eligibility tetapi dapat limit tersedia informasi. konten mismatch adalah satu class dengan teeth — sebuah policy violation itu dapat trigger sebuah manual tindakan, tidak silent ineligibility. sebuah terpisah failure mode tidak sebuah error di semua: sebuah deprecated/unsupported jenis (FAQ, hilang oleh dapat 2026) adalah valid markup itu earns Tidak visual. Debug dengan three berbeda alat — Rich hasil Test (Google eligibility + preview), Schema Markup Validator (schema.org syntax, apa pun jenis), dan Search Console’s Rich hasil report (situs-wide, sampled). data terstruktur tidak sebuah peringkat factor, so sebuah perbaiki wins back sebuah SERP visual, tidak sebuah peringkat.
Errors vs. warnings — apa sebenarnya blocks sebuah rich hasil
langkah satu memeriksa apakah JSON-LD parses dan memperbaiki malformed syntax pertama. langkah dua memeriksa diperlukan rich-hasil fields dan valid nilai jenis; errors dapat block eligibility sementara warnings biasanya identify recommended fields. langkah three memeriksa apakah markup matches terlihat konten dan Google policy. Passing satu layer melakukan tidak prove berikutnya, dan valid markup melakukan tidak jaminan display.
© Patrick Stox LLC · CC BY 4.0 ·
sebelum taxonomy, mendapatkan ini pembedaan straight, karena sebagian besar guides gunakan “error” (terjemahan) “error” sebagai sebuah catch-semua dan ini penyebab needless panic.
- sebuah error berarti sebuah diperlukan property adalah missing atau tidak valid, atau markup adalah unparsable. item dapat’t menjadi sebuah rich hasil until Anda perbaiki ini.
- sebuah warning berarti sebuah recommended (tidak diperlukan) property adalah missing. rich hasil dapat masih tampilkan — hanya lebih sedikit completely.
Google’s own guidance leans toward accuracy di atas padding: “it adalah lebih important untuk supply fewer tetapi menyelesaikan dan accurate recommended properties rather daripada trying untuk sediakan setiap possible recommended property dengan lebih sedikit menyelesaikan, badly-formed, atau inaccurate data.” (terjemahan) “ini adalah lebih penting untuk supply fewer tetapi menyelesaikan dan accurate recommended properties alih-alih trying untuk menyediakan setiap mungkin recommended property dengan lebih sedikit menyelesaikan, badly-formed, atau inaccurate data.” dengan kata lain, jangan chase setiap warning oleh stuffing di half-accurate data — itu dapat buat worse masalah daripada warning ini solves.
Worth knowing: bahkan Google’s own reporting tidak infallible di sini. di October 2022 Search Console memiliki sebuah bug di mana beberapa issues adalah mislabeled sebagai errors ketika mereka adalah sebenarnya warnings; Google’s perbaiki moved them “dari itu critical error table untuk itu warning table,” (terjemahan) “dari critical error table untuk warning table,” dan clarified ini adalah “strictly a reporting issue dan melakukan tidak memengaruhi apakah atau tidak a rich hasil could menjadi displayed” (terjemahan) “strictly sebuah reporting issue dan melakukan tidak memengaruhi apakah atau tidak sebuah rich hasil dapat menjadi displayed” (mesin pencari Land, Oct 2022). lesson: ketika di doubt, cross-periksa sebuah flagged item terhadap Rich hasil Test alih-alih trusting satu report blindly.
«## Malformed JSON-LD — the “unparsable” errors » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian dua puluh sembilan, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)
ini adalah paling fundamental error class: markup adalah rusak badly cukup itu Google dapat’t bahkan determine yang dimaksud jenis. Google files ini di sebuah terpisah Unparsable data terstruktur report alih-alih sebuah per-jenis report, karena ada Tidak jenis untuk attribute item untuk. Google’s own deskripsi: sebuah item lands di sini karena sebuah “serious syntax error” (terjemahan) “serious syntax error” dan “the intended type of structured data (Job, Event, and so on) could not be determined because of the parsing error.” (terjemahan) “ yang dimaksud jenis dari data terstruktur (Job, Event, dan so pada) dapat tidak menjadi determined karena parsing error.”
biasa culprits:
- Trailing commas. sebuah comma setelah terakhir property di sebuah object atau array adalah valid di JavaScript tetapi tidak valid di JSON. ini adalah single sebagian besar umum cara hand-ditulis atau template-concatenated JSON-LD breaks.
- Unescaped quotes. sebuah double quote di dalam sebuah string nilai itu tidak escaped
(
\") terminates string early. Google’s terdokumentasi error untuk ini adalah “Bad escape sequence di string.” (terjemahan) “buruk escape sequence di string.” Product names, review text, dan deskripsi dengan inch marks atau quoted phrases adalah classic offenders. - Missing colons atau braces. Google documents ini verbatim sebagai “Parsing error: Missing ’:’” (terjemahan) “Parsing error: Missing ’:’” dan “Parsing error: Missing ’,’ or ’}’” (terjemahan) “Parsing error: Missing ’,’ atau ’}’” — biasanya sebuah copy-paste atau string-concatenation accident.
- Wrong nilai jenis di dalam jika tidak-valid JSON. Google’s “Incorrect value type” (terjemahan) “Incorrect nilai jenis” — e.g., sebuah numeric field wrapped di quotes ketika sebuah angka adalah yang diharapkan. (ini shades ke eligibility errors di bawah; ketika ini adalah buruk cukup untuk break parsing, ini lands di sini.)
cara debug: strip untuk sebuah empty object, rebuild piece oleh piece
Google’s own debugging tip untuk unparsable markup adalah refreshingly rendah-tech: “If you are having problems finding the error, try starting from an empty object, then add back content from your broken code piece by piece.” (terjemahan) “jika Anda adalah memiliki masalah finding error, try starting dari sebuah empty object, lalu tambahkan back konten dari Anda rusak code piece oleh piece.” Paste stripped-down object ke Rich hasil Test, konfirmasi ini parses, lalu tambahkan properties back until ini breaks — terakhir hal Anda ditambahkan adalah Anda culprit.
Satu caution straight dari Google: memperbaiki sebuah parsing error “might trigger additional warnings or errors that were hidden because the item could not be parsed at all.” (terjemahan) “mungkin trigger additional warnings atau errors itu adalah hidden karena item dapat tidak menjadi parsed di semua.” Satu perbaiki dapat unmask berikutnya layer, so re-test setelah setiap perubahan.
Missing diperlukan fields dan wrong nilai jenis
Setelah JSON parses, berikutnya error class adalah tentang contents: adalah setiap diperlukan property present, dan adalah setiap nilai right jenis?
diperlukan vs. recommended (again, tetapi di property tingkat)
setiap Google-didukung jenis memiliki diperlukan properties (leave satu out dan Anda lose eligibility — itu’s sebuah error) dan recommended ones (leave satu out dan Anda mendapatkan sebuah warning, tetapi rich hasil dapat masih tampilkan). Search Console’s guidance adalah untuk open report, “click an issue to see affected pages,” (terjemahan) “click sebuah issue untuk see affected halaman,” dan gunakan “Why items are invalid” (terjemahan) “Mengapa items adalah tidak valid” table untuk prioritize — errors pertama, lalu warnings.
jenis mismatches — string di mana sebuah angka, URL, atau date adalah yang diharapkan
classic eligibility bug: nilai adalah di sana, tetapi ini adalah wrong jenis. sebuah
price field containing sebuah date. sebuah rating disediakan sebagai "five stars" alih-alih sebuah
angka. sebuah URL field containing plain text. Google flags ini sebagai sebuah
tidak valid/unexpected nilai jenis.
Bing adalah worth sebuah note di sini karena, per -nya own data terstruktur help
documentation,
ini behaves differently: alih-alih erroring loudly, Bing’s crawler adalah
terdokumentasi untuk ignore sebuah annotation milik siapa nilai jenis adalah wrong (sebuah price field
holding sebuah date, sebuah Event dengan Tidak date, sebuah Person dengan Tidak name) alih-alih
surface sebuah red error. So jangan assume “Tidak Bing error” (terjemahan) “Tidak Bing error” berarti “correct” (terjemahan) “correct” — Bing’s
publik documentation adalah thinner dan lebih sedikit granular daripada Google’s (ini tidak
publish sebuah per-jenis diperlukan-vs-recommended breakdown atau sebuah report sebagai detailed sebagai
Rich hasil report), dan -nya tolerance untuk mismatched jenis adalah sebuah silent-drop,
tidak sebuah loud-fail. Lean pada Google’s Rich hasil Test untuk detailed error
taxonomy.
Duplicate @id nilai dan entity confusion
sebuah subtler satu itu CMS plugins penyebab constantly: reusing yang sama @id untuk dua
berbeda entities, atau letting sebuah plugin emit sebuah fresh, colliding @id pada setiap
halaman alih-alih sebuah stable satu. ini adalah tidak sebuah parsing failure — JSON itself
adalah well-formed, so ini tidak land di Unparsable data terstruktur report.
@id adalah bagaimana JSON-LD nodes reference setiap lainnya di dalam sebuah @graph, so sebuah collision
adalah sebuah entity-identity masalah: ini membuat ambiguity tentang yang node sebuah reference
sebenarnya poin untuk. ini mendapatkan worse pada situs di mana multiple sources ( theme
dan sebuah schema plugin) keduanya auto-generate Organization, WebSite, dan WebPage
nodes.
perbaiki adalah sebuah stable, unique @id per dunia nyata entity — sebuah URL-fragment
identifier like https://example.com/#organization, reused consistently di seluruh
situs, tidak regenerated per halaman. ini adalah mirror image dari
canonicalization
masalah, di mana satu stable identifier per nyata hal adalah likewise seluruh game.
Nested-property errors (sebuah missing name di dalam author)
beberapa diperlukan properties langsung di dalam lainnya objects — author.name,
aggregateRating.ratingValue. sebuah missing satu digunakan untuk produce sebuah vague error like
Missing field "name" itu dapat poin anywhere pada halaman. di
March 2022
Google ditambahkan nested context so yang sama error now membaca Missing field "name" (di "author") — sebuah kecil perubahan itu membuat ini far easier untuk locate. (Anyone dengan sebuah
open “validate perbaiki” (terjemahan) “validate perbaiki” permintaan di time memiliki untuk re-trigger ini, since old issue
IDs adalah retired.) jika Anda see sebuah nested-property error, baca parenthetical — ini
tells Anda persis yang object adalah pendek sebuah field.
konten mismatch — policy-violation error class
ini adalah satu error class itu deserves -nya own bagian, karena consequence adalah categorically worse daripada “Tidak rich hasil.” (terjemahan) “Tidak rich hasil.” Semuanya di atas adalah sebuah teknis masalah. konten mismatch adalah sebuah policy masalah.
Google’s umum data terstruktur Guidelines adalah jelas pada dua poin:
- “Don’t mark up content that is not visible to readers of the page.” (terjemahan) “jangan mark up konten itu adalah tidak terlihat untuk readers dari halaman.”
- “Your structured data must be a true representation of the page content.” (terjemahan) “Anda data terstruktur harus menjadi sebuah benar representation dari halaman konten.”
Marking up sebuah 4,8-star rating itu muncul nowhere pada halaman, describing konten itu’s hidden atau disajikan hanya untuk crawler, atau labeling sesuatu sebagai satu hal ketika ini adalah benar-benar lainnya — Google’s own contoh sertakan sebuah sports langsung-streaming situs labeling broadcasts sebagai local events, dan sebuah woodworking situs labeling instructions sebagai recipes — semua violate ini.
Consequences: manual tindakan vs. silent ineligibility
sebuah teknis error costs Anda rich hasil silently. sebuah konten-mismatch policy violation dapat cost Anda lebih: “If your page contains a structured data issue, it can result in a manual action. A structured data manual action means that a page loses eligibility for appearance as a rich result; it doesn’t affect how the page ranks in Google web search.” (terjemahan) “jika Anda halaman berisi sebuah data terstruktur issue, ini dapat hasil di sebuah manual tindakan. sebuah data terstruktur manual tindakan berarti itu sebuah halaman loses eligibility untuk appearance sebagai sebuah rich hasil; ini tidak memengaruhi bagaimana halaman peringkat di Google web penelusuran.” Manual tindakan tampilkan up di Manual tindakan report di Search Console — sebuah place Anda tidak pernah ingin untuk see sebuah structured-data entry.
sebuah umum quieter versi dari ini: templated, non-unique schema. John Mueller’s
panjang-standing guidance adalah itu “the structured data on a website, or on a page,
should be specific to that particular page” (terjemahan) “ data terstruktur pada sebuah situs web, atau pada sebuah halaman,
seharusnya menjadi spesifik untuk itu particular halaman”
(melalui mesin pencari Journal). sebuah situs-wide Organization block copy-pasted dengan
sama review count onto setiap halaman membaca sebagai sebuah representation masalah, tidak hanya sebuah
sloppy satu.
«Why validation isn’t enough. This is the answer to “my markup validates clean — why no rich result?” Validators check syntax and Google’s technical eligibility rules. They do not check Google’s content-quality and spam-policy layer. A syntactically perfect, policy-violating implementation can still be denied a rich result or hit with a manual action. Passing the Rich Results Test is necessary but not sufficient. » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian lima puluh enam, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)
menggunakan sebuah deprecated atau unsupported jenis
Di sini’s sebuah failure mode itu tidak technically sebuah “error” (terjemahan) “error” di semua — dan ini trips orang up karena tidak ada apa pun turns red. Anda markup adalah perfectly valid, ini parses, ini melewati schema.org validator, dan namun Tidak rich hasil akan ever tampilkan, karena Google turned fitur off.
Case study: FAQ rich hasil (deprecated 2026)
timely contoh. Google ditambahkan sebuah deprecation notice untuk FAQ rich hasil documentation, stating fitur “akan Tidak lebih lama muncul di Google Search starting Mungkin 7, 2026,” (terjemahan) “akan Tidak lebih lama muncul di Google Search starting dapat 7, 2026,” lalu di pertengahan 2026 dihapus FAQ documentation, Rich hasil Test mendukung, dan Search Console reporting karena “itu FAQ rich hasil feature adalah Tidak lebih lama shown di Google Search hasil.” (terjemahan) “ FAQ rich hasil fitur adalah Tidak lebih lama ditampilkan di Google hasil pencarian.”
nuance itu penting: FAQPage adalah masih sebuah valid schema.org jenis, dan Google
masih parses ini. jenis tidak “wrong.” (terjemahan) “wrong.” ini sekadar Tidak lebih lama earns visual
treatment. So correct reaction untuk “adalah my FAQ schema now an error?” (terjemahan) “adalah my FAQ schema now sebuah error?” adalah Tidak —
leaving markup di place tidak hurt apa pun; ini hanya Tidak lebih lama buys Anda sebuah SERP
enhancement. jangan panic-strip valid markup karena visual went away.
lainnya retired jenis
FAQ tidak alone. Google memiliki repeatedly retired rich-hasil jenis ketika analysis showed mereka tidak widely digunakan atau tidak tambahkan pengguna nilai: HowTo rich hasil adalah dihapus dari desktop back di 2023; sebuah June 2025 batch retired seven lebih niche jenis (including Claim Review, Estimated Salary, Learning Video, Special Announcement, dan Vehicle Listing); dan Practice masalah data terstruktur adalah deprecated starting January 2026. di setiap case schema.org jenis biasanya tetap valid — ini hanya berhenti rendering.
«### How to tell if a type is still “live” » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian enam puluh empat, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)
periksa Google’s Penelusuran Gallery — canonical list dari jenis itu saat ini earn rich hasil. jika sebuah jenis tidak di gallery, valid markup untuk ini tidak akan produce sebuah visual, Tidak penting bagaimana bersih ini adalah. Re-periksa gallery periodically; Google revises ini sering.
cara sebenarnya debug — three berbeda alat
single sebagian besar umum meta-mistake adalah conflating alat. ada three, dan mereka jawaban berbeda pertanyaan.
Rich hasil Test — Google eligibility + SERP preview
Rich hasil Test takes sebuah single URL atau sebuah code snippet dan memeriksa subset dari markup Google menggunakan untuk rich hasil, lalu previews bagaimana hasil mungkin muncul. Google frames ini sebagai “an easy dan useful tool untuk validating Anda structured data, dan di some cases, previewing a feature di Google Search.” (terjemahan) “sebuah easy dan berguna alat untuk validating Anda data terstruktur, dan di beberapa cases, previewing sebuah fitur di Google Search.” gunakan ini selama development dan untuk spot-periksa sebuah perbaiki. ini melakukan tidak validate schema jenis Google tidak gunakan untuk rich hasil.
Schema Markup Validator — schema.org syntax, apa pun jenis
Schema Markup Validator adalah jalankan oleh schema.org,
tidak Google. ini memeriksa umum syntax dan vocabulary compliance untuk apa pun
schema.org jenis — including ones Google tidak turn ke rich hasil (e.g.,
Action schema). Passing ini berarti Anda markup adalah well-formed schema.org; ini melakukan
tidak berarti Anda’re eligible untuk sebuah Google rich hasil. ini adalah alat untuk
“adalah my JSON-LD structurally correct?” (terjemahan) “adalah my JSON-LD structurally correct?” independent dari apa pun mesin pencari.
** dua-alat trap:** ini adalah genuinely berbeda alat, dan passing satu melakukan tidak berarti passing lainnya. split memiliki confusing history — Google tried untuk fully deprecate -nya old “Structured Data Testing Tool” (terjemahan) “data terstruktur Testing alat” di July 2020, reversed course setelah backlash itu December, lalu refocused ini ke hari ini’s schema.org-jalankan validator oleh mid-2021. Plenty dari old blog posts masih poin orang di dead alat name. untuk 2026: Rich hasil Test untuk Google eligibility, Schema Markup Validator untuk schema.org syntax.
Search Console’s Rich hasil report — situs-wide, sampled, di atas time
«The Rich result report (the older nav and a lot of practitioners still call this the “Enhancements” reports) is the only one that’s ongoing and site-wide rather than a single-URL spot check. Google: “a valid item is an item that doesn’t have any critical issues and can appear on Google as a rich result. An invalid item has at least one critical issue preventing it from appearing as a rich result.” Two limitations to keep in mind: per-type reports only appear once Google finds valid markup of that type, and “the reports aren’t a comprehensive list of all detected items. They show a sample of detected items to help assess the quality of your structured data.” It’s a monitoring surface, not an exhaustive audit. » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian tujuh puluh lima, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)
sebuah lulus jawaban hanya itu alat’s own layer. Rich hasil Test, Schema Markup Validator, dan Rich hasil report setiap periksa sebuah berbeda pertanyaan, so sebuah bersih hasil di satu tells Anda tidak ada apa pun tentang lainnya dua — sebuah lulus di Schema Markup Validator tidak berarti Google’s Rich hasil Test akan lulus, dan neither proves apa Rich hasil report akan tampilkan setelah Google sebenarnya melakukan crawl deployed halaman.
Validating sebuah perbaiki (dan mengapa ini takes sebuah sementara)
setelah Anda’ve fixed sebuah issue, Google’s terdokumentasi workflow adalah: perbaiki pada-situs, konfirmasi halaman adalah dapat di-crawl (tidak blocked oleh robots.txt atau noindex), spot-periksa dengan pemeriksaan URL, lalu “click Validate perbaiki pada itu issue’s details halaman untuk mulai Google’s validation proses.” (terjemahan) “click Validate perbaiki pada issue’s detail halaman untuk mulai Google’s validation proses.” Set expectations pada timing — Google says validation “can take two weeks or more, depending on crawl frequency.” (terjemahan) “dapat take dua weeks atau lebih, depending pada crawl frequency.” ini adalah tidak instant; Google memiliki untuk re-crawl affected halaman.
satu framing itu mempertahankan Anda sane
Memperbaiki data terstruktur errors adalah tentang rich-hasil eligibility, tidak rankings. sebagai John Mueller put ini (reported oleh mesin pencari Roundtable, April 2025), “structured data tidak akan membuat Anda site rank better” (terjemahan) “data terstruktur tidak akan membuat Anda situs peringkat better” — ini adalah untuk displaying penelusuran fitur di Google’s gallery. So payoff dari sebuah bersih perbaiki adalah sebuah SERP visual (stars, breadcrumbs, price) dan click-melalui ini dapat earn — tidak pernah sebuah peringkat bump. pertahankan itu straight dan Anda’ll prioritize right errors: ones blocking sebuah visual Anda sebenarnya ingin, tidak setiap warning di report.
Di mana ini sits
ini adalah sebuah deep-dive sibling di bawah data terstruktur untuk SEO hub — yang sama sub-cluster sebagai schema-markup, JSON-LD, dan rich-hasil deep dives. error taxonomy di sini adalah troubleshooting padanan untuk itu: mereka cover apa untuk bangun, ini covers apa breaks dan cara see ini. untuk lebih luas picture dari pada-halaman sinyal ini lives alongside — meta tags, header tags, image SEO — see pada-halaman SEO cluster.
AI summary
sebuah condensed take pada Advanced versi:
- Dua error classes. Parsing errors — malformed JSON-LD (trailing commas,
unescaped quotes, missing colons/braces) itu break markup so badly Google
dapat’t determine jenis; ini go untuk Unparsable data terstruktur report.
Eligibility errors — markup parses fine tetapi fails sebuah rich-hasil aturan:
missing diperlukan property, wrong nilai jenis, sebuah colliding/duplicate
@id(entity-identity confusion, tidak sebuah parse failure), atau markup describing konten tidak terlihat pada halaman. - Errors block, warnings degrade. sebuah missing diperlukan property (atau unparsable JSON) kills rich-hasil eligibility. sebuah missing recommended property adalah hanya sebuah warning — hasil biasanya masih menampilkan, lebih sedikit richly. Google: accurate-tetapi-fewer beats padded-tetapi-sloppy.
- konten mismatch adalah class dengan teeth. Marking up invisible konten atau data itu tidak “a benar representation dari itu halaman konten” (terjemahan) “sebuah benar representation dari halaman konten” adalah sebuah policy violation itu dapat trigger sebuah manual tindakan — worse daripada silent ineligibility. ini adalah mengapa bersih-validating markup dapat masih fail: validators jangan periksa konten/spam policy layer.
- Deprecated jenis tidak errors. FAQ (hilang oleh dapat 2026), HowTo (desktop 2023),
dan June 2025 batch adalah valid markup itu Tidak lebih lama earns sebuah visual. jangan
panic-strip
FAQPage— ini masih parses, ini hanya memiliki Tidak SERP payoff. periksa Penelusuran Gallery untuk apa masih langsung. - Three berbeda alat. Rich hasil Test — Google eligibility + SERP preview, single URL/snippet. Schema Markup Validator (schema.org) — syntax/vocabulary untuk apa pun jenis, tidak Google-spesifik. Rich hasil report (Search Console) — situs-wide, sampled, di atas time. Passing satu ≠ passing lainnya.
- Debug tip (dari Google): strip untuk sebuah empty object, re-tambahkan code piece oleh piece; sebuah perbaiki dapat unmask hidden errors, so re-test setiap time.
- Validating sebuah perbaiki takes “two weeks or more, depending on crawl frequency.” (terjemahan) “dua weeks atau lebih, depending pada crawl frequency.”
- Tidak sebuah peringkat factor. Memperbaiki errors wins back sebuah SERP visual, tidak sebuah peringkat (Mueller, 2025).
Dokumentasi resmi
Utama-sumber documentation dari Google dan schema.org.
Google — policies dan bagaimana markup berfungsi
- umum data terstruktur Guidelines — konten-mismatch dan hidden-konten aturan, dan manual-tindakan consequence.
- Intro untuk Bagaimana data terstruktur Markup berfungsi — Rich hasil Test recommendation dan “fewer but complete” (terjemahan) “fewer tetapi menyelesaikan” diperlukan-vs-recommended guidance.
- data terstruktur Markup itu Google Search mendukung (Penelusuran Gallery) — canonical list dari jenis itu saat ini earn rich hasil (periksa sebelum assuming sebuah jenis adalah masih langsung).
Google — reports dan debugging workflow
- Rich hasil report overview — situs-wide, sampled, per-jenis Search Console report; valid-vs-tidak valid definitions dan “sample, not comprehensive” (terjemahan) “sample, tidak comprehensive” caveat.
- Unparsable data terstruktur report — di mana malformed JSON-LD lands; terdokumentasi error strings dan strip-untuk-empty-object debugging tip.
- Perbaiki data terstruktur issues di Search Console — perbaiki → konfirmasi dapat di-crawl → pemeriksaan URL → Validate perbaiki workflow, dan “two weeks or more” (terjemahan) “dua weeks atau lebih” timing.
Google — alat
- Rich hasil Test — single-URL/snippet checker dengan SERP preview (Google-eligibility hanya).
schema.org
- Schema Markup Validator — schema.org’s own syntax/vocabulary validator untuk apa pun jenis (distinct dari Google’s Rich hasil Test).
- schema.org — vocabulary itself.
Quotes dari sumber
pada—record statements dari Google, plus relayed statements dari Google reps. setiap tautan adalah sebuah deep tautan itu jumps untuk quoted passage di mana halaman exposes ini.
Google — konten-mismatch policy ( accuracy spine)
- “Don’t mark up content that is not visible to readers of the page.” (terjemahan) “jangan mark up konten itu adalah tidak terlihat untuk readers dari halaman.” — Google Search Central docs. Jump untuk quote
- “Your structured data must be a true representation of the page content.” (terjemahan) “Anda data terstruktur harus menjadi sebuah benar representation dari halaman konten.” Jump untuk quote
Google — diperlukan vs. recommended properties
«- “it is more important to supply fewer but complete and accurate recommended properties rather than trying to provide every possible recommended property with less complete, badly-formed, or inaccurate data.” Jump to quote » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian seratus tiga, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.) «- “The Rich Results Test is an easy and useful tool for validating your structured data, and in some cases, previewing a feature in Google Search.” Jump to quote » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian seratus tiga, bagian kecil dua: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)
Google — Rich hasil report (Search Console)
- “A valid item is an item that doesn’t have any critical issues and can appear on Google as a rich result. An invalid item has at least one critical issue preventing it from appearing as a rich result.” (terjemahan) “sebuah valid item adalah sebuah item itu tidak memiliki apa pun critical issues dan dapat muncul pada Google sebagai sebuah rich hasil. sebuah tidak valid item memiliki setidaknya satu critical issue preventing ini dari appearing sebagai sebuah rich hasil.” Jump untuk quote
- “The reports aren’t a comprehensive list of all detected items. They show a sample of detected items to help assess the quality of your structured data.” (terjemahan) “ reports tidak sebuah comprehensive list dari semua detected items. mereka tampilkan sebuah sample dari detected items untuk help assess quality dari Anda data terstruktur.” Jump untuk quote
Google — unparsable markup dan debugging
- yang dimaksud jenis “could not be determined because of the parsing error.” (terjemahan) “dapat tidak menjadi determined karena parsing error.” Jump untuk quote
- “If you are having problems finding the error, try starting from an empty object, then add back content from your broken code piece by piece.” (terjemahan) “jika Anda adalah memiliki masalah finding error, try starting dari sebuah empty object, lalu tambahkan back konten dari Anda rusak code piece oleh piece.” Jump untuk quote
Google — validating sebuah perbaiki
- Validation “can take two weeks or more, depending on crawl frequency.” (terjemahan) “dapat take dua weeks atau lebih, depending pada crawl frequency.” Jump untuk quote
John Mueller, Google — data terstruktur adalah tidak sebuah peringkat factor
- “Structured data won’t make your site rank better.” (terjemahan) “data terstruktur tidak akan membuat Anda situs peringkat better.” Baca coverage
John Mueller, Google — schema seharusnya menjadi halaman-spesifik
- “The structured data on a website, or on a page, should be specific to that particular page.” (terjemahan) “ data terstruktur pada sebuah situs web, atau pada sebuah halaman, seharusnya menjadi spesifik untuk itu particular halaman.” Baca coverage
Search Console reporting bug (Oct 2022) — errors mislabeled sebagai errors
- “Ini adalah strictly a reporting issue dan melakukan tidak memengaruhi apakah atau tidak a rich hasil could menjadi displayed di Google Search hasil.” (terjemahan) “ini adalah strictly sebuah reporting issue dan melakukan tidak memengaruhi apakah atau tidak sebuah rich hasil dapat menjadi displayed di Google hasil pencarian.” Baca coverage
Yang alat (dan apa melakukan hasil berarti)?
Mulai dari pertanyaan Anda’re sebenarnya asking — alat jawaban berbeda ones.
“Adalah my JSON-LD even ditulis correctly?” (terjemahan) “adalah my JSON-LD bahkan ditulis correctly?”
→ Schema Markup Validator (validator.schema.org). ini memeriksa schema.org syntax
dan vocabulary untuk apa pun jenis. Passing = well-formed schema.org. ini melakukan tidak tell
Anda tentang Google rich-hasil eligibility.
“Will this page be eligible for a Google rich result, and how might it look?” (terjemahan) “akan ini halaman menjadi eligible untuk sebuah Google rich hasil, dan bagaimana mungkin ini look?”
→ Rich hasil Test (search.google.com/test/rich-results). Single URL atau
snippet, Google-eligible jenis hanya, dengan sebuah SERP preview.
- jika jenis Anda care tentang tidak recognized di semua → periksa Penelusuran Gallery; jenis dapat menjadi deprecated (FAQ, HowTo-pada-desktop) — valid markup, Tidak visual.
“Which pages across my whole site have issues, over time?” (terjemahan) “Yang halaman di seluruh my seluruh situs memiliki issues, di atas time?” → Search Console → Rich hasil report (situs-wide, sampled). Remember ini adalah sebuah sample, tidak sebuah comprehensive list, dan per-jenis reports hanya muncul setelah Google menemukan valid markup dari itu jenis.
Apa melakukan error sebenarnya berarti?
Item adalah di Unparsable data terstruktur report → Malformed JSON — trailing comma, unescaped quote, missing colon/brace. Strip untuk sebuah empty object dan re-tambahkan code piece oleh piece. Google tidak dapat bahkan determine jenis.
“Missing field …” (terjemahan) “Missing field …” (sebuah error)
→ sebuah diperlukan property adalah absent. Rich hasil blocked until fixed. Baca apa pun
parenthetical (… (in "author")) — ini names nested object itu’s pendek sebuah field.
”… seharusnya menjadi … / recommended” (terjemahan) “… seharusnya menjadi … / recommended” (sebuah warning) → sebuah recommended property adalah missing. rich hasil masih menampilkan, hanya lebih sedikit completely. Perbaiki hanya jika missing field adalah worth ini — jangan pad dengan inaccurate data.
“Incorrect value type” (terjemahan) “Incorrect nilai jenis” / “invalid value” (terjemahan) “tidak valid nilai” → Right property, wrong jenis — sebuah string di mana sebuah angka/URL/date belongs. Correct jenis.
Validates bersih, tetapi Tidak rich hasil muncul → Either jenis adalah deprecated (periksa gallery) atau Anda’re hitting sebuah konten/policy issue validators jangan catch (invisible konten, tidak sebuah “true representation” (terjemahan) “benar representation”). Worst case, periksa Manual tindakan report.
Entry di Manual tindakan report → sebuah konten-mismatch policy violation. ini adalah serious satu: perbaiki markup-untuk-halaman mismatch, lalu permintaan reconsideration. ini costs rich-hasil eligibility, tidak rankings.
data terstruktur error triage — checklist
sebuah lulus untuk temukan, prioritize, dan perbaiki schema errors correctly:
- Separated errors dari warnings — errors (diperlukan missing / unparsable) block rich hasil; warnings (recommended missing) jangan. Perbaiki errors pertama.
- diperiksa Unparsable data terstruktur report — apa pun ada malformed JSON (trailing comma, unescaped quote, missing colon/brace).
- Debugged unparsable items oleh stripping untuk sebuah empty object dan re-menambahkan properties until ini breaks; re-tested setelah setiap perubahan (sebuah perbaiki dapat unmask hidden errors).
- Confirmed setiap diperlukan property adalah present untuk setiap jenis (per Penelusuran Gallery), lalu recommended ones — accuracy di atas padding.
- nilai jenis adalah correct — angka di mana angka belong, URLs di mana URLs belong, dates sebagai dates; Tidak strings standing di untuk them.
- Baca nested-property errors’ parentheticals —
Missing field "name" (di "author")tells Anda persis yang object adalah pendek sebuah field. -
@idnilai adalah stable dan unique per nyata entity — Tidak duplicate/colliding@id, Tidak per-halaman regeneration (watch untuk theme + plugin keduanya emitting nodes). - Semuanya marked up adalah terlihat pada halaman dan adalah sebuah benar representation dari ini — Tidak invisible konten, Tidak fake/aggregate ratings itu muncul nowhere.
- Tidak reliance pada sebuah deprecated jenis — FAQ (hilang dapat 2026), HowTo desktop (2023), June 2025 batch. Valid markup, tetapi zero SERP payoff.
- Ran right alat untuk pertanyaan — Schema Markup Validator (syntax), Rich hasil Test (Google eligibility + preview), Rich hasil report (situs-wide monitoring).
- diperiksa Manual tindakan report — sebuah structured-data entry di sana berarti sebuah konten-mismatch policy violation, tidak sebuah teknis error.
- setelah memperbaiki, confirmed dapat di-crawl (tidak robots-blocked / noindex), spot-diperiksa dengan pemeriksaan URL, lalu clicked Validate perbaiki — dan set expectations: ini dapat take dua weeks atau lebih.
data terstruktur errors — cheat sheet
** three alat (jangan conflate them)**
| alat | Jalankan oleh | memeriksa | Cakupan |
|---|---|---|---|
| Rich hasil Test | Google rich-hasil eligibility + SERP preview | Single URL / snippet | |
| Schema Markup Validator | schema.org | schema.org syntax + vocabulary, apa pun jenis | Single URL / snippet |
| Rich hasil report | Google (Search Console) | Valid/tidak valid items per jenis, di atas time | situs-wide, sampled |
Passing satu melakukan tidak berarti passing lainnya.
Error vs. warning
| berarti | Rich hasil? | |
|---|---|---|
| Error | diperlukan property missing/tidak valid, atau unparsable JSON | Blocked |
| Warning | Recommended property missing | biasanya masih menampilkan, lebih sedikit menyelesaikan |
Error classes dan perbaiki
| Symptom | Class | Perbaiki |
|---|---|---|
| Item di Unparsable report | Malformed JSON | Strip untuk empty object, re-tambahkan piece oleh piece |
Trailing comma / unescaped quote / missing : atau } | Parsing | Correct JSON syntax |
Duplicate / colliding @id | Entity confusion | Satu stable, unique @id per nyata entity |
| ”Missing field …” (terjemahan) “Missing field …” (error) | diperlukan property absent | tambahkan diperlukan property |
| ”Incorrect value type” (terjemahan) “Incorrect nilai jenis” | Wrong jenis | angka/URL/date di mana yang diharapkan — tidak sebuah string |
| Validates bersih, Tidak visual | Deprecated jenis atau policy | periksa Penelusuran Gallery; periksa konten match |
| Entry di Manual tindakan | konten-mismatch policy | Perbaiki mismatch, permintaan reconsideration |
Fast facts
- Tidak sebuah peringkat factor — sebuah perbaiki wins back sebuah SERP visual, tidak sebuah peringkat (Mueller).
- konten mismatch dapat trigger sebuah manual tindakan — satu class dengan teeth.
- FAQ rich hasil: hilang oleh dapat 7, 2026;
FAQPagejenis masih valid, hanya Tidak visual. - Validating sebuah perbaiki: “two weeks or more, depending on crawl frequency.” (terjemahan) “dua weeks atau lebih, depending pada crawl frequency.”
- Rich hasil report adalah sebuah sample, tidak sebuah comprehensive list dari setiap item.
Apa tidak untuk melakukan
recurring mistakes itu turn sebuah fixable schema issue ke sebuah bigger satu:
- Treating setiap warning like sebuah error. sebuah missing recommended property adalah sebuah warning — rich hasil masih menampilkan. Chasing warnings oleh stuffing di half-benar data adalah worse daripada leaving them; Google explicitly prefers fewer, accurate properties di atas lebih, sloppy ones.
- Trusting satu report blindly. Search Console memiliki mislabeled warnings sebagai errors sebelum (Oct 2022). Cross-periksa sebuah flagged item terhadap Rich hasil Test rather daripada reacting untuk sebuah single report.
- Marking up konten itu tidak terlihat. satu class dengan nyata teeth — ini adalah sebuah policy violation itu dapat trigger sebuah manual tindakan, tidak hanya sebuah silent kehilangan dari rich hasil. jika sebuah rating, price, atau fact tidak pada halaman, jangan put ini di schema.
- Copy-pasting identical schema di seluruh setiap halaman. Templated, non-unique markup (sama review count sitewide) membaca sebagai sebuah representation masalah. Schema seharusnya menjadi spesifik untuk halaman ini adalah pada.
- Regenerating
@idper halaman, atau reusing satu@iduntuk dua entities. Keduanya break entity references di dalam sebuah@graph. gunakan satu stable, unique@idper dunia nyata entity — dan watch untuk sebuah theme dan sebuah plugin keduanya emittingOrganization/WebSitenodes. - Panic-stripping valid-tetapi-deprecated markup. FAQ schema berhenti earning sebuah
visual di 2026, tetapi
FAQPageadalah masih valid dan Google masih parses ini. menghapus ini gains Anda tidak ada apa pun dan risks breaking lainnya markup sekitar ini. - Assuming “validates clean” (terjemahan) “validates bersih” = “rich result guaranteed.” (terjemahan) “rich hasil guaranteed.” Validators jangan periksa Google’s konten-quality dan spam-policy layer. sebuah syntactically perfect, policy-violating halaman dapat masih menjadi denied.
- Pointing orang di old “Structured Data Testing Tool.” (terjemahan) “data terstruktur Testing alat.” ini adalah refocused ke schema.org Schema Markup Validator oleh 2021. untuk 2026: Rich hasil Test (Google eligibility) dan Schema Markup Validator (schema.org syntax).
- Expecting sebuah instant perbaiki. setelah “Validate fix,” (terjemahan) “Validate perbaiki,” Google re-melakukan crawl pada -nya own schedule — “two weeks or more, depending on crawl frequency.” (terjemahan) “dua weeks atau lebih, depending pada crawl frequency.” jangan re-file sama issue di sebuah panic.
Resources worth Anda time
My related writing
- data terstruktur: Apa ini adalah dan cara gunakan ini — my Ahrefs guide untuk schema jenis, implementation metode, validation alat, dan
sameAsrisk — bangun-side padanan untuk ini troubleshooting piece. - Google menggunakan ~40 Canonicalization Sinyal — my canonicalization guide; stable-identifier-per-nyata-hal logic behind memperbaiki duplicate
@iderrors mirrors canonical selection. - Beginner’s Guide untuk SEO teknis — di mana data terstruktur (dan -nya errors) fit ke lebih luas teknis picture.
Official
- Google’s umum data terstruktur Guidelines — konten-mismatch/hidden-konten policy dan manual-tindakan consequence.
- Google’s Unparsable data terstruktur report — malformed-JSON error strings dan strip-untuk-empty-object debugging tip.
- Google’s Perbaiki data terstruktur issues di Search Console — perbaiki → Validate perbaiki workflow dan “two weeks or more” (terjemahan) “dua weeks atau lebih” timing.
- Google’s Rich hasil report overview — valid/tidak valid definitions dan “sample, not comprehensive” (terjemahan) “sample, tidak comprehensive” caveat.
- Google’s Penelusuran Gallery — saat ini list dari jenis itu earn rich hasil (periksa sebelum assuming sebuah jenis adalah langsung).
- Rich hasil Test (Google) dan Schema Markup Validator (schema.org) — dua single-URL alat, untuk dua berbeda pertanyaan.
dari sekitar industry
- Google: data terstruktur melakukan Tidak membuat Anda situs peringkat Better (mesin pencari Roundtable, April 2025) — Mueller’s “tidak akan membuat Anda site rank better,” (terjemahan) “tidak akan membuat Anda situs peringkat better,” framing itu reorients mengapa Anda perbaiki errors di semua.
- Google’s John Mueller: data terstruktur seharusnya menjadi Unique untuk setiap halaman (mesin pencari Journal) — sumber untuk templated-schema mistake.
- Google Search Console Mislabeled data terstruktur Errors sebagai Errors (mesin pencari Land, Oct 2022) — reporting-bug incident behind “jangan trust satu report blindly.” (terjemahan) “jangan trust satu report blindly.”
- Google Search Console data terstruktur Error Reporting Gains Lebih Contextual informasi (mesin pencari Land, March 2022) — nested-property context perubahan (
… (in "author")). - Google Drops FAQ Rich hasil dari Penelusuran (mesin pencari Journal) — coverage dari FAQ removal dan apa tetap valid.
- r/TechSEO — community untuk schema-error dan rich-hasil debugging.
Rusak vs. fixed JSON-LD
Four dari error classes ini artikel covers, setiap ditampilkan sebagai sebuah minimal rusak snippet berikutnya untuk fixed versi. ini adalah simplified contoh — nyata JSON-LD biasanya memiliki lebih properties sekitar rusak satu.
Trailing comma
// Broken — trailing comma after "price" breaks JSON parsing entirely
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"offers": {
"@type": "Offer",
"price": "89.99",
}
}// Fixed — comma removed after the last property
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"offers": {
"@type": "Offer",
"price": "89.99"
}
}apa wrong: sebuah comma setelah terakhir property di sebuah object adalah valid di JavaScript tetapi tidak valid di JSON — ini lands item di Unparsable data terstruktur report karena Google dapat’t determine jenis di semua.
Unescaped quote
// Broken — the inch mark inside "description" terminates the string early
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Monitor Stand",
"description": "Fits a 27" display comfortably"
}// Fixed — the inner quote is escaped
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Monitor Stand",
"description": "Fits a 27\" display comfortably"
}apa wrong: sebuah unescaped " di dalam sebuah string nilai ends string di itu
poin, breaking semuanya setelah ini. Google’s terdokumentasi error string untuk ini
adalah “Bad escape sequence di string.” (terjemahan) “buruk escape sequence di string.”
Wrong nilai jenis
// Broken — ratingValue is a string, not a number
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "five stars",
"reviewCount": "42"
}
}// Fixed — ratingValue is a number; reviewCount is a number too
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": 4.6,
"reviewCount": 42
}
}apa wrong: JSON adalah syntactically valid, so ini melewati basic parsing —
tetapi Google flags ini sebagai “Incorrect value type” (terjemahan) “Incorrect nilai jenis” karena ratingValue perlu sebuah
angka, tidak sebuah text string like "five stars".
Duplicate @id
// Broken — the theme AND a plugin each emit their own "#organization" @id
// with different data, colliding inside the site's @graph
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Co" },
{ "@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Company Inc." }
]
}// Fixed — one stable, unique @id per real-world entity
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Company Inc." }
]
}apa wrong: reusing yang sama @id untuk dua berbeda representations dari
sama entity membuat ambiguity tentang yang satu sebuah reference poin untuk — pick satu
stable identifier, reused consistently, tidak pernah regenerated per halaman.
Prompts untuk debugging data terstruktur errors
Paste-dan-jalankan prompts untuk dua hal ini artikel’s error list adalah sebenarnya berguna untuk: finding sebuah parsing error di rusak JSON-LD, dan memeriksa sebuah block terhadap diperlukan-vs-recommended pembedaan.
temukan parsing error di rusak JSON-LD
Paste di: mentah JSON-LD block itu’s failing (copy ini straight dari view-sumber atau Rich hasil Test’s code view).
Here is a JSON-LD structured data block that Google's Rich Results Test is
flagging as unparsable. Find the syntax error (trailing comma, unescaped
quote, or missing colon or brace) and tell me the exact line and character
that's wrong. Then give me the corrected JSON. Don't change any property
values, only fix the syntax.
[paste the broken JSON-LD block here]Apa untuk expect back: spesifik syntax masalah named (tidak hanya “ada an error di suatu tempat” (terjemahan) “ada sebuah error di suatu tempat”), plus sebuah corrected block Anda dapat diff terhadap original untuk konfirmasi tidak ada apa pun else changed. Re-jalankan fixed block melalui Rich hasil Uji pemahaman Anda — sebuah perbaiki dapat unmask sebuah kedua, previously-hidden error, so jangan treat satu AI lulus sebagai akhir kata.
periksa diperlukan vs. recommended properties untuk sebuah jenis
Paste di: JSON-LD block plus schema.org jenis name Anda’re targeting
(e.g. Product, Recipe, Event).
This is a JSON-LD block using schema.org type [TYPE]. Based on Google's
required and recommended properties for this type in its Search Gallery
documentation, tell me: (1) which required properties are missing —
these block the rich result entirely, (2) which recommended properties
are missing — these only produce warnings, and (3) whether any present
value looks like the wrong type (text where a number, URL, or date is
expected).
[paste the JSON-LD block here]Apa untuk expect back: sebuah split list — diperlukan gaps pertama, since itu adalah apa block eligibility — tidak sebuah flat list treating setiap missing field sebagai equally urgent. Verify jenis-spesifik requirements terhadap Google’s own Penelusuran Gallery halaman sebelum acting, since AI-model knowledge dari Google’s tepat diperlukan-property lists dapat menjadi stale.
Proving sebuah schema perbaiki sebenarnya took effect
artikel’s own “Validate fix” (terjemahan) “Validate perbaiki” workflow — perbaiki pada-situs, konfirmasi dapat di-crawl, spot-periksa, click Validate perbaiki, tunggu — turned ke lulus/fail memeriksa.
Rich hasil Test menampilkan jenis dengan zero errors
Test untuk jalankan: Paste langsung halaman URL (atau fixed JSON-LD snippet) ke
Rich hasil Test.
Yang diharapkan hasil: target jenis (e.g. Product, Recipe) adalah detected
dengan 0 errors — warnings untuk recommended properties adalah acceptable.
Failure interpretation: jika jenis masih menampilkan yang sama error, perbaiki
either tidak deploy untuk langsung halaman atau tidak address sebenarnya property
error named — re-baca parenthetical pada apa pun nested-property error.
Monitoring window: Immediate — ini test membaca saat ini langsung markup,
tidak sebuah cached atau di-crawl versi.
Rollback trigger: jika previously-passing jenis now menampilkan sebuah baru error
ini tidak memiliki sebelum, perbaiki mungkin broke sesuatu else di yang sama
@graph — revert dan re-apply lebih narrowly.
halaman adalah confirmed dapat di-crawl sebelum requesting revalidation
Test untuk jalankan: pemeriksaan URL alat di Search Console pada fixed halaman.
Yang diharapkan hasil: “URL adalah pada Google” (terjemahan) “URL adalah pada Google” (atau “URL adalah tersedia untuk Google” (terjemahan) “URL adalah tersedia untuk Google”) dengan
Tidak robots.txt block dan Tidak noindex directive.
Failure interpretation: jika halaman adalah blocked atau noindexed, Google tidak akan
re-crawl ini regardless dari bagaimana bersih schema adalah — clicking “Validate fix” (terjemahan) “Validate perbaiki”
pada sebuah blocked halaman adalah sebuah wasted cycle.
Monitoring window: Immediate — pemeriksaan URL membaca saat ini crawl dan
indeks status.
Rollback trigger: Tidak applicable di sini — ini adalah sebuah precondition periksa, tidak
sebuah perubahan untuk roll back.
Search Console’s Validate perbaiki proses resolves issue
Test untuk jalankan: di Search Console’s affected issue, click Validate perbaiki setelah confirming dua tests di atas lulus. Yang diharapkan hasil: issue’s status moves dari “Failed” (terjemahan) “Failed”/“Tidak dimulai” (terjemahan) “Tidak dimulai” untuk “Dimulai,” (terjemahan) “Dimulai,” lalu eventually untuk “Lulus,” (terjemahan) “Lulus,” dan affected-halaman count untuk itu issue drops. Failure interpretation: sebuah status dari “Failed” (terjemahan) “Failed” setelah validation berarti Google re-di-crawl dan masih ditemukan masalah — go back untuk Rich hasil Test pada langsung URL untuk see apa masih wrong sebelum re-requesting. Monitoring window: Per Google’s own guidance, “dapat take dua weeks atau lebih, depending pada crawl frequency” (terjemahan) “dapat take dua weeks atau lebih, depending pada crawl frequency” — jangan re-file yang sama issue sebelum itu window memiliki lulus. Rollback trigger: jika issue count adalah climbing alih-alih falling setelah monitoring window, perbaiki mungkin tidak applied situs-wide (e.g., hanya satu template diperbarui, tidak semua halaman menggunakan itu jenis) — audit untuk lainnya halaman masih emitting rusak markup.
standing KPI: Rich hasil report di atas time
Memperbaiki satu halaman’s schema adalah sebuah satu kali task. Watching apakah data terstruktur tetap healthy situs-wide adalah sebuah ongoing pengukuran, dan Search Console’s Rich hasil report adalah alat dibangun untuk persis itu.
Valid items (per jenis)
«Metric: The count of valid items Search Console reports for each
rich-result type your site uses (e.g., Product, Recipe, Article).
What it tells you: How many sampled items of that type currently pass
Google’s eligibility rules — the number that’s actually eligible to show a
rich result.
How to pull it: Search Console → Rich result report, filtered to the
specific type; the valid-items count and trend line are on the report’s
overview.
Benchmark / realistic range: There’s no universal healthy percentage —
what counts as “good” depends on how many pages on your site should carry
that type at all. Set your own baseline the first time you check: note the
current valid-item count, then watch for movement from that number rather
than comparing to an industry figure.
Cadence: Monthly, or right after any template/schema-plugin change —
since Google’s reports are sampled, don’t over-read week-to-week noise.
» (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian dua ratus lima, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)
Tidak valid items (per jenis)
Metric: count dari tidak valid items — items dengan setidaknya satu critical issue blocking rich-hasil eligibility. Apa ini tells Anda: Di mana baru atau unresolved errors adalah accumulating, rusak out oleh spesifik issue jenis (missing field, unparsable, dan seterusnya.) so Anda dapat prioritize yang issue memengaruhi paling halaman. cara pull ini: sama Rich hasil report, tidak valid-items table; click sebuah issue untuk see list dari affected halaman. Benchmark / realistic range: tidak pernah dibuat-buat — ini angka seharusnya trend toward zero untuk issues Anda’ve fixed, tetapi starting count adalah whatever Anda situs saat ini memiliki. gunakan Anda pertama baca sebagai baseline dan track delta setelah setiap perbaiki cycle, tidak terhadap sebuah umum target. Cadence: Monthly di minimum; periksa di dalam sebuah day atau dua dari apa pun bulk konten atau template perubahan, since sebuah rusak template dapat spike tidak valid items di seluruh setiap halaman menggunakan ini.
Unparsable data terstruktur count
Metric: item count di terpisah Unparsable data terstruktur report (malformed JSON-LD itu broke parsing entirely). Apa ini tells Anda: Apakah sebuah code-tingkat bug (sebuah template itu concatenates strings tanpa escaping quotes, misalnya) adalah actively producing rusak markup, sebagai opposed untuk sebuah konten-tingkat eligibility kesenjangan. cara pull ini: Search Console → Unparsable data terstruktur report. Benchmark / realistic range: honest target adalah zero, since unparsable markup adalah sebuah pure syntax bug, tidak sebuah judgment panggil tentang yang properties untuk sertakan — tetapi ada Tidak defensible “acceptable rate” (terjemahan) “acceptable rate” di atas zero untuk bandingkan terhadap; nilai di tracking ini metric adalah watching ini kembalikan untuk zero setelah sebuah perbaiki, tidak sebuah benchmark angka. Cadence: periksa setelah setiap deploy itu touches schema-generating code atau sebuah schema plugin perbarui; jika tidak monthly alongside lainnya dua reports.
Uji pemahaman Anda: data terstruktur Errors
Five quick pertanyaan pada errors itu block rich hasil — dan cara perbaiki them. Pick sebuah jawaban untuk setiap, lalu periksa.
Log perubahan
Diperbarui 18 Jul 2026.
Ringkasan editorial dan detail perubahan yang tercatat.Detail perubahan
- Lanjutan
Catatan perubahan terperinci saat ini tersedia dalam bahasa Inggris.
- Lanjutan
Catatan perubahan terperinci saat ini tersedia dalam bahasa Inggris.
- Ringkasan AI
Catatan perubahan terperinci saat ini tersedia dalam bahasa Inggris.
- Prompt
Catatan perubahan terperinci saat ini tersedia dalam bahasa Inggris.
Perbandingan lengkap tidak tersedia — tidak ada cuplikan sebelumnya yang diarsipkan untuk revisi ini.
Diperbarui 16 Jul 2026.
Ringkasan editorial dan detail perubahan yang tercatat.Detail perubahan
- Lanjutan
Catatan perubahan terperinci saat ini tersedia dalam bahasa Inggris.
Perbandingan lengkap tidak tersedia — tidak ada cuplikan sebelumnya yang diarsipkan untuk revisi ini.