아스트라 테마 H1 태그 누락 홈 화면 문제 해결 방법

빙 웹마스터 도구에서 아스트라 테마 H1 태그 누락 오류가 발생하는 경우가 있습니다. 특히 홈 화면, 검색 페이지, 카테고리 페이지에서 사이트 제목이 h1 태그가 아닌 a 태그로 출력될 때 이런 문제가 나타나는 경우가 많습니다.

처음에는 게시물 내부에서 H1 태그 중복 오류를 피하기 위해 사이트 제목을 a 태그로 변경했는데, 반대로 홈 화면에서는 H1 태그가 없다는 SEO 오류가 발생했습니다. 즉, 한쪽 문제를 해결했더니 다른 페이지에서 새로운 SEO 문제가 생긴 것입니다.

이 상태를 그대로 두면 빙 웹마스터 도구에서 SEO 문제 경고가 계속 표시될 수 있으며, 검색 엔진이 페이지 구조를 제대로 이해하지 못하는 상황도 발생할 수 있습니다.

그래서 이번에는 게시물에서는 아스트라 테마 기존 a 태그를 유지하고, 홈 화면과 검색·카테고리 화면에서만 H1 태그로 변경하는 방식으로 해결한 과정을 정리해보겠습니다.

왜 아스트라 테마에서 H1 태그 누락 문제가 발생하는가

워드프레스 테마는 페이지 종류에 따라 사이트 제목 출력 방식이 달라질 수 있습니다. 특히 Astra 테마는 SEO 최적화를 위해 일부 상황에서 사이트 제목을 a 태그로만 출력하기도 합니다. 문제는 검색 엔진 입장에서는 홈 화면에 대표 H1 태그가 없다고 인식할 수 있다는 점입니다.

이 문제는 게시물 페이지에서는 잘 드러나지 않습니다. 게시물 제목 자체가 이미 H1 태그이기 때문입니다.

하지만:

메인 화면
검색 결과
카테고리 페이지
태그 페이지

같은 영역에서는 사이트 제목 자체가 H1 역할을 해야 하는 경우가 많습니다.

빙 웹마스터 도구에서 먼저 확인한 오류

빙 웹마스터 도구 아스트라 테마 H1 태그 누락 오류 화면 — 빙 웹마스터 도구 H1 태그 누락 오류

빙 웹마스터 도구의 URL 검사 기능에서 H1 태그 누락 오류가 발생한 모습입니다. 처음에는 사이트가 정상적으로 색인되고 있었기 때문에 큰 문제는 아니라고 생각할 수 있습니다.

하지만 SEO 항목에서 H1 누락 오류가 지속적으로 표시된다면 검색 엔진이 페이지 구조를 완전히 이해하지 못하는 상태일 가능성이 있습니다. 특히 홈 화면은 사이트 전체를 대표하는 페이지이기 때문에 H1 구조가 중요합니다.

원인을 확인하기 위해 개발자 도구를 점검한 과정

문제 원인을 찾기 위해 브라우저 개발자 도구(F12)를 열어 사이트 제목 구조를 확인했습니다.

사이트 제목이 a 태그로 출력되는 모습

Astra 테마 사이트 제목 a 태그 구조 확인 화면 — 홈 화면 사이트 제목 a 태그 출력 상태

개발자 도구로 확인해보면 사이트 제목이 h1이 아니라 단순 a 태그로 출력되는 것을 볼 수 있습니다. 이 상태에서는 검색 엔진이 홈 화면 대표 제목을 H1로 인식하지 않을 가능성이 있습니다.

게시물 내부에서는 문제가 없지만 메인 페이지 구조에서는 SEO 오류가 발생할 수 있는 이유가 바로 여기입니다.

해결 방식은 조건부 H1 출력

문제를 해결하기 위해 선택한 방식은 단순히 사이트 제목 전체를 H1으로 변경하는 방법이 아니었습니다.

그렇게 하면 게시물 내부에서:

게시물 제목 H1
사이트 제목 H1

이렇게 H1 태그가 두 개 생성될 수 있기 때문입니다.

그래서:

홈 화면
검색 결과
카테고리

에서는 H1 출력

그리고:

일반 게시물

에서는 a 태그 유지 방식으로 수정했습니다.

아스트라 테마 functions.php 수정 코드

아래 코드를 functions.php에 추가했습니다.

function custom_astra_site_title($title) {

    if (is_home() || is_archive() || is_search()) {

        return '<h1 class="site-title">
        <a href="' . esc_url(home_url('/')) . '">'
        . get_bloginfo('name') .
        '</a></h1>';

    } else {

        return '<p class="site-title">
        <a href="' . esc_url(home_url('/')) . '">'
        . get_bloginfo('name') .
        '</a></p>';

    }
}

add_filter('astra_site_title', 'custom_astra_site_title');

이 방식은 페이지 조건에 따라 태그를 다르게 출력하는 구조입니다.