Static Metadata Board

정적 메타데이터는 검색 결과와 공유 미리보기를 같은 문맥으로 묶는다

App Router의 metadata 객체는 라우트 계층에서 병합됩니다. 기본값은 layout에 두고 페이지의 고유한 제목과 설명은 page에서 덮어씁니다.

1

기본값 선언

루트 layout에 사이트 이름, 기본 설명, 대표 이미지를 둡니다.

app/layout.tsx
2

페이지 고유화

page.tsx에서 title과 description을 실제 콘텐츠에 맞게 덮어씁니다.

metadata
3

공유 이미지

OG와 Twitter 이미지는 접근 가능한 절대 URL과 alt를 확인합니다.

openGraph
4

인덱싱 제어

공개 페이지와 비공개 페이지의 robots 설정을 명확히 나눕니다.

robots
5

렌더 확인

빌드 후 head 태그와 소셜 디버거에서 실제 출력을 확인합니다.

<head>
병합 규칙

하위 라우트는 같은 키를 덮어쓰고 필요한 속성만 추가합니다

모든 페이지에 전체 metadata를 반복하면 관리가 어려워집니다. 공통 브랜드 정보는 상위 layout에 두고, 달라지는 항목만 하위에서 작성합니다.

layout -> page
영역
필수 항목
흔한 실수
검증 방법
검색 결과
title, description
모든 페이지 동일
검색 스니펫 확인
소셜 공유
og, twitter
상대 이미지 경로
공유 디버거
크롤링
robots
비공개 페이지 index
head 출력 확인