워드프레스에 사진을 올릴 때 보이는 ‘대체 텍스트’, ‘캡션’, ‘설명’은 같은 내용을 세 번 적는 칸이 아닙니다. 화면을 보지 못하는 사람에게 사진의 의미를 전달하려면 대체 텍스트를 쓰고, 모든 독자에게 사진 아래의 보충 말을 보여 주려면 캡션을 씁니다. 설명은 미디어 라이브러리에서 사진을 관리하거나 첨부 파일 페이지를 쓰는 경우에만 필요한 긴 메모에 가깝습니다.
특히 이미 발행한 글의 사진을 나중에 고치려는 경우에는 ‘미디어 라이브러리에서 바꾸면 모든 글이 함께 바뀌겠지’라고 생각하기 쉽습니다. 하지만 이미지 블록에는 글 안에서 별도로 저장된 값이 있을 수 있습니다. 그래서 먼저 이 세 칸의 역할을 구분하고, 새 이미지와 기존 이미지에 다른 순서로 적용하는 편이 안전합니다. 이 글의 기준일은 2026년 8월 17일이며, 기본 워드프레스 블록 편집기를 기준으로 설명합니다. 테마와 페이지 빌더, 플러그인은 표시 방식을 바꿀 수 있습니다.
먼저 결론: 독자가 보는 곳과 용도가 다릅니다
대체 텍스트(alt text)는 이미지가 보이지 않거나 화면 낭독기를 쓸 때 이미지가 전달하려는 핵심 정보를 대신하는 짧은 문장입니다. 이미지가 링크나 버튼이라면 보이는 모양보다 ‘무엇을 하는 버튼인지’를 알려야 합니다. 장식뿐인 이미지라면 억지로 설명을 채우지 않고 빈 대체 텍스트가 더 적절할 수도 있습니다. W3C WAI의 이미지 안내도 이미지의 목적에 따라 대체 텍스트를 결정하라고 설명합니다.
캡션(caption)은 보통 본문에서 사진 바로 아래에 표시되는 짧은 설명입니다. 사진을 보아도 알기 어려운 촬영 시점, 비교 기준, 출처, 그림에서 읽어야 할 포인트를 덧붙일 때 유용합니다. 반면 설명(description)은 미디어 항목 자체에 붙이는 비교적 긴 설명입니다. 현재 테마가 첨부 파일 페이지를 표시하거나 별도 갤러리 기능이 이 값을 쓰지 않는 한, 일반 글의 사진 아래에 자동으로 나타난다고 기대하면 안 됩니다.
| 항목 | 주된 독자와 목적 | 일반적인 표시 위치 | 한 줄 판단 |
|---|---|---|---|
| 대체 텍스트 | 이미지의 정보·기능을 대신 전달 | 화면에는 보통 보이지 않음 | 이미지가 없으면 독자가 놓칠 내용을 적는다 |
| 캡션 | 사진을 보는 모든 독자에게 보충 정보 제공 | 이미지 아래 | 사진 아래에 보여도 도움이 될 때만 쓴다 |
| 설명 | 미디어 관리·첨부 페이지용 긴 메모 | 테마·플러그인 설정에 따라 다름 | 필요한 운영 정보가 있을 때만 쓴다 |
대체 텍스트는 ‘사진 설명문’보다 ‘빠진 정보를 메우는 문장’입니다
대체 텍스트를 잘 쓰려면 파일명이나 사진의 모든 물체를 나열하려 하지 않는 것이 좋습니다. 본문에 이미 ‘관리자 화면의 미디어 설정’이라고 적었는데 같은 말을 반복할 필요는 없습니다. 대신 독자가 사진을 보지 못했을 때 판단에 필요한 차이를 보완합니다. 예를 들어 설정 순서를 설명하는 스크린샷이라면 ‘미디어 라이브러리의 대체 텍스트 입력칸이 강조된 화면’처럼 핵심 위치와 맥락을 적을 수 있습니다.
이미지가 장식용 배경, 구분선, 의미 없는 분위기 사진이라면 긴 문장을 넣는 것이 접근성을 높이지 않습니다. 낭독기 사용자는 불필요한 문장을 계속 듣게 됩니다. 반대로 그래프, 표, 오류 메시지, 절차를 담은 스크린샷처럼 글의 결론에 필요한 이미지는 핵심 결과를 텍스트로도 제공해야 합니다. 복잡한 그래프는 alt 한 줄에 모든 수치를 넣기보다 본문이나 표에서 축, 기간, 중요한 값과 해석을 함께 설명하는 방식이 낫습니다.
‘SEO에 좋다’는 이유로 대체 텍스트에 검색어를 반복하는 방식도 피해야 합니다. 대체 텍스트는 키워드 칸이 아니라 이미지의 대체물입니다. ‘워드프레스 이미지 alt 태그 SEO 최적화 사진 블로그’처럼 반복하면 이미지의 의미를 알 수 없고, 실제 독자에게도 도움이 되지 않습니다. 워드프레스의 이미지 블록 문서는 미디어 라이브러리의 대체 텍스트가 기본값으로 쓰일 수 있음을 안내하지만, 글 안의 이미지 설정에서 문맥에 맞게 확인하는 습관이 필요합니다.
캡션은 본문을 보완할 때만 표시합니다
캡션은 독자가 실제로 읽는 텍스트입니다. 그래서 대체 텍스트와 똑같이 쓰면 같은 정보가 두 번 나타납니다. 캡션에는 ‘왼쪽은 업로드 직후, 오른쪽은 게시글에 삽입한 뒤의 설정’처럼 비교 기준을 넣거나, ‘예시 화면의 계정 이름과 주소는 가상 값’처럼 오해를 막는 말을 넣는 편이 좋습니다.
반대로 본문 바로 앞 문장이 이미지의 의미를 충분히 설명하고, 이미지가 단지 분위기를 환기하는 역할이라면 캡션 없이 두는 편이 읽기 편합니다. 이미지 아래에 매번 ‘워드프레스 이미지 예시’라고 붙이는 것은 정보가 아니라 장식성 반복이 됩니다. 캡션에는 저작권이나 출처가 필요한 경우도 있지만, 외부 사진을 쓸 때는 캡션을 붙이는 것만으로 이용 조건이 해결되는 것은 아닙니다. 사용 허가와 라이선스는 별도로 확인해야 합니다.
설명은 ‘글 아래 문구’가 아니라 미디어 항목의 메모입니다
미디어 라이브러리의 설명은 긴 배경 설명, 사진의 제작 정보, 첨부 파일 페이지에 보여 줄 내용을 정리할 때 쓸 수 있습니다. 그러나 기본 글 편집기에서 이미지를 넣었다고 해서 설명이 본문에 자동으로 노출되는 것은 아닙니다. 테마, 갤러리 플러그인, 첨부 파일 페이지 설정에 따라 결과가 달라집니다. 먼저 미리보기나 공개 페이지에서 표시 여부를 확인해야 합니다.
사진을 여러 글에 재사용하는 운영자라면 설명에 내부 관리용 맥락을 적고 싶을 수 있습니다. 하지만 공개될 가능성이 있는 필드에는 개인 연락처, 촬영 위치의 상세 주소, 계약 정보 같은 민감한 내용을 적지 않는 편이 안전합니다. 미디어 항목에는 제목, 캡션, 대체 텍스트, 설명이 각각 존재하며 역할이 다르다는 점은 워드프레스 REST API 미디어 문서에서도 확인할 수 있습니다. 이 차이 때문에 자동 발행 도구의 JSON에서 필드가 따로 보이는 것은 오류가 아닙니다.
새 사진을 넣을 때는 이 순서가 가장 단순합니다
- 먼저 사진이 글에서 맡는 역할을 한 문장으로 정합니다. 단순 장식인지, 절차를 보여 주는지, 비교 근거인지부터 구분합니다.
- 미디어 라이브러리에 올릴 때 알아보기 쉬운 제목과 파일명을 정합니다. 파일명은 대체 텍스트를 대신하지 않지만 나중에 찾는 시간을 줄입니다.
- 이미지가 전달하는 핵심을 대체 텍스트에 씁니다. 본문과 똑같은 문장이면 줄이고, 장식 이미지라면 비워 두는 선택도 검토합니다.
- 사진 아래에서 독자에게 추가로 알려 줄 정보가 있을 때만 캡션을 씁니다. 출처·비교 기준·주의 문구가 대표적입니다.
- 긴 맥락이 첨부 파일 페이지나 갤러리에서 필요할 때만 설명을 채웁니다.
- 글에 삽입한 뒤 미리보기에서 이미지 블록의 대체 텍스트와 캡션을 다시 확인합니다. 테마가 캡션을 어떻게 표시하는지도 함께 봅니다.
예를 들어 백업 절차를 설명하는 글에 ‘외장 저장장치와 폴더 구조’ 사진을 넣는다면, 대체 텍스트는 ‘날짜별 백업 폴더와 원본·수정본 폴더가 나뉜 외장 저장장치’처럼 사진의 핵심 구조를 전달할 수 있습니다. 캡션은 ‘예시 구조이며 실제 폴더 이름은 작업 방식에 맞춰 정하면 된다’처럼 사진만으로는 알 수 없는 안내를 넣습니다. 설명은 같은 사진을 팀의 자료실에서 찾기 위한 제작 배경을 남겨야 할 때만 고려합니다.
이미 발행한 글의 사진을 고칠 때는 한 번 더 확인하세요
많이 놓치는 부분은 미디어 라이브러리와 글 안의 이미지 블록이 항상 실시간으로 같은 값을 보여 주지는 않는다는 점입니다. 워드프레스 지원 포럼에는 라이브러리에서 대체 텍스트를 고친 뒤 기존 글에는 반영되지 않는지 묻는 사례가 반복해서 올라옵니다. 이는 삽입 시점의 값이나 블록별 설정, 사용 중인 테마·플러그인에 따라 다를 수 있다는 신호입니다. 따라서 기존 글의 접근성을 고치려면 라이브러리만 수정한 뒤 끝내지 말고, 실제 게시글 편집 화면과 공개 HTML을 확인하는 편이 안전합니다.
그렇다고 모든 사진을 한꺼번에 다시 넣을 필요는 없습니다. 먼저 방문자가 많이 보는 핵심 글, 정보를 전달하는 도표·설명 화면, 링크나 버튼 역할을 하는 이미지부터 점검합니다. 같은 이미지를 여러 문맥에서 썼다면 대체 텍스트도 똑같아야 한다고 단정하지 마세요. 사진 자체는 같아도 한 글에서는 ‘제품의 뒷면 포트’, 다른 글에서는 ‘전원 케이블 연결 위치’가 독자에게 중요한 정보일 수 있습니다.
발행 전 2분 점검표
- 이미지가 없으면 이해에 문제가 생기는가? 그렇다면 그 핵심이 대체 텍스트나 본문에 있는가?
- 대체 텍스트가 파일명·키워드 나열·‘이미지’라는 말로 시작하는 문장이 아닌가?
- 캡션은 사진 아래에 실제로 보일 만한 보충 정보인가?
- 설명에 공개되면 곤란한 내부 메모나 개인정보를 적지 않았는가?
- 새 사진은 미리보기에서, 기존 사진은 실제 글에서 대체 텍스트와 캡션을 확인했는가?
- 복잡한 표·그래프·스크린샷의 중요한 결론을 이미지에만 남기지 않았는가?
정리하면 대체 텍스트는 접근성과 의미 전달을 위한 문장, 캡션은 독자가 사진 아래에서 읽을 보충 설명, 설명은 미디어 항목의 긴 맥락입니다. 세 칸을 모두 채우는 것이 목표가 아니라 사진의 역할에 맞는 칸만 정확히 쓰는 것이 목표입니다. 새 이미지는 업로드할 때 기본값을 정하고, 기존 글의 이미지는 라이브러리와 게시글을 각각 확인하면 ‘분명 입력했는데 화면에는 안 보이는’ 혼란을 줄일 수 있습니다.