탐색경로 입력란 누락 오류 해결 방법

Q: 마지막 탐색경로 항목에도 URL이 필요한가요?

아닙니다. Google 문서는 마지막 항목은 item을 빼도 된다고 말합니다. Google은 그 페이지의 주소를 씁니다.

2025년 1월부터 Google은 탐색경로를 데스크톱 검색 결과에서만 보여 줍니다. 모바일에서는 도메인만 나옵니다. Google은 여전히 마크업을 읽고 탐색경로 보고서도 유지합니다.

이 페이지의 탐색경로 마크업

아래는 CrawlCoach가 이 영어 가이드에 쓰는 것과 같은 형태의 탐색경로 마크업입니다.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Structured data errors", "item": "https://crawlcoach.com/structured-data" },
    { "@type": "ListItem", "position": 2, "name": "Breadcrumbs: missing fields", "item": "https://crawlcoach.com/structured-data/breadcrumbs-missing-field" }
  ]
}
</script>

‘itemListElement’ 입력란이 누락되었습니다.

목록이 비어 있습니다. 카테고리 없는 글처럼 상위 페이지가 없는 페이지에서 생깁니다. 템플릿이 그래도 빈 BreadcrumbList를 출력합니다. Discourse가 Uncategorized 주제에서 바로 이 문제를 고쳤습니다. 항목이 있을 때만 목록을 출력하세요.

‘item’ 입력란이 누락되었습니다.(경로: 'itemListElement')

항목에 주소가 없습니다. 마지막 항목을 빼고 모든 항목에 item이 필요합니다. 마지막 항목은 Google이 페이지 자체 URL로 채웁니다. 자체 페이지가 없는 카테고리처럼 링크가 빈 중간 항목을 찾으세요.

'name' 또는 'item.name'을(를) 지정해야 합니다.(경로: 'itemListElement')

항목에 이름이 없거나 빈 문자열입니다. Yoast 지원팀은 맞춤 페이지 매김을 쓰는 아카이브 페이지에서 이것을 봤습니다. 마이크로데이터에서는 property="name" 자리에 property="item.name"을 쓴 것이 원인일 수도 있습니다.

"itemListElement": [
  { "@type": "ListItem", "position": 1, "name": "Bags", "item": "https://example.com/bags" },
  { "@type": "ListItem", "position": 2, "name": "Travel", "item": "https://example.com/bags/travel" },
  { "@type": "ListItem", "position": 3, "name": "Canvas Weekender Bag" }
]

탐색경로를 쓰는 곳

WooCommerce: 상점 페이지에서 자체 탐색경로로 BreadcrumbList를 출력합니다. Yoast SEO와 Rank Math도 출력할 수 있습니다. 리치 결과 테스트에 목록이 두 개 보이면 하나를 끄세요.
Shopify: Dawn과 Horizon은 탐색경로 마크업을 출력하지 않습니다. 스토어에 있다면 앱이나 테마 수정이 넣은 것이니 거기서 고치세요.

확인하기

보고서의 페이지를 리치 결과 테스트에 넣으세요. 탐색경로가 유효로 나와야 합니다.
Search Console의 개선사항 > 탐색경로에서 문제를 클릭하고 수정 결과 확인을 누르세요.

자주 묻는 질문

탐색경로 오류가 순위에 해가 되나요?

탐색경로 오류는 결과에 탐색경로가 나오지 않게 할 뿐입니다. 페이지는 색인된 채로 나올 수 있습니다.

마지막 탐색경로 항목에도 URL이 필요한가요?

아닙니다. Google 문서는 마지막 항목은 item을 빼도 된다고 말합니다. Google은 그 페이지의 주소를 씁니다.

모바일에서도 탐색경로가 나오나요?

아닙니다. 2025년 1월부터 데스크톱 결과에서만 보여 줍니다. 마크업은 유지하세요. Google은 데스크톱에서 계속 지원합니다.

출처

2026년 10월 8일에 확인했습니다. Google은 Search Console과 도움말을 가끔 바꿉니다. 화면이 다르게 보이면 출처를 확인하세요.

탐색경로 보고서의 '입력란이 누락되었습니다.' 오류와 고치는 방법