워드프레스 Gutenberg 제목 블록 기본값을 H5로 변경하는 방법

워드프레스의 블록 에디터(Gutenberg)를 사용하다 보면 제목(Heading) 블록을 자주 추가하게 됩니다. 그런데 새 제목 블록을 삽입할 때마다 기본값이 항상 H2로 설정되어 있어, 매번 원하는 단계(H3, H4, H5 등)로 변경하는 작업이 번거롭게 느껴질 수 있습니다.

특히 내부 문서 작성, 제품 설명 페이지, 커스텀 템플릿 운영처럼 이미 상위 제목 구조가 정해져 있는 환경에서는 H5를 반복적으로 사용하는 경우가 많습니다. 이럴 때는 워드프레스의 필터를 활용해 제목 블록의 기본 레벨 자체를 H5로 변경하면 작업 속도를 높이고 실수를 줄일 수 있습니다.

기본 제목이 H2인 이유

워드프레스 Gutenberg 에디터에서 제목 블록(core/heading)은 기본적으로 H2를 사용하도록 설계되어 있습니다.

이는 일반적인 블로그 글을 기준으로 한 기본 설정입니다.

• 페이지 제목(H1)은 워드프레스 테마가 출력
• 본문의 첫 번째 주요 제목은 H2
• 하위 내용은 H3, H4 순으로 구성

이 구조는 대부분의 콘텐츠에서 SEO와 문서 구조를 고려한 합리적인 기본값입니다.

하지만 모든 사이트가 이러한 구조를 사용하는 것은 아닙니다.

예를 들어 다음과 같은 경우에는 H5를 기본값으로 사용하는 편이 더 효율적입니다.

• 이미 상위 Heading이 템플릿에서 자동 생성되는 경우
• 제품 정보나 옵션 설명처럼 작은 섹션 제목을 반복해서 작성하는 경우
• 사내 문서나 기술 문서처럼 H5를 가장 많이 사용하는 워크플로우
• 커스텀 블록이나 페이지 빌더와 함께 사용하는 환경

제목 블록 기본값을 H5로 변경하는 방법

워드프레스는 블록 등록 시 전달되는 속성을 필터로 수정할 수 있습니다.

다음 코드를 테마의 functions.php 또는 사이트 전용 기능 플러그인에 추가하면 제목 블록의 기본 Heading 레벨을 H5로 변경할 수 있습니다.

add_filter('register_block_type_args', function($args, $block_type)
{
    if ('core/heading' !== $block_type) {
        return $args;
    }

    $args['attributes']['level']['default'] = 5;

    return $args;
}, 10, 2);

코드를 저장한 후 새로운 제목 블록을 추가하면 기본 선택값이 H5로 설정됩니다.

코드가 하는 역할

코드의 동작은 매우 단순합니다.

먼저 register_block_type_args 필터를 이용해 블록이 등록될 때 전달되는 설정을 수정합니다.

이후 현재 등록 중인 블록이 core/heading인지 확인하고, 제목 블록이 아니라면 아무 변경 없이 원래 설정을 그대로 반환합니다.

제목 블록인 경우에는 level 속성의 기본값(default)을 5로 변경합니다.

즉, 제목 블록을 새로 삽입할 때 사용자가 별도로 선택하지 않아도 기본 Heading 레벨이 H5가 되는 것입니다.

적용 시 알아둘 점

이 설정은 새로 추가하는 제목 블록의 기본값만 변경합니다.

이미 작성되어 있는 글이나 기존 제목 블록의 Heading 레벨은 변경되지 않습니다.

또한 H5를 기본값으로 설정하더라도 필요하면 개별 블록에서 H2, H3, H4, H6으로 자유롭게 변경할 수 있습니다.

SEO와 접근성도 함께 고려해야 한다

Heading 태그는 단순히 글자를 크게 표시하는 기능이 아니라 문서의 계층 구조를 나타내는 중요한 HTML 요소입니다.

따라서 편의성만을 이유로 모든 제목을 H5로 사용하는 것은 권장되지 않습니다.

다음과 같은 원칙을 함께 고려하는 것이 좋습니다.

• 문서의 계층 구조를 논리적으로 유지한다.
• H1 다음에 반드시 H5를 사용해야 하는 것은 아니다.
• 디자인이 아니라 콘텐츠 구조를 기준으로 Heading을 선택한다.
• 화면 낭독기와 검색 엔진이 이해하기 쉬운 구조를 유지한다.

만약 사이트 전체가 H5 중심의 구조를 갖도록 설계되어 있다면 이번 방법은 작업 효율을 높이는 데 도움이 됩니다. 반면 일반적인 블로그나 콘텐츠 사이트라면 워드프레스의 기본 H2 설정을 그대로 유지하는 편이 더 적합한 경우가 많습니다.

마무리

Gutenberg는 다양한 필터와 훅(Hook)을 통해 기본 동작을 손쉽게 변경할 수 있습니다. 제목 블록의 기본 Heading 레벨 역시 register_block_type_args 필터 하나만으로 원하는 값으로 변경할 수 있으며, 반복적인 편집 작업이 많은 환경에서는 생산성을 높이는 작은 개선이 될 수 있습니다.

중요한 것은 기본값을 변경하는 것보다 사이트 전체의 Heading 구조를 일관성 있게 유지하는 것입니다. 워크플로우와 콘텐츠 구조를 함께 고려해 H5가 실제로 가장 많이 사용되는 환경이라면, 이 방법은 단순하지만 효과적인 커스터마이징이 될 것입니다.