Softonic

브레드크럼 Schema position 오류 해결하기

단계 1 / 2

항목당 한 줄: 이름 | URL

다음: 결과

테스트 도구가 브레드크럼 마크업에 position 필드 값이 필요하다고 알리는 경우가 있습니다. 가장 간단한 해결책은 모든 ListItem에 연속된 position이 들어가도록 목록을 다시 만드는 것입니다. 아래에 경로를 입력하면 번호는 생성기가 매겨 줍니다.

올바른 position으로 목록 다시 만들기

  1. 1

    기존 마크업에서 단계 옮기기

    문제가 있는 블록에서 이름과 URL을 꺼내 순서대로 "이름 | URL" 줄로 적습니다.

  2. 2

    불완전한 줄 제거

    모든 줄에 이름과 URL이 모두 있는지 확인하세요. 하나라도 빠진 줄은 도구가 건너뜁니다.

  3. 3

    생성

    결과 화면으로 이동합니다. position은 1에서 시작해 단계마다 1씩 늘어납니다.

  4. 4

    기존 블록 교체

    문제가 있는 script를 페이지에서 지우고 새 블록을 붙여넣은 뒤 다시 테스트합니다.

position 오류가 나타나는 이유

BreadcrumbList의 각 ListItem에는 경로에서의 자리를 나타내는 정수 position 이 필요합니다. 오류는 보통 다음 중 하나입니다.

  • 하나 이상의 항목에 position 키가 없다.
  • position이 문자열로 적혀 있거나 비어 있다.
  • 두 항목이 모두 2인 것처럼 번호가 중복된다.
  • 1, 2, 4처럼 번호가 건너뛴다.
  • 수동으로 또는 템플릿이 단계를 추가했는데 카운터가 갱신되지 않았다.

도구가 다르게 처리하는 점

생성기는 position을 입력받지 않습니다. 줄을 위에서 아래로 읽으면서 이름과 URL이 모두 있는 줄에 1, 2, 3…을 부여합니다. 건너뛴 줄이 있어도 빈 번호가 생기지 않으므로 번호는 항상 연속됩니다.

깨진 목록과 다시 만든 목록 예시

검사기에 들어간 잘못된 입력: position이 1, 2, 4이고 3이 빠진 항목들.

도구로 다시 만든 입력:

홈 | https://example.com/
문서 | https://example.com/docs/
설정 | https://example.com/docs/setup/

출력 position은 1, 2, 3입니다.

마크업을 교체한 뒤에

  1. 충돌하는 두 목록이 페이지에 남지 않도록 기존 script 블록을 완전히 제거합니다.
  2. 새 블록을 붙여넣습니다.
  3. 게시된 URL을 다시 테스트합니다.

오류가 계속될 때

테마, 플러그인, 또는 잊고 있던 템플릿이 만들어 내는 두 번째 BreadcrumbList가 없는지 확인하세요. 이 도구는 복사한 블록만 만들기 때문에 다른 곳에서 생성된 잔여물은 그 출처에서 제거해야 합니다. 또한 모든 URL이 완전한지, 이름이 비어 있지 않은지도 확인하세요.

모든 브레드크럼 마크업에 쓰는 빠른 자체 점검

다시 테스트하기 전에 블록에서 네 가지를 확인하세요. 모든 ListItem에 position이 있는가, position이 중복 없이 1, 2, 3으로 이어지는가, 모든 ListItem에 name이 있는가, 모든 ListItem에 URL이 있는가. 네 가지가 모두 맞다면 position 오류는 더 이상 나타나지 않아야 합니다. 일반 목록에서 블록을 생성하는 것이 가장 확실한 방법입니다. 번호 실수를 손으로 입력할 일이 없어지기 때문입니다.

자주 묻는 질문

표준 순서는 1부터 시작하며, 이 도구도 그렇게 작성합니다.

이름과 URL이 모두 있지 않은 줄은 건너뜁니다. 빠진 부분을 파이프 문자 앞이나 뒤에 추가하세요.

아니요. 입력한 경로에서 단계의 순서만 나타냅니다.

안전하지 않습니다. 검사기는 이 필드를 필수로 취급하므로 반드시 포함하세요. 도구가 자동으로 넣어 줍니다.

관련 도구

UTM 링크 빌더

UTM의 source, medium, campaign, term, content 파라미터로 캠페인 추적 URL을 만듭니다. 광고와 뉴스레터에 바로 쓸 수 있는 깔끔한 URL 인코딩 링크.

UTM 파서

캠페인 URL을 붙여넣으면 다섯 개의 표준 UTM 태그(source, medium, campaign, term, content)를 각 값이 디코딩된 상태로 읽어줍니다. 추적 링크를 보내기 전에 빠르게 점검하는 방법입니다.

SERP 미리보기

게시하기 전에 구글 검색 결과를 미리 확인하세요. 실시간 글자 수 카운터가 너무 긴 제목과 메타 설명을 알려주고, 구글 스타일 스니펫으로 결과가 어떻게 보이는지 보여줍니다.

사이트맵 생성기

URL 목록을 붙여넣어 changefreq, priority, 선택적 lastmod가 포함된 유효한 XML 사이트맵을 생성하세요. 저장해 Search Console에 제출할 준비가 됩니다.

보안 헤더 분석기

HTTP 응답 헤더를 붙여넣으면 중요한 보안 헤더에 대한 우선순위별 조언을 받을 수 있습니다: Content-Security-Policy, Strict-Transport-Security, X-Frame-Options, Referrer-Policy 등.

URL에서 SERP 스니펫 미리보기

URL을 붙여넣고 그 제목, 메타 설명, 표준 URL이 구글 스니펫으로 어떻게 나타나는지 바로 확인하세요. 페이지에서 직접 가져오며 수동 복사가 필요 없습니다.

이 도구는 다른 언어로도 제공됩니다

사용 가이드와 활용 사례