Kiểm tra schema JSON-LD, báo lỗi cú pháp và trường còn thiếu

Kiểm tra schema JSON-LD ngay trên trình duyệt trước khi đăng lên website. Dán mã hoặc cả đoạn HTML chứa mã vào ô bên dưới, công cụ báo lỗi cú pháp JSON và các trường hay bị thiếu ở năm loại schema phổ biến.

  • Cập nhật
  • Phiên bản 1.0
  • Chạy ngay trên máy bạn
  • Không cần đăng nhập
  • Không thay Rich Results Test

Dán mã schema cần kiểm tra

2Bấm kiểm tra (dán xong là tự chạy)

Chưa có mã? Thử hoặc

Sáu loại schema được soát kỹ

  • FAQPageHỏi đápMỗi câu hỏi cần name và acceptedAnswer.text.
  • BreadcrumbListĐường dẫn phân cấpMỗi mục cần position và name.
  • LocalBusinessDoanh nghiệp địa phươngCần name, address, nên có telephone.
  • ProductSản phẩmCần name, nên có image.
  • ArticleBài viếtNên có headline, image, datePublished, author.
  • OrganizationTổ chứcNên có name, url, logo.
Chưa chạy0 khối mã

Dán mã vào ô bên trái rồi bấm Kiểm tra schema, kết quả sẽ hiện ở đây.

Công cụ không thay thế Rich Results Test của Google. Nó chỉ soát lỗi cú pháp JSON và các trường hay bị thiếu theo schema.org, không biết Google thật sự hiển thị được gì.

Schema đã sạch lỗi nhưng website vẫn chưa lên hạng?

Schema đúng chuẩn chỉ là một phần nhỏ trong SEO kỹ thuật. SEONGON kiểm tra toàn bộ website và chỉ ra việc cần làm để bài lên hạng.

Xem dịch vụ SEO tổng thể

Câu hỏi thường gặp

Công cụ này có thay được Rich Results Test của Google không?

Không. Công cụ chỉ soát lỗi cú pháp JSON và các trường hay bị thiếu theo hiểu biết chung về schema.org, chạy ngay trong trình duyệt của bạn. Nó không biết Google thật sự đọc được gì và có hiển thị thêm kết quả phong phú hay không, nên bạn vẫn cần kiểm lại bằng công cụ chính thức của Google trước khi coi là xong.

Vì sao mã của tôi báo lỗi dù nhìn qua vẫn đúng?

Lỗi hay gặp nhất là dấu ngoặc kép bị đổi thành kiểu chữ cong khi bạn gõ hoặc dán từ Google Docs hay Word, hoặc có một dấu phẩy thừa ngay trước dấu đóng ngoặc. Hai lỗi này rất khó nhìn thấy bằng mắt, công cụ sẽ chỉ đúng vị trí nghi ngờ.

Công cụ có kiểm được mọi loại schema không?

Không. Công cụ chỉ có danh sách trường hay thiếu cho năm loại hay dùng: Organization, Article, FAQPage, BreadcrumbList và LocalBusiness, cùng một số loại gần giống như BlogPosting hay Restaurant. Loại khác vẫn được soát cú pháp JSON và các trường @context, @type, nhưng không soát được trường riêng của loại đó.

Dán cả một trang HTML dài vào có được không?

Được. Công cụ tự tìm mọi thẻ chứa mã JSON-LD trong đoạn HTML bạn dán vào, kiểm riêng từng khối, không cần bạn tự cắt lấy đúng đoạn mã.

Cách dùng kiểm tra schema trong ba bước

  1. 1Đưa vàoDán mã JSON-LD hoặc đoạn HTML
  2. 2Chọn hoặc chỉnhĐọc lỗi và trường còn thiếu
  3. 3Lấy kết quảSửa mã rồi dán lại để kiểm

Kiểm tra schema trước khi đăng để sửa các lỗi dữ liệu có cấu trúc hay gặp

Một đoạn schema nhìn qua có vẻ đúng vẫn có thể bị Google bỏ qua, nên bạn cần soát lỗi trước khi đưa lên website. Schema là đoạn mã ẩn mô tả nội dung trang cho máy tìm kiếm, còn dữ liệu có cấu trúc là tên gọi chung của loại mã này. Phần dưới giải thích cách đọc kết quả của công cụ và cách sửa từng nhóm lỗi, dựa trên các bài hướng dẫn trên blog SEONGON. Cuối mỗi mục có liên kết tới bài gốc để bạn đọc đầy đủ.

Kết quả của công cụ chia ba mức để bạn biết việc nào cần sửa ngay

Mỗi khối mã được xếp vào một trong ba mức, nên bạn sửa theo thứ tự từ nặng tới nhẹ. Mức nặng nhất là lỗi cú pháp JSON, tức đoạn mã viết sai quy tắc nên máy không đọc được gì cả. Công cụ chỉ ra hai nguyên nhân hay gặp là dấu ngoặc kép cong do dán từ Word hay Google Docs, và dấu phẩy thừa ngay trước dấu đóng ngoặc. Mức thứ hai là dòng "Lỗi", nghĩa là thiếu trường bắt buộc, ví dụ câu hỏi FAQ không có câu trả lời. Mức nhẹ nhất là dòng "Nên có", nghĩa là mã vẫn đúng nhưng còn thiếu thông tin giúp hiển thị đầy đủ hơn.

Năm lỗi schema hay gặp, trong đó lỗi cú pháp làm hỏng cả khối mã

Phần lớn lỗi schema thuộc năm nhóm quen thuộc, nên bạn có thể dò theo danh sách này khi công cụ báo lỗi. Bài tổng hợp công cụ kiểm tra dữ liệu có cấu trúc của SEONGON liệt kê năm nhóm lỗi dưới đây, kèm ví dụ cho từng nhóm.

Năm lỗi thường gặp của dữ liệu có cấu trúc
Năm lỗi thường gặp của dữ liệu có cấu trúc. Ảnh trong bài 11 công cụ kiểm tra dữ liệu có cấu trúc trên blog SEONGON.
  • Thiếu trường bắt buộc khiến trang không đủ điều kiện hiển thị đẹp, ví dụ sản phẩm thiếu giá thì Google không hiện giá.
  • Sai định dạng xảy ra khi ngày viết kiểu ngày-tháng-năm thay vì năm-tháng-ngày, hoặc giá không kèm đơn vị tiền.
  • Nội dung không khớp xảy ra khi tên hay giá trong mã khác với tên hay giá hiện trên trang.
  • Dùng sai loại schema xảy ra khi gắn loại sự kiện cho một trang sản phẩm.
  • Lỗi cú pháp như thiếu dấu ngoặc hay dấu phẩy làm máy không đọc được toàn bộ khối mã, nên cần sửa đầu tiên.

Nguồn: 11 công cụ kiểm tra dữ liệu có cấu trúc uy tín miễn phí & trả phí, blog SEONGON.

Cảnh báo về trường nên có không chặn hiển thị, còn thiếu trường bắt buộc thì có

Bạn cần tách hai loại thông báo vì chúng có mức ảnh hưởng rất khác nhau. Theo bài tìm hiểu về schema của SEONGON, thiếu bất kỳ trường bắt buộc nào thì trang sẽ không được hiển thị đặc biệt trên kết quả tìm kiếm. Các trường được khuyến nghị thì không bắt buộc, nhưng điền càng đủ thì trang càng có lợi khi hiển thị.

Kết quả kiểm tra schema sản phẩm có 0 lỗi và 7 cảnh báo về trường được khuyến nghị
Schema sản phẩm có 0 lỗi nhưng 7 cảnh báo về trường được khuyến nghị. Ảnh trong bài Tìm hiểu về Schema trên blog SEONGON.

Trong ví dụ trên, schema sản phẩm vẫn hợp lệ nhưng còn thiếu thương hiệu, điểm đánh giá và hạn áp dụng giá. Bài viết cũng nhắc rằng khi đánh dấu một mục trong một danh sách, bạn phải đánh dấu tất cả các mục còn lại.

Nguồn: Tìm hiểu về Schema - Một yếu tố không thể thiếu trong SEO hiện nay, blog SEONGON.

Sau khi đăng, Search Console báo những trang có schema không đọc được

Kiểm tra trước khi đăng chưa đủ, vì lỗi có thể phát sinh khi giao diện hay plugin thay đổi sau này. Theo bài hướng dẫn sử dụng Google Search Console của SEONGON, báo cáo "Không thể phân tích cú pháp dữ liệu có cấu trúc" liệt kê các trang có mã sai nặng tới mức Google không nhận ra đó là loại schema gì.

Báo cáo Không thể phân tích cú pháp dữ liệu có cấu trúc trong Google Search Console
Báo cáo lỗi cú pháp dữ liệu có cấu trúc trong Search Console. Ảnh trong bài Google Search Console là gì trên blog SEONGON.

Khi báo cáo có trang lỗi, bạn mở trang đó, chép đoạn mã schema và dán vào công cụ này để tìm đúng chỗ sai. Sửa xong, bạn kiểm lại bằng Rich Results Test, công cụ kiểm tra kết quả nhiều định dạng của Google, rồi theo dõi báo cáo cho tới khi số trang lỗi về 0.

Nguồn: Google Search Console là gì? Hướng dẫn sử dụng GSC [2026], blog SEONGON.

Kiến thức nên đọc thêm khi kiểm tra schema

Bài viết trên blog SEONGON

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