워드프레스 Gutenberg 제목 블록 기본값을 H5로 변경하는 방법
워드프레스의 블록 에디터(Gutenberg)를 사용하다 보면 제목(Heading) 블록을 자주 추가하게 됩니다. 그런데 새 제목 블록을 삽입할 때마다 기본값이 항상 H2로 설정되어 있어, 매번 원하는 단계(H3, H4, H5 등)로 변경하는 작업이 번거롭게 느껴질 수 있습니다.
특히 내부 문서 작성, 제품 설명 페이지, 커스텀 템플릿 운영처럼 이미 상위 제목 구조가 정해져 있는 환경에서는 H5를 반복적으로 사용하는 경우가 많습니다. 이럴 때는 워드프레스의 필터를 활용해 제목 블록의 기본 레벨 자체를 H5로 변경하면 작업 속도를 높이고 실수를 줄일 수 있습니다.
기본값을 바꾸기 전에 실제 사용 단계를 세어 본다
기본값을 H5로 바꾸는 것이 맞는지는 사이트마다 다릅니다. 판단 근거는 취향이 아니라 지금 어떤 단계를 실제로 쓰고 있는가입니다. 운영 중인 블로그 70편의 소제목을 전부 세어 봤습니다.
| 단계 | 개수 | 비중 | 글당 평균 |
|---|---|---|---|
| H2 | 479개 | 79.8% | 6.8개 |
| H3 | 121개 | 20.2% | 1.7개 |
| H4 이하 | 0개 | 0% | 0개 |
결과가 분명합니다. H2와 H3만 쓰고 H4 아래는 한 번도 쓰지 않았습니다. 이런 사이트에서 기본값을 H5로 바꾸면 소제목을 넣을 때마다 단계를 올려야 합니다. 손이 줄기는커녕 늘어납니다.
코어의 기본값이 왜 H2인지도 이 숫자가 설명해 줍니다. 실제 파일을 열어 보면 이렇게 정의돼 있습니다.
wp-includes/blocks/heading/block.json
"level": { "type": "number", "default": 2 }그러면 어떤 사이트에서 바꾸는 것이 맞나
위 분포가 뒤집히는 경우입니다. 글의 큰 단계를 템플릿이 이미 출력하고, 본문에서는 작은 항목만 반복하는 구조라면 H5가 기본값이 될 수 있습니다. 제품 사양표, 사내 문서, FAQ 묶음처럼 항목 하나하나가 짧게 반복되는 화면입니다.
바꾸기 전에 확인해 볼 것이 하나 더 있습니다. 자신의 글에서 H2와 H3의 비율입니다. 위 사이트는 대략 4대 1이었습니다. 이 비율이 1대 1에 가까워지거나 H4 이하가 나오기 시작하면 단계 구조가 깊어진 것이고, 그때는 기본값을 손보는 편이 실제로 도움이 됩니다.
비율이 한쪽으로 크게 기운 상태라면 기본값보다 먼저 볼 것은 글의 구조입니다. H2만 여덟 개씩 늘어놓는 글은 단계 문제가 아니라 묶음이 없는 문제일 수 있습니다.
기본 제목이 H2인 이유
워드프레스 Gutenberg 에디터에서 제목 블록(core/heading)은 기본적으로 H2를 사용하도록 설계되어 있습니다.
이는 일반적인 블로그 글을 기준으로 한 기본 설정입니다.
- 페이지 제목(H1)은 워드프레스 테마가 출력
- 본문의 첫 번째 주요 제목은 H2
- 하위 내용은 H3, H4 순으로 구성
이 구조는 대부분의 콘텐츠에서 SEO와 문서 구조를 고려한 합리적인 기본값입니다.
하지만 모든 사이트가 이러한 구조를 사용하는 것은 아닙니다.
예를 들어 다음과 같은 경우에는 H5를 기본값으로 사용하는 편이 더 효율적입니다.
- 이미 상위 Heading이 템플릿에서 자동 생성되는 경우
- 제품 정보나 옵션 설명처럼 작은 섹션 제목을 반복해서 작성하는 경우
- 사내 문서나 기술 문서처럼 H5를 가장 많이 사용하는 워크플로우
- 커스텀 블록이나 페이지 빌더와 함께 사용하는 환경
| 이런 사이트라면 | 기본값 | 이유 |
|---|---|---|
| 일반 블로그·콘텐츠 사이트 | H2 유지 | 테마가 H1을 출력하고 본문 첫 단계가 H2 |
| 상위 제목이 템플릿에서 자동 생성 | H5 | 본문에서 큰 단계를 다시 쓸 일이 없음 |
| 제품 옵션·사양처럼 작은 섹션 반복 | H5 | 매번 레벨을 내리는 손이 줄어듦 |
| 사내·기술 문서 워크플로 | 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가 실제로 가장 많이 사용되는 환경이라면, 이 방법은 단순하지만 효과적인 커스터마이징이 될 것입니다.
