소셜·커뮤니티 · 공식 문서

오픈그래프 캐시 삭제, 카카오톡 미리보기 확인 순서

예전 이미지가 계속 보이는 것은 공유 플랫폼이 처음 읽은 og 태그 값을 캐시로 저장해 두기 때문이고, 카카오는 초기화 도구의 OG 캐시 메뉴에서 URL별로 지웁니다. 미리보기가 아예 안 나오면 og 태그가 <head> 에 있는지, og:image 를 외부에서 열 수 있는지부터 봅니다.

og 태그를 고쳤는데 카카오톡에는 예전 제목과 이미지가 그대로 뜨는 일이 흔합니다. 페이지가 아니라 공유 플랫폼 쪽에 저장된 값이 보이는 것입니다.

미리보기가 아예 안 나오는 경우는 원인이 다릅니다. 둘을 나눠서 보면 어디를 고칠지 바로 정해집니다.

발견 01

예전 이미지가 계속 보이는 것은 카카오 플랫폼에 저장된 캐시 때문이고, 초기화 도구에서 URL별로 지웁니다

미리보기 이미지나 문구 변경 사항이 반영되지 않는 경우는 캐시(cache) 데이터 때문에 생기는 현상으로, [도구] > [초기화 도구] > [OG(Open Graph) 캐시] 메뉴에서 카카오 플랫폼에 저장된 웹 페이지나 파일의 URL을 입력하여 캐시 데이터를 삭제할 수 있습니다.
카카오디벨로퍼스 「메시지 템플릿 > FAQ」
카카오가 적은 것원문
지운 뒤에도 그대로일 때만약 캐시 데이터를 삭제한 후에도 기존 이미지나 문구가 나타난다면, 아래 내용을 참고합니다.
① og 태그 값 확인웹 페이지를 스크랩한 경우, og 태그 값이 올바르게 입력되어 있는지 확인하기
② 새 대화방에서 시험카카오톡 채팅방을 나갔다가 다시 만들어 테스트 메시지 발송
카카오가 할 수 있는 범위카카오 플랫폼에서는 OG 프로토콜에 따라 웹 페이지의 정보를 가져와 사용할 뿐, 웹 페이지 데이터를 변경하지 않습니다. 때문에 캐시 초기화 도구를 사용한 삭제 외 개별 조치가 어렵습니다.
카카오는 og 태그를 가져다 쓸 뿐이라, 캐시 삭제 외에는 사이트 쪽 og 태그를 고치는 것이 답입니다.

발견 02

미리보기가 안 나오거나 이미지가 빠지는 원인은 5가지이고, og 태그 하나를 빼면 모두 이미지 파일 쪽입니다

원인확인할 곳원문
og 태그가 <head> 에 없거나 값이 예전 것페이지 소스 보기에서 og:title·og:image 찾기사용자가 웹페이지 링크를 스크랩하면 해당 웹페이지의 HTML 코드의 <head> 영역에서 오픈 그래프 프로토콜의 메타 태그 정보를 추출합니다.
이미지 파일이 깨졌거나 URL이 틀림og:image URL을 브라우저에서 직접 열기이미지가 유효하지 않은 경우
이미지가 사내망 안에만 있음휴대전화 데이터망에서 og:image URL 열기이미지 URL이 외부에서 접근 불가능한 경우
방화벽이 카카오 스크랩 서버를 차단서버·보안 담당자에게 차단 목록 확인서비스 서버의 방화벽에서 카카오 스크랩 서버의 접근을 차단한 경우 서비스 서버의 방화벽에서 카카오 스크랩 서버의 접근을 차단한 경우, 이미지의 전송이 매우 느리거나 표시되지 않을 수 있습니다.
이미지가 5MB를 넘음og:image 파일 크기 확인이미지 용량 제한(5MB)을 초과한 경우
첫 줄은 「메시지 템플릿 > 이해하기」, 나머지는 「메시지 템플릿 > FAQ」의 이미지 미표시 원인 목록입니다. 카카오 문서는 카카오톡 공유·메시지 API 기준으로 적었습니다.

카카오는 HTML 코드의 <head> 에서 og 태그를 읽는다고 적었습니다. 그래서 서버가 보내는 HTML, 곧 페이지 소스 보기 화면에 og 태그가 있는지를 먼저 봅니다.

og 태그 항목과 넣을 값은 「og 태그 뜻과 페이지별로 넣을 항목 정리」 편에 자세히 적었습니다.

발견 03

확인은 og 태그에서 시작해 캐시 삭제로 끝나는 6단계입니다

순서단계할 일원문
1og 태그 확인페이지 소스 보기로 og:title·og:description·og:image 가 <head> 에 있고 새 값인지 봅니다.웹 페이지를 스크랩한 경우, og 태그 값이 올바르게 입력되어 있는지 확인하기
2이미지 열기og:image URL을 휴대전화 데이터망에서 직접 열어 이미지가 뜨는지, 5MB 이하인지 봅니다.이미지 URL이 외부에서 접근 불가능한 경우 / 이미지 용량 제한(5MB)을 초과한 경우
3방화벽 확인서버 방화벽이 카카오 스크랩 서버를 차단하지 않는지 확인하고, 차단 중이면 허용합니다.서비스 서버의 방화벽에서 카카오 스크랩 서버의 접근을 차단한 경우, 이미지의 전송이 매우 느리거나 표시되지 않을 수 있습니다.
4캐시 삭제카카오디벨로퍼스 [도구] > [초기화 도구] > [OG(Open Graph) 캐시] 에 페이지 URL을 넣어 캐시를 지웁니다.미리보기 이미지나 문구 변경 사항이 반영되지 않는 경우는 캐시(cache) 데이터 때문에 생기는 현상으로, [도구] > [초기화 도구] > [OG(Open Graph) 캐시] 메뉴에서 카카오 플랫폼에 저장된 웹 페이지나 파일의 URL을 입력하여 캐시 데이터를 삭제할 수 있습니다.
5새 대화방에서 다시 보내기채팅방을 나갔다가 새로 만들어 링크를 다시 보냅니다.카카오톡 채팅방을 나갔다가 다시 만들어 테스트 메시지 발송
6문의그래도 예전 카드가 보이면 카카오 데브톡으로 문의합니다.만약 캐시 초기화 도구가 동작하지 않거나, 다른 이상 현상이 발견될 경우에는 데브톡으로 문의합니다.
캐시를 먼저 지워도 og 태그가 틀려 있으면 틀린 값이 다시 저장됩니다. 그래서 캐시 삭제는 4번 단계에 둡니다.

카카오 문서가 말하는 캐시는 카카오 플랫폼에 저장된 값입니다. 페이스북 같은 다른 플랫폼의 미리보기는 그 플랫폼의 도구에서 따로 확인합니다.

Open Graph 프로토콜 문서는 페이스북의 공식 확인 도구를 이렇게 소개했습니다(원문: Facebook Object Debugger - Facebook's official parser and debugger.)

발견 04

같은 캐시 문제라도 B2B·B2C·B2G 는 막히는 단계가 다릅니다

예시 ① 사내 서버에 사이트를 둔 장비 제조사(B2B)

회사 안에서는 미리보기가 잘 뜨는데, 고객사 담당자에게 보낸 링크에는 이미지가 빠집니다. 이미지가 사내망 안 URL을 가리키고 있었습니다.

「이미지 열기」 단계에서 걸립니다. og:image 를 외부에서 열리는 URL로 바꾸고, 「방화벽 확인」 단계로 카카오 스크랩 서버 허용을 봅니다.

예시 ② 할인 이미지를 바꾼 쇼핑몰(B2C)

기획전이 끝나 대표 이미지를 바꿨는데, 단체 대화방에는 지난 할인 이미지가 계속 뜹니다. 「og 태그 확인」 단계에서 새 og:image 를 확인했습니다.

「캐시 삭제」 단계에서 기획전 URL의 OG 캐시를 지우고, 새 대화방에서 다시 보내 카드를 봅니다.

예시 ③ 게시판 프로그램을 바꾼 공공기관 누리집(B2G)

프로그램을 바꾼 뒤 공지 링크 미리보기가 모두 사라졌습니다. 새 프로그램은 og 태그를 스크립트로 넣고 있어 페이지 소스에는 없었습니다.

「og 태그 확인」 단계에서 걸립니다. 카카오 문서는 HTML의 <head> 에서 읽는다고 적었으니, 서버가 보내는 HTML에 og 태그를 넣게 바꾸고 자주 공유되는 공지 URL부터 캐시를 지웁니다.

그럼 미리보기가 틀리면 어떤 순서로 확인하나요?

  1. 페이지 소스 보기로 og:title·og:description·og:image 가 <head> 에 있고 새 값인지 봅니다.
  2. og:image URL을 휴대전화 데이터망에서 직접 열어 이미지가 뜨는지, 5MB 이하인지 봅니다.
  3. 서버 방화벽이 카카오 스크랩 서버를 차단하지 않는지 확인하고, 차단 중이면 허용합니다.
  4. 카카오디벨로퍼스 [도구] > [초기화 도구] > [OG(Open Graph) 캐시] 에 페이지 URL을 넣어 캐시를 지웁니다.
  5. 채팅방을 나갔다가 새로 만들어 링크를 다시 보냅니다.
  6. 그래도 예전 카드가 보이면 카카오 데브톡으로 문의합니다.

조사 방법

  • 카카오디벨로퍼스 「메시지 템플릿 > FAQ」 · 최종 확인일 2026-10-25 · https://developers.kakao.com/docs/ko/message-template/faq
  • 카카오디벨로퍼스 「메시지 템플릿 > 이해하기」 · 최종 확인일 2026-10-25 · https://developers.kakao.com/docs/ko/message-template/common
  • 카카오디벨로퍼스 「카카오톡 공유 > 이해하기」 · 최종 확인일 2026-10-25 · https://developers.kakao.com/docs/ko/kakaotalk-share/common
  • Open Graph protocol (ogp.me) 「The Open Graph protocol」 · 최종 확인일 2026-10-25 · https://ogp.me/
  • 원인 5가지와 확인 6단계는 위 카카오 문서가 적은 원인·조치를 묶고 순서를 매긴 것입니다. 묶는 방식과 순서는 편집 판단입니다.
  • 카카오 초기화 도구와 공유 디버거 페이지는 robots.txt 차단 경로라 열지 않았고, 문서에 적힌 메뉴 이름만 옮겼습니다.
  • 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
  • 카카오 문서는 한국어 원문 그대로이고, Open Graph 프로토콜 원문은 영어판입니다. Meta(Facebook) 개발자 문서는 robots.txt 머리 주석이 자동 수집을 금지해 열지 않았습니다.