이미지 ALT 태그 자동 삽입 코드 공유 (SEO 누락 방지 완전 가이드)

2025-06-27

온라인 커뮤니티나 포럼에서 이미지 알트 태그를 사용해야 좋느니 안해도 괜찮다느니 다양한 의견들이 있습니다. 알트태그까지는 신경 안써도 구글은 잘 크롤링하고 색인해준다는 사람들도 있고, 알트태그를 사용 안하면 색인에 불리하다는 사람들도 있습니다. 저는 후자의 의견에 동의합니다. 기왕 사용하라고 만든 태그인데 안 할 이유가 없겠죠? 그럼 왜 이미지 ALT태그가 중요한지 살펴보겠습니다.

SEO 최적화에서 종종 간과되는 부분 중 하나가 바로 이미지의 ‘ALT 태그’입니다. ALT(Alternative Text)는 이미지에 대한 대체 설명으로, 검색엔진이 이미지 콘텐츠를 이해하고 색인할 수 있도록 돕습니다. 또한 시각장애인 사용자에게도 중요한 정보 제공 수단이며, 구글 이미지 검색 트래픽 확보에도 핵심적인 역할을 합니다. 그러나 수많은 이미지를 일일이 수동으로 ALT 태그 작성하기란 현실적으로 어렵습니다. 이 글에서는 워드프레스에서 이미지에 ALT 태그가 누락되어 있을 경우 자동으로 삽입해주는 코드를 공유하며, SEO 누락을 방지하고 검색엔진이 선호하는 사이트 구조를 만드는 방법을 안내합니다.

1. ALT 태그란 무엇인가?

<img> 태그에서 alt 속성은 이미지가 로딩되지 않을 때 보여줄 대체 텍스트이며, 다음의 역할을 합니다:

  • 검색엔진이 이미지를 인식할 수 있도록 돕는다
  • 시각장애인 보조 기술(Screen Reader)에서 이미지 내용을 읽어줌
  • 이미지 로딩 오류 시 대체 텍스트 제공
  • 구글 이미지 검색에 색인될 가능성 높임

2. ALT 태그가 누락되었을 때 생기는 문제

문제영향
SEO 점수 하락검색엔진이 콘텐츠 완성도를 낮게 평가
접근성 저하웹 접근성 기준 WCAG 위반
이미지 검색 누락이미지 검색 유입 감소
애드센스 승인 시 불이익품질 미달 페이지로 판단될 수 있음

3. 워드프레스에서 ALT 태그 자동 삽입 코드

다음 코드를 functions.php 또는 Code Snippets 플러그인에 삽입하면, 이미지 업로드 시 자동으로 제목을 ALT 태그로 설정해줍니다.

add_filter('wp_get_attachment_image_attributes', function($attr, $attachment) {
if (empty($attr['alt'])) {
$attr['alt'] = get_the_title($attachment->ID);
}
return $attr;
}, 10, 2);

작동 방식

  • 이미지에 ALT 태그가 비어있을 경우
  • 해당 이미지의 제목(Post Title)을 ALT로 자동 삽입
  • 기존 ALT가 있다면 그대로 유지

이 방법은 ALT가 비어있는 것보다는 낫기 때문에 선택하는 방법입니다. 일부러 사용할 필요는 없지만 대부분의 사람들이 사진 하나하나마다 입력하는걸 귀찮아 하거나 번거로운 일이라 생각하기 때문에 이 태그 몇 줄로 대체하는 경우도 있습니다.

4. ALT 태그 자동 삽입 외의 추가 팁

이미지 업로드 시 제목 설정 습관화

  • 미디어 업로드 시 ‘제목’ 필드에 의미 있는 키워드를 포함
  • 이 제목이 자동 ALT로 삽입되므로 SEO 최적화 효과 발생

이미지 크기 조절 후에도 ALT 유지 확인

  • 이미지가 썸네일/중간/전체로 출력될 때도 동일 ALT 유지 확인 필요

5. 이미 업로드된 이미지에 일괄 ALT 삽입 방법

그렇다면 이미 과거에 업로드된 이미지를 찾아 하나하나 알트태그에 삽입하는 것은 매우 힘든 일입니다. 과거에 등록된 이미지들에 대해 ALT 태그가 없는 경우, 아래 코드를 실행하면 일괄적으로 제목을 ALT로 삽입이 가능합니다. 이 코드는 아주 유용하게 사용할 수 있어 공유드립니다.

function update_all_image_alts() {
$args = array(
'post_type' => 'attachment',
'post_mime_type' => 'image',
'numberposts' => -1
);
$images = get_posts($args);
foreach ($images as $image) {
if (!get_post_meta($image->ID, '_wp_attachment_image_alt', true)) {
update_post_meta($image->ID, '_wp_attachment_image_alt', get_the_title($image->ID));
}
}
}
add_action('init', 'update_all_image_alts');

⚠️ 주의: 백업 후 사용 추천

마무리

이미지 ALT 태그는 눈에 보이지 않아 무시되기 쉽지만, SEO와 웹 접근성 측면에서 매우 중요한 요소입니다. 위에서 소개한 자동 삽입 코드를 활용하면 실수 없이 ALT 누락을 방지할 수 있으며, 검색엔진 친화적이고 신뢰도 높은 콘텐츠 구조를 유지할 수 있습니다. 워드프레스를 운영한다면 지금 바로 ALT 태그 설정을 자동화해보세요. 클릭 한 번으로 사이트 품질이 달라집니다. 이는 곧 SEO 최적화에도 도움이 될 수 있다는 말입니다. 안 하는 것보다는 낫겠죠?