JSON-LD 구조화 데이터 작성법 — 유형별 예시 코드와 2026 리치 결과 현황
SEO Check 편집팀 · 2026-09-28 업데이트 · 14분 읽기
구조화 데이터는 페이지 내용을 검색엔진과 AI가 기계적으로 읽을 수 있게 정리한 코드이며, 구글이 권장하는 형식은 JSON-LD입니다. 홈페이지에는 Organization(매장이 있다면 LocalBusiness)과 WebSite를 넣고, 페이지 유형에 따라 BreadcrumbList, Article, Product를 더하는 것이 기본 구성입니다. 2026년 현재 구글에서 FAQ·HowTo 리치 결과는 사라졌지만, 구조화 데이터는 상품·매장 정보 노출과 브랜드 인식의 근거로 여전히 중요합니다.
구조화 데이터와 JSON-LD란 무엇인가요?
구조화 데이터는 schema.org라는 공통 어휘로 「이 페이지는 상품이고, 가격은 39,000원이며, 재고가 있다」 같은 사실을 표시하는 방법입니다. JSON-LD는 이를 <script type="application/ld+json"> 안에 JSON으로 적는 형식으로, <head>나 <body> 어디에 넣어도 됩니다.
구조화 데이터가 하는 일은 세 가지입니다.
- 리치 결과 자격: 가격, 재고, 별점, 행사 날짜, 동영상 등이 검색 결과에 함께 표시될 수 있습니다.
- 엔티티 이해: 회사 이름, 로고, 공식 SNS를 하나의 회사로 연결해 사이트 이름과 지식 패널에 활용됩니다.
- AI 답변의 근거: 영업시간, 가격, 저자 같은 사실 정보가 명확해집니다. 다만 구글은 AI 개요·AI 모드에 노출되기 위한 별도 스키마는 필요 없으며, 구조화 데이터가 화면에 보이는 내용과 일치해야 한다고 안내합니다.
가장 중요한 원칙은 화면에 보이는 내용만 마크업하는 것입니다. 페이지에 없는 리뷰나 별점, 사실과 다른 가격을 넣으면 리치 결과에서 제외되거나 구조화 데이터 관련 수동 조치를 받을 수 있습니다.
어떤 페이지에 어떤 유형을 넣어야 하나요?
| 페이지 | 넣을 유형 | 효과 |
|---|---|---|
| 홈페이지 | Organization 또는 LocalBusiness + WebSite | 사이트 이름, 로고, 브랜드 엔티티 |
| 하위 페이지 전체 | BreadcrumbList | 데스크톱 검색 결과의 경로 표시 |
| 블로그·칼럼 | Article (BlogPosting, NewsArticle) | 제목·이미지·날짜·저자 이해 |
| 상품 상세 | Product + Offer (+ AggregateRating) | 가격·재고·별점 표시 |
| 매장·지점 소개 | LocalBusiness 하위 유형 (Restaurant, Dentist 등) | 주소·영업시간·연락처 |
| 자주 묻는 질문 | FAQPage | AI 검색용 (구글 리치 결과는 종료) |
기본 세트 — Organization과 WebSite를 @graph로 묶기
여러 유형은 @graph 배열 하나에 담고, @id로 서로를 가리키면 중복 없이 연결됩니다. @id는 실제 페이지가 아니어도 되는 고유 식별자로, 보통 주소#organization처럼 씁니다.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://www.example.co.kr/#organization",
"name": "달빛베이커리",
"url": "https://www.example.co.kr/",
"logo": "https://www.example.co.kr/images/logo-512.png",
"sameAs": [
"https://blog.naver.com/example",
"https://www.instagram.com/example",
"https://www.youtube.com/@example"
],
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+82-2-1234-5678",
"contactType": "customer service",
"areaServed": "KR"
}
},
{
"@type": "WebSite",
"@id": "https://www.example.co.kr/#website",
"name": "달빛베이커리",
"alternateName": "Dalbit Bakery",
"url": "https://www.example.co.kr/",
"inLanguage": "ko-KR",
"publisher": { "@id": "https://www.example.co.kr/#organization" }
}
]
}
</script>
- Organization: 구글 기준 필수 속성은 없지만 name, url, logo, sameAs는 꼭 넣으세요. 로고는 112×112px 이상, 흰 배경에서도 잘 보이는 이미지여야 합니다.
- sameAs: 공식 블로그, 인스타그램, 유튜브처럼 회사가 직접 운영하는 채널 주소입니다. 여러 곳의 브랜드 정보를 같은 회사로 연결하는 근거가 되어 GEO 관점에서도 중요합니다. 엔티티 개념은 전자책 PART 4에서 더 자세히 다룹니다.
- WebSite: name과 url이 필수이며 홈페이지에만 넣습니다. 구글은 이 값을 검색 결과의 사이트 이름으로 가장 우선해 참고합니다.
페이지 유형별 예시 코드
아래 예시는 각각 <script type="application/ld+json"> 안에 넣으면 됩니다.
BreadcrumbList — 경로
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "홈", "item": "https://www.example.co.kr/" },
{ "@type": "ListItem", "position": 2, "name": "시공 서비스", "item": "https://www.example.co.kr/services/" },
{ "@type": "ListItem", "position": 3, "name": "사무실 인테리어" }
]
}
마지막 항목(현재 페이지)은 item을 생략할 수 있습니다. 구글은 2025년 1월부터 모바일 검색 결과에서 경로 표시를 없애고 도메인만 보여주지만, 데스크톱에서는 계속 표시합니다.
Article — 블로그·칼럼
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "전세 계약 전 등기부등본 확인하는 방법",
"image": ["https://www.example.co.kr/images/registry-16x9.jpg"],
"datePublished": "2026-09-01T09:00:00+09:00",
"dateModified": "2026-09-20T14:30:00+09:00",
"author": {
"@type": "Person",
"name": "김하늘",
"url": "https://www.example.co.kr/about/kim-haneul"
}
}
구글은 Article에 필수 속성을 두지 않고 headline, image, datePublished, dateModified, author를 권장합니다. 이미지는 가로×세로가 5만 픽셀 이상이어야 하며 16:9, 4:3, 1:1 비율을 권장합니다. 저자는 이름만 적지 말고 저자 소개 페이지 url을 연결하세요. E-E-A-T 신뢰 신호와도 이어집니다.
Product — 상품
{
"@context": "https://schema.org",
"@type": "Product",
"name": "무릎 보호대 니가드 프로",
"image": ["https://www.example.co.kr/images/kneeguard-1x1.jpg"],
"description": "등산·러닝용 압박 무릎 보호대",
"sku": "KG-PRO-M",
"brand": { "@type": "Brand", "name": "핏가드" },
"offers": {
"@type": "Offer",
"url": "https://www.example.co.kr/products/kneeguard-pro",
"price": 39000,
"priceCurrency": "KRW",
"availability": "https://schema.org/InStock"
},
"aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.7, "reviewCount": 128 }
}
name과 함께 offers, review, aggregateRating 중 하나가 있어야 합니다. 가격은 「39,000원」이 아니라 숫자 39000으로, 통화는 KRW로 적습니다. 별점은 페이지에 실제 후기가 보일 때만 넣으세요. 직접 판매하는 페이지라면 배송비(shippingDetails)와 반품 정책(hasMerchantReturnPolicy)도 채우는 것이 좋습니다.
LocalBusiness — 매장·지점
{
"@context": "https://schema.org",
"@type": "Dentist",
"name": "바른치과의원",
"image": "https://www.example.co.kr/images/clinic.jpg",
"url": "https://www.example.co.kr/",
"telephone": "+82-2-1234-5678",
"address": {
"@type": "PostalAddress",
"streetAddress": "테헤란로 123, 4층",
"addressLocality": "강남구",
"addressRegion": "서울특별시",
"postalCode": "06234",
"addressCountry": "KR"
},
"geo": { "@type": "GeoCoordinates", "latitude": 37.50012, "longitude": 127.03621 },
"openingHoursSpecification": [{
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
"opens": "09:30:00",
"closes": "18:30:00"
}]
}
필수 속성은 name과 address입니다. @type은 Restaurant, Dentist, BeautySalon처럼 구체적인 하위 유형을 쓰고, 좌표는 소수점 5자리 이상으로 적습니다. 자기 매장에 대한 별점은 리치 결과 대상이 아니며, 지도 영역 노출은 구글 비즈니스 프로필의 영향이 더 큽니다.
FAQPage — 자주 묻는 질문
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "주차가 가능한가요?",
"acceptedAnswer": { "@type": "Answer", "text": "건물 지하 주차장을 2시간 무료로 이용할 수 있습니다." }
}]
}
페이지에 실제로 보이는 질문과 답변만 넣습니다. 구글에서 FAQ 리치 결과는 사라졌지만, 질문-답변 구조를 명시해 두면 AI 검색이 내용을 정확히 가져가는 데 도움이 됩니다.
2026년 리치 결과 현황 — 무엇이 남고 무엇이 사라졌나요?
구글은 잘 쓰이지 않는 기능을 꾸준히 정리해 왔습니다. 구글 검색 센터 문서 기준 주요 변화입니다.
| 시기 | 변화 |
|---|---|
| 2023년 8~9월 | FAQ 리치 결과를 정부·보건 분야 권위 사이트로 제한, HowTo 리치 결과 종료 |
| 2024년 11월 | 사이트링크 검색창 종료 |
| 2025년 1월 | 모바일 검색 결과에서 경로(Breadcrumb) 표시 중단, 데스크톱은 유지 |
| 2025년 6월 | 강좌 정보, 팩트체크(ClaimReview), 예상 연봉, 학습 동영상, 특별 공지, 차량 등록정보 등 단계적 종료 |
| 2025년 11월 | 연습 문제(Practice problem) 종료, Dataset은 구글 검색이 아닌 Dataset Search 전용으로 정리 |
| 2026년 5월 7일 | FAQ 리치 결과 완전 종료 |
지금도 지원되는 주요 유형은 제품(가격·재고·별점), 리뷰 스니펫, 로컬 비즈니스, 이벤트, 동영상, 레시피, 기사, 경로(데스크톱), 채용 공고, 소프트웨어 앱, 조직(로고), 그리고 토론 포럼·Q&A·프로필 페이지 등입니다. 소상공인과 중소기업이라면 Organization, WebSite, LocalBusiness, Product, BreadcrumbList, Article만 제대로 갖춰도 충분합니다. 새 유형을 추가하기 전에는 구글 검색 센터의 검색 갤러리에서 지원 여부를 확인하세요.
작성 후 검증하는 방법
- 리치 결과 테스트(search.google.com/test/rich-results): URL이나 코드를 넣으면 구글이 인식한 리치 결과 유형과 오류·경고를 보여줍니다. 구글이 지원하는 유형만 표시됩니다.
- Schema Markup Validator(validator.schema.org): 구글 지원 여부와 관계없이 schema.org 문법 전체를 검사합니다. FAQPage처럼 리치 결과가 끝난 유형은 여기서 확인합니다.
- Search Console: 개선사항 보고서에서 사이트 전체의 유효·오류 항목을 추적하고, URL 검사로 구글이 실제로 읽은 구조화 데이터를 확인합니다.
자주 나오는 오류는 마지막 항목 뒤에 남은 쉼표, 워드·한글 문서에서 복사하면서 둥근 따옴표(“ ”)로 바뀐 따옴표, 쉼표나 「원」이 들어간 가격, 2026-09-28 같은 ISO 8601 형식이 아닌 날짜, 상대 경로로 적은 이미지 주소입니다.
SEO Check에서는 이렇게 점검합니다
무료 SEO 진단은 홈페이지의 JSON-LD를 모두 읽고, @graph나 중첩된 객체 안의 항목까지 유형별로 따로 검사합니다.
-
JSON-LD 유무: 구조화 데이터가 없으면 문제로 표시합니다.
-
JSON 문법: 문법 오류가 있는 블록을 찾아냅니다. 오류가 있으면 검색엔진이 그 블록 전체를 무시합니다.
-
필수·권장 속성: Organization(name), WebSite(name·url), LocalBusiness(name·address), Article(headline), Product(name과 offers·review·aggregateRating 중 하나), Offer(price) 등 필수 속성이 빠지면 문제, 권장 속성만 빠지면 개선 필요로 표시합니다.
-
Organization·sameAs: 회사 정보와 외부 공식 프로필 연결 여부를 확인합니다.
-
WebSite: 사이트 이름 표시에 쓰이는 WebSite 스키마가 있는지 봅니다.
-
추천 코드: Organization이나 WebSite가 없으면 사이트 정보를 바탕으로 복사해 쓸 수 있는 JSON-LD 초안을 리포트에 제공합니다.
-
홈페이지에 Organization(또는 LocalBusiness)과 WebSite가 있다
-
sameAs에 공식 SNS·블로그 주소를 넣었다
-
상품·글·매장 페이지에 맞는 유형을 넣었다
-
마크업 내용이 화면에 보이는 내용과 같다
-
리치 결과 테스트에서 오류가 없다
자주 묻는 질문
구조화 데이터를 넣으면 검색 순위가 올라가나요?
JSON-LD와 마이크로데이터 중 무엇을 써야 하나요?
FAQPage 마크업은 이제 쓸모없나요?
구조화 데이터를 넣었는데 리치 결과가 나오지 않아요.
워드프레스나 쇼핑몰 솔루션에도 직접 넣어야 하나요?
이 항목, 내 사이트는 어떨까요?
무료 간편진단으로 JSON-LD 구조화 데이터를 포함한 핵심 항목을 1분 만에 확인하세요.