Etc

[error/searchconsole] ‘itemListElement’ 입력란이 누락되었습니다. – 글 삭제 경우

2025.07.14
cate-weblab

search console에서 ‘itemListElement’ 입력란이 누락되었습니다. 라는 오류 메세지가 도착했다.

해당 오류는 처음 보는 거라 확인해 보니 내가 예전에 작성해 놓은 비밀 글에서 발생한 오류였다.

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

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

해당 오류는 구글 검색의 구조화 데이터(Breadcrumb)에서 발생한 대표적인 오류라고 한다.

구글은 검색 결과에 탐색 경로(Breadcrumb) 표시하기 위해서 BreadcrumbList라는 구조화 데이터를 사용한다.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://pixiclue.com/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "LifeNote",
      "item": "https://pixiclue.com/category/lifenote/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "게시글 제목",
      "item": "https://pixiclue.com/post-slug"
    }
  ]
}

그런데 구조화 데이터에서 itemListElement가 빠져 있거나 비어 있으면 오류로 잡는다.

즉, BreadcrumbList는 있는데, 안에 들어가는 탐색 단계 목록(itemListElement) 이 비어 있다고 인식한다는 것.

특히 이번 경우는 비밀번호 보호 글이다 보니 제목, 카테고리를 가져올 수 없어서 구조화 데이터가 비어 버려서 itemListElement를 빠뜨리고 BreadcrumbList만 출력해서 생긴 문제.

큰 문제는 아니지만, 사이트 신뢰도에 부정적 영향을 준다고 하기에 고치기로 했음!

음… 그런데 막상 설명이 복잡하다…. 왜 기술?어는 복잡할까나~~~ (괜히 심통)

그래서 오류 원인은?

간단히 정리하면 : 카테고리 안에 다른 글이 있어야 하는데 비어 있다고 판단 되서 생긴 오류.

조금 복잡하게 설명하면 : BreadcrumbList를 출력했는데 itemListElement가 비어 있어서 생긴 오류.

지금 글도 카테고리가 있고 다른 글도 카테고리가 있는 데?

저 오류가 난 카테고리 내부의 모든 글이 “보호된 글” 이라서 서치에서는 실제 저 카테고리는 비었다고 판단되는 거다.

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

‘itemListElement’ 입력란이 누락되었습니다. – 해결책은?

정상적인 방법?

그냥 해당 카테고리에 글을 약 3개 정도 넣어주는 거다. 그러면 정말 간단히 해결.

아니면 카테고리 내부 글을 이동 시켜 해당 카테고리는 지우는 방법.

하지만 내 경우에 저 카테고리는 노출이 아닌 비밀 글을 쓰기 위한 카테고리라서 위 노출 게시글을 사용할 마음이 없다.

내가 선택한 방법?

그냥 과감하게 지우기~!

만약 중요했다면 그냥 글 내용은 다른 보호 글에 다시 쓰고 그건 지우기… (너무 꼼수인가….)

그리고 다른 보호된 글 들은 – 구글 검색에 노출 안되게 변경

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

그러고 나서 재 검사를 누르면

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

유효성 검사 상태: 시작됨으로 바뀌었다. 며칠이 지나면 결과 바뀔듯~~

구조화 데이터 처리에 대한 다른 이야기

처음에 찾아봤을 땐 비밀번호 보호 글이라도 Breadcrumb JSON-LD를 출력한다면 된다는 설명이 있었다.

그래서 function.php 에는 Yoast 브레드크럼 JSON-LD(사이트정보 등) 출력을 보호된 글에서만 제거하고 나머지 글에서는 유지 시켜 주는 코드를 넣어주었다.

그리고 보호된 글이 있는 single.php에는 자체 브레드크럼 JSON-LD 삽입 유지 하는 코드도 넣어주었다.

그런데, 예상과 달리 저 오류 처리가 안되는거다.

이유가 재검사를 진행하니 “유효성 검사 프로세스를 계속할 수 없음” 메시지가 뜨는 건데, 이유가 실제 오류가 아직 남아 있어서가 아니라, Google이 보호글 자체를 검사할 수 없기 때문에 발생한다고 했다.

결국, Google Search Console은 post_password_required()가 걸려 있는 보호글(비밀번호 입력 페이지)은 콘텐츠를 읽을 수 없기 때문에 브레드크럼 JSON-LD가 있어도 검사 못하고, 브레드크럼 JSON-LD를 제거해도 검사 못하는 일이 발생한 거다.

유효성 검사 프로세스를 계속할 수 없음

이후 검색에서는 처리는 되었기에 신경 쓰지 않아도 된다고 하는데 괜히 찝찝해서 해당 게시글은 어차피 보호 글이었기에 삭제하고 나중에 필요시 추가 작성하기로 마무리 한 것…

수정 후기

재 검사 신청 한지 하루가 지나자 결과가 “통과”로 나왔다.

관련 구글 설명: https://developers.google.com/search/docs/appearance/structured-data/breadcrumb?hl=ko

다른 워드프레스 글 보러가기: https://pixiclue.com/weblab/wordpress/

Etc All