구조·마크업 · 공식 문서
구조화 데이터 직접 조치, 위반 찾기와 재검토 순서
문제가 됩니다. 구글은 페이지 독자에게 보이지 않는 내용을 마크업하지 말라고 적었고, 어기면 구조화 데이터 직접 조치로 리치 결과 자격을 잃을 수 있습니다. 영향받는 페이지 전부에서 마크업을 화면에 맞추거나 지운 뒤 직접 조치 보고서에서 검토를 요청합니다.
JSON-LD 는 화면에 보이지 않아서, 별점이나 FAQ를 마크업에만 넣고 싶은 유혹이 생깁니다. 리치 결과 테스트는 문법을 보므로 이런 차이는 그대로 통과합니다.
구글은 이 부분을 사람이 보는 품질 가이드라인으로 다룹니다. 어기면 서치 콘솔에 직접 조치가 뜨고, 풀려면 고친 뒤 검토를 요청해야 합니다.
발견 01
화면에 없는 내용을 마크업하면 가이드라인 위반이고, 직접 조치는 리치 결과 자격을 거둡니다
Don't mark up content that is not visible to readers of the page. For example, if the JSON-LD markup describes a performer, the HTML body must describe that same performer.
페이지 독자에게 보이지 않는 내용을 마크업하지 말라. 예를 들어 JSON-LD 가 어떤 공연자를 설명하면 HTML 본문도 같은 공연자를 설명해야 한다.
| 구글이 적은 것 | 원문 |
|---|---|
| 화면에 없는 내용은 마크업하지 않음 | Don't mark up content that is not visible to readers of the page. For example, if the JSON-LD markup describes a performer, the HTML body must describe that same performer.페이지 독자에게 보이지 않는 내용을 마크업하지 말라. 예를 들어 JSON-LD 가 어떤 공연자를 설명하면 HTML 본문도 같은 공연자를 설명해야 한다. |
| 관련 없거나 오해를 부르는 내용(가짜 후기 등)은 마크업하지 않음 | Don't mark up irrelevant or misleading content, such as fake reviews or content unrelated to the focus of a page.가짜 후기나 페이지 주제와 관계없는 내용처럼 관련 없거나 오해를 부르는 내용을 마크업하지 말라. |
| 직접 조치는 리치 결과 자격을 거두고, 웹 검색 순위에는 영향이 없음 | 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.구조화 데이터 직접 조치를 받으면 페이지가 리치 결과로 표시될 자격을 잃지만, 구글 웹 검색 순위에는 영향이 없다. |
| 품질 가이드라인은 자동 도구로 시험하기 어려움 | These quality guidelines are not easily testable using an automated tool.이 품질 가이드라인은 자동 도구로 쉽게 시험할 수 없다. |
리치 결과 테스트를 통과했다고 안전한 것은 아닙니다. 테스트는 문법과 필수 속성을 보고, 화면과 같은지는 사람이 확인합니다.
순위가 함께 떨어졌다면 구조화 데이터가 아닌 다른 원인을 따로 봅니다. 구조화 데이터 직접 조치는 리치 결과 자격만 거둡니다.
발견 02
보고서의 구조화된 데이터 문제는 23가지이고, 일반 사이트에서 나올 만한 것은 9가지입니다
Google has detected that some of the markup on your pages may be using techniques that are outside our structured data guidelines, for example: marking up content that is invisible to users, marking up irrelevant or misleading content, or other manipulative behavior.
구글이 페이지 마크업 일부가 구조화 데이터 가이드라인을 벗어난 기법을 쓰는 것을 감지했다. 예: 사용자에게 보이지 않는 콘텐츠 마크업, 관련 없거나 오해를 부르는 콘텐츠 마크업, 기타 조작 행위.
| 보고서 항목(한국어판) | 흔한 자리(예) | 고칠 것 | 원문 설명 |
|---|---|---|---|
| 구조화된 데이터가 콘텐츠와 일치하지 않음 | 가격·상호·전화번호가 바뀌었는데 JSON-LD 만 옛 값 | 화면 값과 같게 맞춥니다 | Content on pages found to be different than structured data on the page. This is against our guidelines.페이지 콘텐츠가 페이지의 구조화 데이터와 다르다. 가이드라인 위반이다. |
| 숨겨진 콘텐츠에서 구조화된 데이터가 발견됨 | 화면에 없는 FAQ·후기를 마크업에만 넣음 | 화면에 보이게 하거나 마크업에서 뺍니다 | Structured data found on elements that are not visible to the user. This is against our guidelines.사용자에게 보이지 않는 요소에서 구조화 데이터가 발견됐다. 가이드라인 위반이다. |
| 목록 페이지의 구조화된 데이터에 문제가 있음 | 카테고리 목록에 상품 여러 개의 별점을 하나로 합침 | 항목마다 따로 마크업하거나 뺍니다 | Pages with a list of items need to have each item marked up individually. Aggregating data from multiple items into one structured data element is against our spam policies.항목 목록이 있는 페이지는 항목마다 따로 마크업해야 한다. 여러 항목의 데이터를 하나의 구조화 데이터 요소로 합치면 스팸 정책 위반이다. |
| 회사가 제품으로 표시됨 | 회사 소개 페이지를 Product 로 표시 | Organization 으로 바꿉니다 | A company has been labeled as a product in structured data.구조화 데이터에서 회사가 제품으로 표시됐다. |
| 제품이 아닌 항목에 제품 라벨이 지정됨 | 서비스 안내·카테고리 페이지를 Product 로 표시 | Product 마크업을 뺍니다 | A non-product, or generic item, has been marked as a product.제품이 아니거나 일반적인 항목이 제품으로 표시됐다. |
| 서비스 제공 사이트 또는 제공자가 리뷰를 작성함 | 회사가 직접 고른 추천사에 별점 마크업 | 별점 마크업을 뺍니다 | Reviews must not be written or provided by the business or content provider unless they are customer, independent, and unpaid editorial reviews.고객이 쓴 독립적이고 대가 없는 리뷰가 아니라면, 사업자나 콘텐츠 제공자가 리뷰를 쓰거나 제공하면 안 된다. |
| 새로운 리뷰를 제출하기 위한 메커니즘이 없음 | 후기 출처도, 후기를 남길 곳도 없는 별점 | 후기 작성 경로나 출처를 보이게 합니다 | If a page includes a review, the page must also provide a way to provide a review or clearly show where the reviews come from.페이지에 리뷰가 있으면 리뷰를 남길 방법을 두거나 리뷰 출처를 분명히 보여야 한다. |
| 구조화된 이벤트 데이터가 실제로는 홍보임 | 할인 행사·판매 안내를 Event 로 표시 | Event 마크업을 뺍니다 | The visible text or structured data description is more concerned with promoting or selling the event than describing it.보이는 텍스트나 구조화 데이터 설명이 이벤트를 설명하기보다 홍보·판매에 치우쳐 있다. |
| 이벤트가 아닌 항목에 이벤트 라벨이 지정됨 | 휴무일·쿠폰을 Event 로 표시 | Event 마크업을 뺍니다 | A non-event item has been marked as an event. For example, a holiday or a coupon.이벤트가 아닌 항목이 이벤트로 표시됐다. 예: 휴일, 쿠폰. |
공통점은 하나입니다. 마크업이 말하는 것과 화면이 보여 주는 것이 다릅니다. 별점·후기 조건은 「리뷰 스니펫 별점」 편에 자세히 적었습니다.
발견 03
고치고 재검토를 요청하는 순서는 7단계이고, 영향받는 페이지 전부를 고쳐야 합니다
| 순서 | 할 일 | 원문 |
|---|---|---|
| 1 | 직접 조치 보고서에서 조치 설명을 펼쳐 영향받는 페이지 패턴을 봅니다. | Expand the manual action description to see a list of patterns of affected pages.직접 조치 설명을 펼치면 영향받는 페이지의 패턴 목록을 볼 수 있다. |
| 2 | 패턴에 해당하는 템플릿의 JSON-LD 와 화면을 나란히 놓고, 화면에 없는 값을 찾습니다. | Your structured data must be a true representation of the page content.구조화 데이터는 페이지 콘텐츠를 사실대로 나타내야 한다. |
| 3 | 값을 화면에 맞추거나, 맞출 수 없는 마크업은 지웁니다. | This might require updating existing markup or removing any markup that violates our guidelines.기존 마크업을 고치거나 가이드라인을 어긴 마크업을 지워야 할 수 있다. |
| 4 | 영향받는 모든 페이지에 반영합니다. 일부만 고쳐서는 일부도 돌아오지 않습니다. | Fix the issue on all affected pages. Fixing the issue on just some pages will not earn you a partial return to search results.영향받는 모든 페이지에서 문제를 고쳐라. 일부 페이지만 고쳐서는 검색 결과에 일부만 돌아오지 않는다. |
| 5 | 로그인·페이월·robots.txt·noindex 로 구글이 못 들어오는 페이지가 없는지 URL 검사로 봅니다. | Be sure that Google can reach your pages; affected pages should not require a login, be behind a paywall, or be blocked by robots.txt or a noindex directive.구글이 페이지에 접근할 수 있게 하라. 영향받는 페이지는 로그인·페이월 뒤에 있거나 robots.txt·noindex 로 차단돼 있으면 안 된다. |
| 6 | 보고서에서 검토 요청을 선택하고, 문제·고친 과정·결과를 적습니다. | When all issues listed in the report are fixed in all pages, select Request Review in this report.보고서의 모든 문제를 모든 페이지에서 고쳤으면 이 보고서에서 검토 요청을 선택하라. |
| 7 | 결정 메일이 올 때까지 다시 제출하지 않고 기다립니다. | Most reconsideration reviews can take several days or weeks, although in some cases, such as link-related reconsideration requests, it may take longer than usual to review your request.재검토는 대부분 며칠에서 몇 주 걸리며, 링크 관련 재검토 요청처럼 평소보다 오래 걸리는 경우도 있다. |
| 재검토 요청에 적을 것 | 원문 |
|---|---|
| 무엇이 문제였는지 | Explains the exact quality issue on your site.사이트의 품질 문제가 정확히 무엇인지 설명한다. |
| 무엇을 고쳤는지 | Describes the steps you've taken to fix the issue.문제를 고치려고 한 조치를 적는다. |
| 고친 결과 | Documents the outcome of your efforts.그 노력의 결과를 기록해 보여 준다. |
발견 04
B2B·B2C·B2G 사이트마다 화면과 어긋나기 쉬운 마크업이 다릅니다
예시 ① 회사 소개 페이지를 Product 로 표시한 장비 제조사(B2B)
회사 소개 페이지에 Product 와 별점을 넣었고, 별점은 영업팀이 고른 고객 추천사였습니다.
Product 를 Organization 으로 바꾸고 별점 마크업은 지웁니다. 추천사는 화면에 사례로 남깁니다.
예시 ② 품절·가격 변경이 마크업에 늦게 반영되는 쇼핑몰(B2C)
화면은 품절인데 JSON-LD 는 재고 있음, 가격도 할인 전 값이었습니다. 마크업을 따로 관리하는 플러그인이 원인이었습니다.
마크업 값을 화면과 같은 데이터에서 만들게 바꾸고, 영향받는 상품 전부에 반영한 뒤 검토를 요청합니다.
예시 ③ 휴관일을 Event 로 표시한 공공기관 누리집(B2G)
기관 문화시설 페이지가 휴관일과 할인 쿠폰 안내를 Event 로 표시했습니다. 보고서의 「이벤트가 아닌 항목」에 해당합니다.
실제 공연·강좌만 Event 로 두고 휴관일은 마크업에서 뺍니다. 유지보수 수행사에는 마크업 값 기준을 문서로 넘깁니다.
그럼 직접 조치 알림을 받았다면 무엇부터 하나요?
- 직접 조치 보고서에서 조치 설명을 펼쳐 영향받는 페이지 패턴을 봅니다.
- 패턴에 해당하는 템플릿의 JSON-LD 와 화면을 나란히 놓고, 화면에 없는 값을 찾습니다.
- 값을 화면에 맞추거나, 맞출 수 없는 마크업은 지웁니다.
- 영향받는 모든 페이지에 반영합니다. 일부만 고쳐서는 일부도 돌아오지 않습니다.
- 로그인·페이월·robots.txt·noindex 로 구글이 못 들어오는 페이지가 없는지 URL 검사로 봅니다.
- 보고서에서 검토 요청을 선택하고, 문제·고친 과정·결과를 적습니다.
- 결정 메일이 올 때까지 다시 제출하지 않고 기다립니다.
- 검토를 기다리는 동안 새로 만드는 템플릿에도 같은 기준을 적용합니다. 테스트 오류 고치는 법은 「리치 결과 테스트 오류」 편에 자세히 적었습니다.
조사 방법
- Google Search Central 「General structured data guidelines」 (문서 수정일 2026-07-10) · 최종 확인일 2026-10-25 · https://developers.google.com/search/docs/appearance/structured-data/sd-policies
- Search Console Help 「Manual Actions report」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/9044175
- 보고서 항목 23가지는 받은 날 한국어판 「구조화된 데이터 문제」 표의 제목 전체이고, 그중 9가지를 일반 사이트에서 나올 만한 것으로 고른 것은 편집 판단입니다.
- 고치는 순서 7단계는 위 문서가 적은 해결 절차를 순서로 묶은 것입니다. 묶는 방식은 편집 판단입니다.
- 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
- 원문은 영어판(hl=en)이고, 도구·보고서 이름은 같은 문서 한국어판(hl=ko) 표기를 따랐습니다.