# 구조화된 데이터 마크업 문제 해결하기

Source: https://support.wix.com/ko/article/%EA%B5%AC%EC%A1%B0%ED%99%94%EB%90%9C-%EB%8D%B0%EC%9D%B4%ED%84%B0-%EB%A7%88%ED%81%AC%EC%97%85-%EB%AC%B8%EC%A0%9C-%ED%95%B4%EA%B2%B0%ED%95%98%EA%B8%B0 (updated 2026-10-09)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

> **중요!**
>
> * 구조화된 데이터 마크업은 고급 주제입니다. Wix 고객지원팀에서는 사이트 마크업 변경 또는 제출과 관련된 지원을 제공하지 않습니다.
> * 전문가의 도움이 필요한가요? Wix Marketplace에서 [SEO 전문가를 고용할 수 있습니다](https://www.wix.com/arena/dynamic-brief/welcome-page?entry=SEOWizard&serviceType=6&innerType=1&origin=seo%5Fsupport%5Farticles).

구조화된 데이터 마크업은 사이트 페이지의 상세한 정보를 검색 엔진에 제공하는 표준 형식입니다.페이지에 마크업을 추가하면 사이트의 검색 결과와 순위를 개선하는 데 도움이 될 수 있습니다.

Google과 같은 검색 엔진에서는 마크업을 사용해 페이지 검색 결과에 표시되는 기사 미리보기, 제품 미리보기, FAQ 등의 [리치 결과를 생성](https://developers.google.com/search/docs/advanced/structured-data/search-gallery)할 수도 있습니다. [구조화된 데이터 마크업 추가에 대해 자세히 알아보세요](https://support.wix.com/ko/article/adding-structured-data-to-your-site).

마크업에 문제가 있으면 AI에도 영향을 줄 수 있습니다. 자연어 웹(NLWeb)을 사용해 사이트를 검색하는 도구에서 불완전한 결과를 반환하거나, AI 엔진에서 잘못된 정보를 사실로 인용할 수 있습니다.

리치 결과 도구에서 마크업이 리치 결과에 적합하다고 표시되지만 사이트 페이지에 추가할 때 문제가 발생한다면 아래 단계에 따라 해결하세요.

---

## 1단계 | 마크업 형식 확인하기

Wix 사이트 페이지에는[JSON-LD 형식](https://json-ld.org/)의 마크업만 사용할 수 있습니다. 아래에서 JSON-LD 마크업 예시를 확인할 수 있습니다.

```json
<script type="application/ld+json">
{
    "@context":"https://schema.org",
    "@type":"Website", 
    "name":"Wix.com", 
    "alternateName":"Wix", 
    "url":"https://wwww.wix.com"
}
</script>
```

코드가 다음 조건을 충족하는지도 확인합니다.

* HTML 태그 로 끝나는지 확인합니다.
* 스크립트 태그를 하나만 사용하고 주요 마크업 유형도 하나만 포함하는지 확인합니다.
* 문자 수가 7,000자 미만인지 확인합니다.

> **참고:** 페이지 하나에 추가할 수 있는 마크업의 전체 글자 수는 총 8,000자입니다.

---

## 2단계 | JSON-LD 내부의 HTML 태그 확인하기

마크업에서 사용할 수 있는 HTML 태그는 코드의 시작과 끝에 있는 스크립트 태그뿐입니다. JSON-LD 부분에 HTML 태그를 입력하면 마크업이 유효성 검사를 통과하지 못합니다. 예를 들어 다음 코드는 스크립트에  태그가 포함되어 있어 유효하지 않습니다.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9dcc39dd-da6f-4c38-b1c3-ee79d33f39d5/2021/07/09/6daeff06-49df-4661-bdd8-4732376600a1/cfab331e-7746-4410-a74f-7cfe0122e88b.png)

---

## 3단계 | 문장 부호 확인하기

마크업 내 각 JSON-LD 요소는 중괄호 **{ }**로 감싸야 합니다. 또한 각 요소 사이에는 쉼표를 추가해야 하지만, 마지막 요소 뒤에는 쉼표를 추가하면 안 됩니다.

코드에 곧은따옴표 ""를 사용했는지도 확인합니다. 둥근따옴표 “”를 사용하면 코드가 유효성 검사를 통과하지 못합니다.

아래는 문장 부호가 잘못된 마크업의 예시입니다. "name" 줄 뒤에 쉼표가 누락되어 검증 문제가 발생합니다.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9dcc39dd-da6f-4c38-b1c3-ee79d33f39d5/2021/09/02/2adbe6fd-597a-44d7-89f5-6be020d84d57/37b34a57-c770-4dbd-81dd-17bd1d106cbb.png)

아래는 검증 문제를 해결하기 위해 "name" 줄 뒤에 쉼표를 추가한 동일한 마크업입니다.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9dcc39dd-da6f-4c38-b1c3-ee79d33f39d5/2021/09/02/6e973cd4-87a3-4db0-8d42-dcec982e982b/33d6f9d9-8bdf-41d6-bbb7-398203f0c75a.png)

---

## 4단계 | 입력란의 공백 확인하기

모든 입력란은 "key":"content" 형식이어야 하며, 각 입력란은 한 줄에 작성해야 합니다. 'Enter' 키를 눌러 줄 바꿈하면 해당 입력란이 유효성 검사를 통과하지 못합니다.

예를 들어 아래 입력란은 한 줄로 작성되어 유효성 검사를 통과합니다.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9dcc39dd-da6f-4c38-b1c3-ee79d33f39d5/2021/07/09/8ebdfd91-a8c6-46a6-ab9d-827312528b42/cba6f29b-cb73-4347-8526-9257e6580c46.png)

반면 아래 입력란은 일부 내용이 줄바꿈 되어 있어 유효성 검사를 통과하지 못합니다.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9dcc39dd-da6f-4c38-b1c3-ee79d33f39d5/2021/07/09/811f6b70-6704-4245-a2cc-e356dc68c653/bbd47da7-3bb1-41d7-b023-ce70b39850c8.png)

---

> **중요!**
>
> * [Google 가이드라인](https://developers.google.com/search/docs/appearance/structured-data/sd-policies#quality-guidelines%5F1)에 따라 마크업의 정보는 페이지에도 포함되어야 합니다. 마크업에 포함된 일부 정보가 페이지에 표시되지 않으면 리치 결과로 표시되지 않을 수 있습니다.
> * 마크업이 리치 결과로 표시될 자격이 있는지 확인하거나 마크업 문제를 해결하려면 [Google 리치 결과 테스트 도구](https://search.google.com/test/rich-results?utm%5Fcampaign=sdtt&utm%5Fmedium=code)에 마크업을 붙여넣어 확인할 수 있습니다.

> **도움말:** 다음 검색 엔진에서 지원하는 마크업 유형에 대해 자세히 알아보세요: 
>
> * [Google](https://developers.google.com/search/docs/guides/search-gallery)
> * [Bing](https://www.bing.com/webmaster/help/marking-up-your-site-with-structured-data-3a93e731)
> * [Yandex](https://yandex.com/support/webmaster/site-content/data-transmit.html)

전문가에게 SEO 관련 도움을 받아보세요. 

[전문가 고용하기](https://www.wix.com/marketplace/brief-auto-match/marketing-promoting?entry=promote&origin=seo-articles&startStep=SERVICES&deep=false)
