OG 이미지 가이드 — 카톡 썸네일 안 나올 때 해결법

청첩장 링크를 카톡에 보냈는데 썸네일이 안 나오거나 깨지는 경우의 원인과 해결법을 정리합니다.

1. OG 태그 기본 구조

<meta property="og:title" content="..." />
<meta property="og:description" content="..." />
<meta property="og:image" content="https://example.com/og.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />

본 도구는 위 스니펫을 자동 생성합니다. 청첩장 HTML 의 <head>에 삽입하세요.

2. 권장 이미지 사이즈

표준 OG: 1200 × 630 (페북·X·카톡 이미지형).
카톡 카드형: 800 × 400 또는 800 × 600 가로 비율.
정사각형: 1080 × 1080 (인스타 공유용).

3. 카톡 썸네일이 안 나올 때

카카오 디버거 접속 → kakao.com/tool/debugger/sharing.
청첩장 URL 입력 후 "새로 읽어오기" 클릭. 캐시된 오래된 썸네일을 강제 갱신.
이미지 크기 5MB 이하, HTTPS 필수.
이미지 URL 이 상대경로면 절대경로로 수정.

4. 페이스북 디버거

facebook.com/tools/debug. 카톡과 동일하게 새로 읽어오면 썸네일 캐시가 초기화됩니다.

5. X (Twitter) 카드

twitter:card 를 summary_large_image 로 설정해야 큰 이미지로 노출됩니다.

6. 카톡 텍스트만 보임 이슈

서버 응답 지연 → 카톡은 크롤러 타임아웃이 짧음. CDN 캐싱 권장.
이미지 URL 이 robots.txt 로 차단 → 허용하도록 수정.
청첩장 플랫폼(해피밀리·오플리 등)의 자체 OG 가 우선 → 플랫폼에서 표지 이미지 변경.

OG 이미지 · 카톡 썸네일 가이드