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.

Pertama kali diterbitkan: 2 Jul 2026 · Terakhir diperbarui: 3 Agu 2026 · Lanjutan

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.

TL;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.

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 JavaScript

Errors vs. warnings — apa sebenarnya blocks sebuah rich hasil

Debug di order: membuat markup readable, membuat item eligible, lalu verify itu ini matches halaman dan policy. Sumber: Google Search Central

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?

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.

Tambahkan catatan pakar

Sematkan kutipan pakar

Orang baru? Buat profilnya yang belum diklaim di /admin/experts/ → Sematkan kutipan pakar terlebih dahulu.