탭 블록 (Tab Block)
노션 탭 블록 써봤습니다 — 되는 것과 안 되는 것
결론부터 말씀드리면, 탭 블록은 기대보다 제약이 많습니다. 그런데 그 제약이 어디서 오는지를 알면 쓰는 방식이 완전히 달라집니다. 공식 릴리스노트와 API 개발자 문서를 직접 뜯어봤더니 생각지 못한 구조적 이유가 나왔습니다.
탭 블록이 이제야 나온 이유 — 수년의 내부 사용 이력
노션 공식 릴리스노트(2026.03.26)에는 탭 블록 소개 문구가 꽤 직설적으로 나와 있습니다. “Notion HQ had an internal ‘tabs’ block for years, but the secret finally got out.” (출처: notion.com/releases/2026-03-26) 직역하면 “노션 본사에서 수년간 내부적으로 탭 블록을 써왔는데, 비밀이 결국 새어 나왔다”는 뜻입니다. 즉 탭 블록은 신기술이 아니라, 노션 직원들이 자체 업무에 쓰던 기능을 드디어 외부에 공개한 것입니다.
이 사실이 중요한 이유가 있습니다. 내부 전용 기능이 외부 공개로 바뀐 순간, 기능의 완성도나 안정성보다 “쓸 수 있는 구조적 틀”이 먼저 열리는 경우가 많습니다. 실제로 API 문서를 확인해보니, 탭 블록의 직접 자식으로 허용되는 블록 타입은 paragraph 하나뿐입니다. (출처: developers.notion.com/reference/block) 내부 직원이 사용하던 방식을 그대로 열어줬기 때문에, 일반 사용자가 원하는 모든 블록을 자유롭게 집어넣는 구조는 아직 아닙니다.
기능이 갑자기 나온 게 아니라 오래 다듬어온 흔적이라는 점은 긍정적입니다. 다만 그 ‘다듬음’이 내부 사용 기준이었다는 점에서, 외부 사용 시나리오와는 간격이 있을 수 있습니다.
탭 블록 만드는 법 — /탭 하나면 끝
사용법 자체는 간단합니다. 페이지 본문에서 /탭 또는 영문으로 /tab을 입력하면 탭 블록이 생성됩니다. 이후 각 탭의 이름을 입력하고, 탭 내부에 원하는 콘텐츠를 추가하면 됩니다. 데스크톱 기준으로 클릭 가능한 탭이 상단에 생기고, 탭을 누를 때마다 내부 콘텐츠가 전환됩니다.
탭 레이블에는 아이콘도 달 수 있습니다. API 문서에 보면, 탭의 각 섹션은 paragraph 블록으로 구성되며 paragraph의 rich_text가 탭 이름이 되고, icon 필드로 탭에 아이콘을 붙일 수 있습니다. (출처: developers.notion.com/reference/block) 실제 UI에서도 탭 이름 옆에 이모지를 붙이는 것이 가능합니다.
생각보다 세팅이 간단합니다. 기존에 토글 블록을 써서 섹션을 나누던 방식보다 훨씬 깔끔하게 보이고, 긴 페이지를 스크롤 없이 탐색할 수 있습니다.
API 문서로 본 탭 블록의 실제 구조
탭 블록의 구조를 이해하려면 API 레퍼런스를 직접 봐야 합니다. 공식 개발자 문서 기준으로, 탭 블록(type: tab)의 tab 프로퍼티는 비어 있는 객체({})입니다. 탭의 모든 정보는 자식(children)인 paragraph 블록에서 가져옵니다. (출처: developers.notion.com/reference/block) 간단히 정리하면 이렇습니다.
| 구성 요소 | 역할 | 허용 여부 |
|---|---|---|
| tab 블록 자체 | 탭 컨테이너 역할 | tab 프로퍼티는 빈 객체 |
| paragraph (직접 자식) | 탭 이름 + 아이콘 정의 | ✅ 허용 (유일) |
| paragraph의 children | 탭 내부 실제 콘텐츠 | ✅ 허용 (다양한 블록) |
| tab 블록의 직접 자식에 heading/toggle 등 | 탭 이름으로 사용 | ❌ 불가 |
💡 공식 API 발표 문서와 실제 UI 구조를 같이 놓고 보니 이런 차이가 보였습니다 — 탭 블록의 자식은 반드시 paragraph여야 하고, 그 paragraph 안의 children으로 다양한 블록이 들어가는 2단 구조입니다. heading이나 toggle 블록을 탭 이름으로 쓰고 싶어도 API 구조상 불가능합니다. (출처: developers.notion.com/reference/block)
이 구조는 토글 블록과 비교하면 더 명확합니다. 토글 블록은 자체적으로 텍스트를 레이블로 갖고, 그 아래 다양한 자식 블록을 자유롭게 넣을 수 있습니다. 탭 블록은 “탭 컨테이너 → paragraph(탭 레이블) → 그 paragraph의 children(실제 콘텐츠)”라는 3단 계층을 거칩니다. 이 중간 paragraph 레이어가 탭 블록 특유의 구조이자, 현재 제약의 근원입니다.
‘데이터베이스 탭’과 헷갈리면 안 되는 이유
2026년 3월 노션 업데이트를 찾아보면 ‘탭’ 관련 기능이 두 가지나 등장합니다. 하나는 이번에 새로 공개된 탭 블록(Tab Block)이고, 다른 하나는 이전부터 존재했던 데이터베이스 탭(Database Tabbed Layout)입니다. 이 둘은 이름도 비슷하고 탭 UI를 제공한다는 점도 같지만, 동작 방식과 적용 대상이 완전히 다릅니다.
🆕 탭 블록 (Tab Block)
일반 페이지 본문에 삽입하는 블록. 어떤 페이지에서든 /탭으로 생성. 콘텐츠를 클릭 가능한 탭으로 나눔.
📋 데이터베이스 탭 레이아웃
데이터베이스 내부 페이지에만 적용. 연결된 데이터베이스 뷰를 탭으로 노출. 일반 블록과는 별도의 레이아웃 설정.
Reddit의 한 사용자(2026.03.19)는 “탭 블록은 멋지긴 한데, 기존 데이터베이스 탭 레이아웃이 더 낫다. 페이지 전체 구조를 탭으로 잡아주니까”라고 평했습니다. (출처: reddit.com/r/Notion, 2026.03.19) 이 평가는 틀리지 않습니다. 데이터베이스 탭은 페이지 수준의 레이아웃이고, 탭 블록은 페이지 내부의 콘텐츠 단위입니다. 두 기능의 용도가 겹치는 것 같아 보이지만, 실제로는 사용 맥락이 다릅니다.
데이터베이스 페이지 안에서 여러 관련 데이터베이스 뷰를 탭으로 보고 싶다면 데이터베이스 탭 레이아웃이 맞습니다. 일반 문서 안에서 정보를 탭으로 묶고 싶다면 이번 탭 블록이 맞습니다. 두 기능을 혼동하면 엉뚱한 위치에 세팅하게 됩니다.
토글·칼럼과 비교했을 때 진짜 달라지는 것
탭 블록이 나오기 전에도 노션에서 비슷한 효과를 내는 방법이 있었습니다. 토글 블록을 여러 개 나열하거나, 칼럼 블록으로 가로 분할하는 방식입니다. 탭 블록은 이 둘과 어떻게 다를까요? 공식 API 문서에 나온 구조를 기준으로 비교하면 이렇습니다.
| 구분 | 탭 블록 | 토글 블록 | 칼럼 블록 |
|---|---|---|---|
| 탐색 방식 | 클릭 → 내용 전환 | 클릭 → 펼침/접힘 | 좌우 동시 표시 |
| 스크롤 절감 | 매우 효과적 | 부분적 | 없음 |
| 직접 자식 제한 | paragraph만 | 모든 블록 | 모든 블록 |
| 아이콘 레이블 | 지원 | 이모지 앞에 붙임 | 없음 |
| API 지원 | 2026.03.25부터 | 기존 지원 | 기존 지원 |
탭 블록의 핵심 장점은 스크롤 없이 콘텐츠를 전환할 수 있다는 점입니다. 토글은 펼치면 아래로 밀려나고 스크롤이 길어지는 반면, 탭은 같은 공간 안에서 내용이 교체됩니다. 이 차이 하나가 긴 페이지에서 체감상 가장 크게 느껴집니다.
반면 자유도는 토글이 훨씬 높습니다. 탭 블록은 현재 직접 자식으로 paragraph만 받기 때문에, 탭 레이블 자체에 복잡한 서식을 적용하거나 heading 블록을 탭 이름으로 쓰는 방식은 안 됩니다. 콘텐츠 내부에는 다양한 블록을 넣을 수 있지만, 탭 레이블 레이어에서는 제약이 분명합니다.
써보면서 걸린 것들 — 공식 문서에 나온 제약
써보면서 막히는 지점이 몇 가지 있었고, 각각 이유를 확인해봤습니다.
📌 공식 개발자 문서·릴리스노트를 함께 놓고 보니 보이지 않던 구조가 보였습니다
- 탭 안에 탭(중첩)은 현재 공식 문서에서 별도 허용 여부를 밝히지 않았습니다. API 구조상 paragraph의 children으로 tab 블록을 다시 넣는 것이 기술적으로 가능한지는 이유가 아직 공개되지 않았습니다.
- 공유 스페이스에서 권한 문제가 발생할 수 있습니다. noxenstudio 분석(2025.02.27 기준 데이터베이스 탭 레이아웃 기준)에서 공유 공간의 퍼미션 이슈가 언급됐고, 탭 블록에서도 유사한 문제가 재현될 수 있습니다.
- 탭 내 콘텐츠 수정 모드: 탭 설정 변경은 디자인 커스터마이즈 모드에서만 가능하다는 점이 불편합니다. 일반 편집 중 탭 구조를 바꾸려면 별도 진입이 필요합니다.
- API 지원 시작일은 2026년 3월 25일입니다. (출처: developers.notion.com/page/changelog) 이 날짜 이전에 만들어진 탭 블록은 API로 읽었을 때
unsupported타입으로 반환됐을 수 있습니다.
솔직히 말하면, 현재 탭 블록은 ‘정식 출시된 기능’이라기보다 ‘내부에서 쓰던 것을 일반 공개한 1.0 버전’에 가깝습니다. 기능 자체는 충분히 쓸 만하지만, paragraph 자식 제약이나 중첩 탭 미지원 등은 추가 업데이트를 기다려야 하는 부분입니다.
주관적으로 가장 아쉬운 건 탭 이름 레이어입니다. heading 블록처럼 크고 굵게 탭 제목을 설정하고 싶은데, 현재는 paragraph의 rich_text로만 탭 레이블이 표현되기 때문에 시각적 강조에 한계가 있습니다.
자주 나오는 질문 5가지
Q1. 노션 탭 블록은 무료 플랜에서도 쓸 수 있나요?
Q2. 탭 블록 안에 데이터베이스를 넣을 수 있나요?
Q3. 탭 블록과 기존 데이터베이스 탭 레이아웃은 어떻게 다른가요?
Q4. API로 탭 블록을 만들거나 읽을 수 있나요?
Q5. 탭 블록 안에 탭을 또 넣을 수 있나요 (중첩 탭)?
마치며
탭 블록은 분명히 반가운 기능입니다. 긴 페이지에서 스크롤을 줄이고 콘텐츠를 직관적으로 나누는 효과는 토글이나 칼럼으로는 흉내 내기 어렵습니다. 그런데 ‘수년간 내부에서만 쓰던 기능’이라는 배경을 알고 나면, 현재 제약이 어느 정도 이해가 됩니다. 내부 직원 기준의 UX를 외부에 그대로 열어준 것이고, 일반 사용자 시나리오를 위한 다듬기는 아직 진행 중입니다.
당장 프로젝트 문서, 가이드 페이지, 온보딩 자료처럼 정보를 명확히 섹션으로 나눠야 하는 용도라면 지금 바로 써볼 만합니다. 반면 탭 레이블에 다양한 서식이 필요하거나, 탭 중첩이 필요한 복잡한 구조라면 지금 당장보다는 후속 업데이트를 보고 결정하는 편이 낫습니다.
API를 쓰는 개발자라면 2026.03.25 이후 탭 블록 지원이 시작됐다는 점, paragraph 직접 자식 구조라는 점을 미리 알고 설계하는 것이 좋습니다. 생각보다 간단한 기능이지만, 구조를 모르고 쓰면 의도한 대로 동작하지 않는 경우가 생깁니다.
본 포스팅 참고 자료
본 포스팅은 Notion 3.4 기준 (2026.03.26 출시 / API 버전 2026-03-11 및 탭 블록 지원 2026.03.25 기준)으로 작성되었습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 최신 정보는 공식 Notion 릴리스 페이지에서 확인하세요.











댓글 남기기