JSON-LD

JSON-LD는 JSON을 기반으로 연결된 데이터를 표현하는 형식입니다. 웹페이지에서는 작성자·글·기관 등의 의미와 관계를 명시하는 데 사용할 수 있으며, 어떤 검색 결과 표시를 자동으로 만들어 주는 기능 이름은 아닙니다.¹

제작 방식: AI로 자료 조사와 초안 작성을 보조했습니다.

쉬운 설명: JSON에 의미를 해석할 맥락을 더합니다

JSON은 객체·배열·문자열 같은 값을 표현하는 데이터 형식입니다. 쉼표와 따옴표 등이 올바르지 않으면 데이터로 읽는 단계부터 실패할 수 있습니다. JSON-LD도 먼저 이 기본 문법을 지켜야 합니다.²

JSON-LD의 @context는 용어를 어떤 의미로 해석할지 정하는 맥락입니다. @type은 대상의 유형을 표현하고 @id는 대상을 식별하는 데 사용합니다. 속성의 이름만 닮았다고 서로 같은 의미라고 판단하지 않고, 사용하는 어휘와 맥락을 함께 봐야 합니다.¹

예를 들어 Schema.org의 Person은 인물을 표현하는 유형입니다. JSON-LD는 그 유형을 담는 형식이고, Person이라는 의미는 어휘 체계에서 가져옵니다. 형식과 어휘를 구분해야 'JSON-LD를 넣었다'는 말만으로 어떤 내용이 추가됐는지 알 수 없다는 점도 이해할 수 있습니다.³

웹페이지에 스크립트 블록으로 넣은 데이터는 보통 본문처럼 눈에 보이지 않습니다. 그렇다고 공개되지 않는 내부 메모 공간은 아닙니다. 페이지에서 제공되는 데이터이므로 개인정보나 비공개 고객 자료, 확인하지 않은 수치와 자격을 넣지 않아야 합니다.

실무에서는 세 가지 오류를 나눕니다

아래는 게시글 작성자 데이터를 검수하는 가상의 적용 예시입니다. 복사해 배포할 완성 코드 대신 확인할 값을 먼저 정리했습니다.

Google 구조화 데이터 정책은 페이지의 주된 내용과 관련 있고 정확한 정보를 제공하도록 요구합니다. 형식 검사를 통과했더라도 공개 화면과 다른 정보를 넣었다면 그것으로 검수가 끝나지 않습니다. 검색 서비스의 정책과 기술 요구사항을 나눠 확인해야 합니다.⁴

실무에서는 변경 전후 출력 데이터를 비교하는 것이 유용합니다. 제목을 바꿨을 때 본문 제목만 바뀌고 데이터에는 이전 값이 남지 않는지, 작성자 기본값이 다른 글로 번지지 않는지, 비공개 전환 뒤에도 공개 대상 정보가 남지 않는지 같은 항목을 정합니다. 이는 CMS의 실제 데이터 흐름에 맞춰 검수할 제안입니다.

식별자는 단순한 장식 문자열로 다루지 않습니다. 한 사람을 표현하려는지 해당 웹페이지를 표현하려는지 구분하고, 실제 존재가 확인되지 않은 저자 소개 페이지를 임의로 만들지 않습니다. 주소를 식별자로 사용한다고 그 주소가 사실 확인 없이 유효해지는 것도 아닙니다.

웨비스튜디오 작업 기록

세무 서비스 사이트 A에서는 게시글 JSON-LD의 작성자를 공개 작성자 필드와 연결하고 게시글 유형 정보를 보완한 기록이 있습니다. 기존 데이터가 있는지 먼저 확인한 뒤 실제 저자 표시와 연결한 작업입니다. 이 사례는 출력 보완에 관한 것이며 특별한 검색 표시나 AI 인용 증가를 입증하지 않습니다.

자주 하는 실수와 수정 기준

중괄호만 맞으면 충분하다고 생각하는 것. 읽을 수 있는 JSON과 올바른 JSON-LD 의미, 검색 기능의 지원은 서로 다릅니다. 검사 결과를 한 가지 '정상'으로 뭉뚱그리지 않습니다.¹²

예제의 인물·날짜·주소를 그대로 사용하는 것. 예제는 구조를 설명하기 위한 자료입니다. 실제 공개 정보로 바꾸고 근거가 없는 필드는 필요 여부를 다시 판단합니다. 빈칸을 가상의 사실로 채우면 안 됩니다.⁴

공통 데이터와 페이지별 데이터를 섞는 것. 사이트 운영 주체와 개별 글의 작성자는 같은 대상이 아닐 수 있습니다. 여러 위치에서 서로 다른 값이 나오는지도 확인합니다.

JSON-LD를 검색 성과 보장 장치로 파는 것. 데이터 형식은 의미 전달 수단입니다. Google의 지원 기능과 정책을 충족하더라도 표시를 보장하지 않으며, 검색 성과에는 별도 관측이 필요합니다.⁴

FAQ

JSON과 JSON-LD는 같은 파일 형식인가요?

JSON-LD는 JSON을 사용하는 연결 데이터 형식입니다. 기본 JSON 문법뿐 아니라 맥락과 유형·식별자 등의 의미를 함께 해석해야 합니다. 아무 JSON 객체나 넣었다고 JSON-LD 의미가 자동 완성되지는 않습니다.¹²

JSON-LD를 넣으면 화면 디자인이 바뀌나요?

기계용 데이터 자체와 화면 렌더링은 별개입니다. 다만 실제 적용 방식에 따라 페이지 코드가 달라질 수 있으므로 공개 출력과 기존 화면에 영향이 없는지는 검수해야 합니다.

작성자 정보를 JSON-LD에만 넣어도 되나요?

공개 페이지와 사실이 일치하는지가 우선입니다. 사람에게 보이지 않는 별도 설명만으로 작성자의 실체를 만들어서는 안 됩니다. 사용하는 검색 기능의 정책도 함께 확인해야 합니다.³⁴

공식 출처

공식 문서 확인일: 2026-11-03. 표준의 개념 설명이며 특정 라이브러리 설치·구현 안내가 아닙니다.

출처 링크

• https://www.w3.org/TR/json-ld11/
• https://www.rfc-editor.org/rfc/rfc8259.html
• https://schema.org/Person
• https://developers.google.com/search/docs/appearance/structured-data/sd-policies