웹사이트를 공유했는데 링크 미리보기에 이미지가 안 나오는 이유는?

크롤러가 실제로 읽는 것

링크를 붙여 넣을 때 플랫폼은 방문자처럼 페이지를 보지 않습니다. 크롤러가 URL을 요청하고, 서버가 돌려준 HTML을 읽고, head에 있는 몇 개의 meta 태그로 카드를 만듭니다. 대부분이 읽는 형식은 Open Graph 프로토콜이며, og:image는 og:title, og:type, og:url과 함께 네 가지 필수 속성 중 하나입니다. 스크립트가 실행된 뒤에야 존재하는 것 — 클라이언트 사이드 프레임워크가 주입하는 태그나 브라우저에서 플러그인이 설정하는 이미지 — 은 이런 크롤러 대부분에게 보이지 않습니다. 코드를 실행하지 않기 때문입니다.

이미지 자체도 각 플랫폼의 기준을 통과해야 하고, 그 기준은 플랫폼마다 다릅니다. Facebook 문서는 가장 좋은 표시를 위해 최소 1200 × 630 픽셀, 큰 이미지 게시물의 최소치로 600 × 315, 어떤 경우에도 200 × 200 이상, 비율은 최대한 1.91:1에 가깝게, 파일은 8 MB 미만으로 할 것을 요구합니다. LinkedIn 고객센터는 최소치를 1200 × 627, 비율은 같은 1.91:1, 상한은 5 MB로 정하고 있으며, 필요한 태그로 og:title, og:image, og:description, og:url을 꼽습니다. 5 MB 미만의 1200 × 630 이미지 하나면 둘 다 충족합니다.

흔한 원인 — 대략 확인할 순서대로

• 공유한 페이지에 og:image가 없다. 가장 흔한 경우는 홈페이지에는 있고 하위 페이지에는 없는 것입니다 — 그리고 사람들이 실제로 공유하는 건 하위 페이지입니다.
• 이미지 URL이 상대 경로다. /images/card.png 같은 경로는 HTML을 맥락 없이 읽는 크롤러에게 아무 의미가 없습니다. Open Graph 명세의 예시는 모두 https://로 시작하는 전체 주소입니다. 그렇게 쓰세요.
• 이미지가 너무 작거나, 너무 크거나, 모양이 맞지 않는다. 플랫폼의 최소치보다 작으면 썸네일만 나오거나 아무것도 나오지 않고, 파일 크기 상한을 넘으면 버려지며, 정사각형이나 세로형 이미지는 1.91:1 틀에 맞춰 잘립니다.
• 크롤러가 이미지에 닿지 못한다. robots.txt 규칙, 로그인 벽, 스테이징 비밀번호, 낯선 사용자 에이전트를 막는 방화벽이 있으면 크롤러는 태그를 하나도 보기 전에 멈춥니다.
• 플랫폼이 오래된 사본을 보여주고 있다. 지금은 태그가 올바르더라도 링크가 처음 공유됐을 때 빠져 있었다면, 보고 있는 카드는 캐시된 것입니다 — 아래를 참고하세요.

우리 사이트에서 잘못됐던 것

2026년 7월 14일까지 agentceres.com — AI Growth Officer인 AgentCeres의 사이트 — 에는 og:image를 가진 페이지가 하나도 없었고, Slack, X, LinkedIn에 공유한 링크는 모두 텍스트만 있는 카드로 펼쳐졌습니다. 고치는 데는 서로 독립된 두 가지 수정이 필요했고, 어느 하나만 고쳤다면 사이트는 절반쯤 고장 난 채로 남았을 것입니다.

첫 번째는 위치였습니다. 카드 이미지를 생성하는 파일이 실제로 어떤 페이지도 상속하지 않는 앱 계층에 놓여 있어서, 아무 데도 적용되지 않았습니다. 두 번째는 Next.js로 개발한다면 알아둘 만한 함정입니다. Next.js 문서에 따르면 서로 다른 계층의 메타데이터는 얕게 병합되고, 상위에서 정의한 openGraph 같은 중첩 필드는 마지막으로 그것을 정의한 계층이 덮어씁니다. 페이지 제목과 설명을 설정하는 공용 헬퍼가 이미지 없이 openGraph를 설정하고 있었기 때문에, 그 헬퍼를 쓰는 모든 페이지 — 역할 페이지, 블로그 글, 비교 페이지처럼 가장 많이 공유되는 페이지 — 에서 페이지 자체의 openGraph가 카드를 담은 openGraph를 이미지째 대체했습니다. 위치만 고쳤다면 정작 사람들이 공유하는 페이지들은 여전히 이미지가 없었을 겁니다. 우리가 얻은 교훈은 이렇습니다. 홈페이지만 보지 말고 지금 공유하려는 바로 그 페이지의 HTML을 확인하세요 — 이런 태그가 빠지는 곳은 하위 페이지입니다.

태그를 고치는 건 절반일 뿐

플랫폼은 링크가 처음 공유됐을 때 만든 미리보기를 캐시하므로, 페이지를 고쳐도 예전 카드가 계속 보입니다. Facebook은 이미지가 URL 단위로 캐시되며 URL이 바뀌지 않는 한 업데이트되지 않는다고 밝히고 있습니다. Facebook의 Sharing Debugger는 페이지를 다시 가져와 크롤러에게 지금 무엇이 보이는지 보여줍니다. LinkedIn의 Post Inspector는 LinkedIn에서 같은 일을 하며, 미리보기에 오래된 이미지가 나올 때 LinkedIn 고객센터가 안내하는 해결책입니다. 태그나 이미지를 바꾼 뒤에는 반드시 두 도구에 페이지를 통과시키고, 그래도 오래된 이미지를 놓지 않는 플랫폼이 있다면 이미지 파일 이름을 바꿔 URL이 달라지게 하세요.

미리보기는 보이는 것보다 중요합니다. 공유의 상당 부분은 채팅 앱과 DM에서 일어나는데, 그곳에서는 카드가 첫인상의 전부이고, 방문이 어디서 왔는지 분석 도구에 알려줄 리퍼러도 남지 않습니다 — 이런 트래픽을 다크 소셜이라고 부릅니다. 단체 채팅방에서 회색 텍스트로 펼쳐진 링크는 그냥 스크롤해 지나치기 쉽고, 받지 못한 클릭은 어떤 리포트에도 나타나지 않습니다. 페이지를 방금 바꿨는데 라이브 사이트 자체가 여전히 예전 모습이라면, 그건 다른 캐시입니다. 웹사이트가 여전히 예전 버전으로 보이는 이유를 참고하세요.