대표이미지를 설정했는데 보이지 않거나 잘릴 때 확인하는 순서

먼저 이미지 파일과 지정 상태를 확인한다

글 편집 화면의 설정 사이드바에서 대표이미지 미리보기가 의도한 파일인지 확인합니다. 본문에 이미지를 삽입한 것만으로는 대표이미지로 지정되지 않습니다. 반대로 대표이미지를 지정했다고 본문 블록 안에 자동으로 들어가는 것도 아닙니다.

미디어 상세 정보에서 대체 텍스트가 이미지의 목적을 설명하는지, 파일이 실제로 열리는지 확인합니다. 장식용 이미지에 키워드를 반복해 넣지 말고, 정보 전달에 필요한 이미지라면 보이지 않는 독자도 이해할 수 있는 짧은 설명을 씁니다.

WordPress: 글·페이지 설정의 대표이미지 · 문서 확인 2026-10-02

문제가 나타나는 화면을 세 구간으로 나눈다

로그아웃 창에서 홈 또는 글 목록, 개별 글 상단, 소셜 공유 미리보기용 메타데이터를 따로 확인합니다. 목록만 비어 있다면 목록 템플릿, 개별 글만 비어 있다면 Single 템플릿의 출력 구성을 우선 살핍니다. 한 화면의 결과를 전체 사이트 결과로 일반화하지 않습니다.

1. 문제가 있는 글의 공개 URL을 열고 본문 상단을 확인합니다.
2. 그 글이 노출되는 카테고리나 홈 목록을 열어 썸네일을 비교합니다.
3. 테마 편집이 가능한 경우 해당 템플릿에 Featured Image 블록이 있는지 확인합니다.
4. 캐시를 지우기 전후의 URL과 시간을 기록해 같은 조건으로 다시 봅니다.

잘림은 원본 크기보다 표시 비율부터 본다

Featured Image 블록이나 테마가 고정 종횡비를 사용하면 원본 일부가 잘릴 수 있습니다. 블록의 aspect ratio와 scale 설정에서 cover는 영역을 채우는 대신 잘릴 수 있고, contain은 전체를 보이지만 빈 공간이 남을 수 있습니다. 중요한 글자나 얼굴을 가장자리에 배치한 이미지는 화면 폭에 따라 문제가 더 커집니다.

같은 이미지를 무작정 더 큰 파일로 바꾸기 전에 데스크톱과 좁은 화면에서 실제 잘림 위치를 확인합니다. 비율을 바꿨다면 목록 카드 높이와 레이아웃 이동도 함께 봅니다.

WordPress: Post Featured Image 블록 설정 · 문서 확인 2026-10-02

중복과 테마 차이는 템플릿에서 해결한다

본문 첫 블록에 같은 이미지를 넣고 템플릿도 대표이미지를 출력하면 두 장이 연속으로 보일 수 있습니다. 어느 쪽을 콘텐츠의 일부로 유지할지 정한 뒤 한 곳만 제거합니다. 여러 글에서 공통으로 생기는 문제라면 개별 글을 모두 수정하기보다 템플릿 구조를 먼저 확인합니다.

클래식 테마와 블록 테마는 대표이미지를 출력하는 위치와 편집 방식이 다를 수 있습니다. 테마 문서나 자식 테마 구성을 확인하지 않은 채 템플릿 파일을 직접 덮어쓰지 않습니다. 업데이트 후 변경이 사라질 수 있기 때문입니다.

수정 완료를 공개 화면에서 판정한다

관리자 미리보기만으로 끝내지 말고 로그아웃 상태의 홈, 카테고리, 개별 글을 확인합니다. 이미지 요청이 200인지, 대체 텍스트가 의도대로인지, 모바일에서 제목이나 메뉴를 밀어내지 않는지도 봅니다. 소셜 공유 이미지가 별도 플러그인에서 관리된다면 대표이미지 수정과 분리해 확인합니다.

완료 기록에는 글 URL, 문제가 난 화면, 바꾼 설정 한 가지, 확인한 화면 폭과 남은 예외를 적습니다. 실제 테마에서 재현하지 못한 항목은 해결됐다고 표시하지 않습니다.