
마크업과 화면이 다를 때 — 구조화 데이터에서 실제로 위험한 실수
속성 몇 개가 빠진 것보다 위험한 것은 화면에 없는 내용을 마크업에 적는 것입니다. 가격·평점·페이월에서 자주 나오는 불일치 유형과, 자동 생성 구조에서 어긋남을 막는 점검 방법을 정리했습니다.
구조화 데이터 점검에서 속성 누락은 고치기 쉬운 문제입니다. 필수 속성이 없으면 그 기능이 동작하지 않을 뿐입니다. 실제로 위험한 것은 화면에 없는 내용을 마크업에 적어 둔 상태입니다. 이쪽은 정책에 어긋나고, 대개 사람이 의도해서 만든 것이 아니라 자동 생성 과정에서 남습니다.
자주 나오는 네 가지 유형
1. 화면에 없는 가격
할인 기간이 끝나 화면 가격은 12,000원으로 돌아갔는데, 마크업에는 9,000원이 남아 있는 상태입니다. 가격이 CMS 필드와 마크업 템플릿 두 곳에서 각각 관리되면 반드시 생깁니다.

2. 자사가 만든 평점
내부에서 정한 별점이나 자체 설문 결과를 리뷰 마크업으로 넣는 경우입니다. 자사가 만든 리뷰·평점 마크업은 허용되지 않습니다. 외부에서 수집해 옮겨 붙인 평점도 대상이 아닙니다.
3. 목록 페이지에 개별 제품 정보
카테고리 페이지에 첫 번째 상품의 Product 블록이 붙는 경우입니다. 목록 페이지는 판매자 등록정보 대상이 아닙니다. 상품 카드 컴포넌트가 마크업을 함께 출력하도록 만들어져 있으면 목록에서도 그대로 나갑니다.
4. 페이월 콘텐츠를 표시하지 않음
로그인 뒤에만 본문이 보이는 페이지에서, 수집기에는 전체 본문을 주고 사용자에게는 일부만 보여 주는 구조입니다. 이때 구독 콘텐츠임을 표시하는 마크업이 없으면 서로 다른 내용을 보여 주는 것으로 판단될 수 있습니다.
어긋남이 생기는 이유
| 구조 | 왜 어긋나는가 |
|---|---|
| 마크업을 별도 템플릿 변수로 관리 | 화면 값과 마크업 값의 출처가 둘이어서 한쪽만 바뀝니다 |
| 마크업을 사람이 직접 작성 | 콘텐츠 수정 시 마크업을 함께 고치는 절차가 없습니다 |
| 컴포넌트가 마크업을 내장 | 그 컴포넌트를 쓰는 모든 페이지에서 함께 출력됩니다 |
| 플러그인이 자동 생성 | 설정이 페이지 역할을 구분하지 못합니다 |
해결 방향은 하나입니다. 화면에 값을 그리는 데이터와 마크업이 쓰는 데이터를 같은 출처로 만드는 것입니다. 가격 하나를 두 곳에서 관리하는 구조를 없애면 이 유형의 문제는 대부분 사라집니다.
점검 절차

- 템플릿을 바꾼 배포에서는 표본 3개 페이지의 마크업을 확인합니다. 목록, 상세, 홈 각각 한 개면 됩니다.
- 가격·재고·평점이 바뀌는 이벤트에서는 마크업 동기화를 확인합니다. 할인 시작일보다 종료일이 더 자주 어긋납니다.
- 분기마다 페이지 역할별 표본을 점검합니다. 목록 페이지에 상세용 마크업이 붙지 않았는지, 폐기된 타입이 남아 있지 않은지 봅니다.
확인 순서
- 페이지 소스에서
application/ld+json을 찾아 값 하나하나를 화면과 비교합니다. - 특히 숫자를 봅니다. 가격, 통화, 평점, 개수는 어긋나도 화면에서는 보이지 않습니다.
- 마크업에만 있고 화면에 없는 속성이 있으면, 그 속성을 지우거나 화면에 값을 표시합니다.
오늘 할 일
가격이 표시되는 페이지 한 개를 골라 화면 값과 마크업 값을 직접 비교해 보십시오. 두 값이 같으면 그 페이지는 넘어가고, 다르면 값의 출처가 몇 개인지부터 확인하시면 됩니다.
같은 주제의 다른 글
구조화 데이터- 구조화 데이터
FAQ 마크업은 이제 필요 없나 — 남은 것과 없어진 것
구글의 FAQ 리치 결과는 2023년 8월 대상이 제한된 뒤 2026년 5월 검색 결과에서 제거됐습니다. 그러면 FAQ 페이지 자체를 접어야 하는가에 대한 답과, 마크업을 걷어낼지 남길지 판단하는 기준을 정리했습니다.
- 구조화 데이터
JSON-LD 어디부터 붙이나 — 지금도 값이 있는 최소 세트
구조화 데이터 기능은 상당수가 폐기되거나 국내에서 자격이 없습니다. 남아 있는 것 중 대부분 사이트에 필요한 최소 세트와, 페이지 역할별로 무엇을 붙이고 무엇을 붙이지 않는지 정리했습니다.