구조·마크업 · 공식 문서
구글 렌더링 HTML 확인 방법과 점검 순서
서치 콘솔 URL 검사에서 실제 URL 테스트를 돌린 뒤 테스트된 페이지 보기를 열면 렌더링된 화면의 스크린샷, HTML, 리소스, 자바스크립트 콘솔 출력을 볼 수 있습니다. 소유하지 않은 URL이나 데스크톱 화면은 리치 결과 테스트로 확인합니다.
브라우저에 보이는 화면과 구글이 색인하는 화면은 다를 수 있습니다. 자바스크립트가 그린 내용은 구글이 렌더링을 마친 뒤에야 보이기 때문입니다.
그래서 「검색에 우리 내용이 안 잡힌다」는 의심이 들면 렌더링된 HTML부터 꺼내 봅니다. 구글은 이 HTML로 링크를 찾고 색인합니다.
발견 01
렌더링된 HTML은 URL 검사와 리치 결과 테스트의 2가지 도구로 봅니다
To test how Google crawls and renders a URL, use the Rich Results Test or the URL Inspection Tool in Search Console. You can see loaded resources, JavaScript console output and exceptions, rendered DOM, and more information.
구글이 URL을 크롤링하고 렌더링하는 방식은 리치 결과 테스트나 서치 콘솔 URL 검사 도구로 시험한다. 불러온 리소스, 자바스크립트 콘솔 출력과 예외, 렌더링된 DOM 등을 볼 수 있다.
| 항목 | URL 검사(실제 URL 테스트) | 리치 결과 테스트 | 공식 문서 원문 |
|---|---|---|---|
| 테스트할 수 있는 URL | 소유 확인한 속성 안의 URL | 소유하지 않은 URL과 코드 스니펫 | The URL must be in the current property. To test a URL in a property that you don't own, use the appropriate non-owner test, such as the Rich Results test or AMP test. You can test an arbitrary code snippet using this tool.URL 검사는 지금 연 속성 안의 URL만 받습니다. 소유하지 않은 속성의 URL은 리치 결과 테스트처럼 소유자가 아니어도 되는 테스트를 씁니다. 리치 결과 테스트는 코드 조각도 테스트합니다. |
| 렌더링 결과 | 테스트된 페이지 보기의 스크린샷·HTML·추가 정보 | 렌더링된 HTML과 코드 탐색기 | Click View tested page to see additional response data such as a screenshot of the rendered page, the raw HTML returned, the HTTP headers, JavaScript console output, and any page resources loaded. The explorer uses the rendered source code.테스트된 페이지 보기를 누르면 렌더링된 페이지 스크린샷, 반환된 HTML, HTTP 헤더, 자바스크립트 콘솔 출력, 불러온 리소스를 볼 수 있습니다. 리치 결과 테스트의 코드 탐색기는 렌더링된 소스 코드를 씁니다. |
| 사용자 에이전트 | 테스트에 쓴 크롤러 유형을 결과에 표시 | 스마트폰·데스크톱 중 선택 | The user agent type used for the live test. You can choose which user agent to use when testing your page: that is, test your page with a smartphone or a desktop computer.URL 검사 실시간 테스트는 테스트에 쓴 사용자 에이전트 유형을 보여 줍니다. 리치 결과 테스트는 스마트폰과 데스크톱 중 어느 쪽으로 테스트할지 고를 수 있습니다. |
내 사이트의 페이지는 URL 검사가 먼저입니다. 색인된 버전과 지금 버전을 같은 화면에서 오갈 수 있습니다.
URL 검사 화면의 상태 문구를 읽는 법은 「구글 URL 검사 결과 보는 법」 편에 자세히 적었습니다. 이 편은 렌더링 결과를 비교하는 일만 다룹니다.
발견 02
점검은 첫 HTML을 떠 두고 렌더링 결과와 비교하는 6단계입니다
| 순서 | 할 일 | 볼 것 | 공식 문서 원문 |
|---|---|---|---|
| 1 | 서버가 보낸 첫 HTML 저장 | 브라우저의 페이지 소스 보기로 첫 HTML을 저장해 비교 기준으로 둡니다. | Crawling a URL and parsing the HTML response works well for classical websites or server-side rendered pages where the HTML in the HTTP response contains all content.HTTP 응답 HTML에 콘텐츠가 모두 든 전통적인 사이트나 서버 렌더링 페이지는 URL을 크롤링해 HTML을 읽는 것으로 잘 처리된다. |
| 2 | URL 검사에서 실제 URL 테스트 | 처음 나오는 결과는 색인된 버전이므로, 지금 페이지를 보려면 실제 URL 테스트를 누릅니다. | This is not a live test. The results shown are from most recently indexed version of a page, not the live version on the web.이 결과는 실시간 테스트가 아닙니다. 웹에 있는 지금 버전이 아니라 가장 최근에 색인된 버전의 결과입니다. |
| 3 | 테스트된 페이지 보기의 스크린샷 | 본문·가격·버튼처럼 꼭 있어야 할 요소가 화면에 다 그려졌는지 봅니다. | This is useful for confirming that all elements of the page are present and appear as you intend. Differences might be the result of resources that are blocked to the Google-InspectionTool.페이지의 모든 요소가 있고 의도한 대로 보이는지 확인할 때 쓸모가 있습니다. 차이가 있다면 Google-InspectionTool 에 차단된 리소스 때문일 수 있습니다. |
| 4 | 렌더링된 HTML에서 문장 찾기 | 본문 첫 문장, 제목, 캐노니컬, 주요 링크를 찾아 첫 HTML과 나란히 봅니다. | If the content isn't visible in the rendered HTML, Google won't be able to index it.렌더링된 HTML에 보이지 않는 콘텐츠는 구글이 색인할 수 없습니다. |
| 5 | 추가 정보의 리소스와 콘솔 | 불러오지 못한 리소스와 자바스크립트 콘솔 오류를 확인합니다. | Click View tested page to see additional response data such as a screenshot of the rendered page, the raw HTML returned, the HTTP headers, JavaScript console output, and any page resources loaded. Google Search won't render JavaScript from blocked files or on blocked pages.테스트된 페이지 보기에서 스크린샷, 반환된 HTML, HTTP 헤더, 자바스크립트 콘솔 출력, 불러온 리소스를 봅니다. 구글 검색은 차단된 파일이나 차단된 페이지의 자바스크립트를 렌더링하지 않습니다. |
| 6 | 리치 결과 테스트로 교차 확인 | 소유하지 않은 URL, 데스크톱 사용자 에이전트, 결과 공유가 필요할 때 씁니다. | You can choose which user agent to use when testing your page: that is, test your page with a smartphone or a desktop computer. You can use the Share button to share the test results browser link with anyone; permissions are not required to view the results. Test result links are valid for approximately 90 days.리치 결과 테스트는 스마트폰과 데스크톱 중 사용자 에이전트를 고를 수 있습니다. 공유 버튼으로 결과 링크를 누구에게나 보낼 수 있고 권한 없이 열리며, 링크는 약 90일 동안 유효합니다. |
To make sure that Google can still see your content after it's rendered, use the Rich Results Test or the URL Inspection Tool and look at the rendered HTML. If the content isn't visible in the rendered HTML, Google won't be able to index it.
렌더링 뒤에도 구글이 콘텐츠를 볼 수 있는지 확인하려면 리치 결과 테스트나 URL 검사 도구로 렌더링된 HTML을 봅니다. 렌더링된 HTML에 보이지 않는 콘텐츠는 구글이 색인할 수 없습니다.
첫 HTML에 있던 문장이 렌더링된 HTML에도 있으면 정상입니다. 첫 HTML에 없고 렌더링된 HTML에만 있으면 구글은 읽지만 렌더링을 기다려야 합니다.
둘 다에 없으면 구글도 그 내용을 색인하지 못합니다. 이때는 추가 정보에서 불러오지 못한 리소스와 콘솔 오류를 먼저 봅니다.
발견 03
테스트가 안 되거나 결과가 흔들리는 상황은 5가지이고, 도구가 이유를 알려 줍니다
| 상황 | 도구에서 보이는 것 | 공식 문서 원문 |
|---|---|---|
| 로그인·방화벽 뒤 페이지 | 리소스가 빠지거나 테스트할 수 없습니다 | All page resources must be accessible by an anonymous user accessing the code from the internet. Note: it's fine if the page hasn't been indexed yet, or has failed indexing, but the page must be accessible from the internet without any login requirements.모든 페이지 리소스는 인터넷에서 익명 사용자가 접근할 수 있어야 합니다. 아직 색인되지 않았거나 색인에 실패한 페이지도 테스트할 수 있지만, 로그인 없이 인터넷에서 열려야 합니다. |
| robots.txt 차단·noindex | 리치 결과 테스트가 페이지를 테스트하지 못합니다 | If Google is prevented from crawling the page as part of its regular crawl cycle (for example, is prevented from crawling by a robots.txt rule or noindex directive), the page cannot be tested with this tool.robots.txt 규칙이나 noindex 지시어 등으로 구글의 일반 크롤링이 막힌 페이지는 이 도구로 검사할 수 없다. |
| 실시간 테스트 실패 | 스크린샷과 추가 정보가 나오지 않습니다 | A screenshot is available only in a live test with a successful test result. Additional response data is available in the live test only when the test status is URL is available to Google or URL is available to Google, but has issues.스크린샷은 성공한 실시간 테스트에서만 볼 수 있습니다. 추가 응답 데이터도 실시간 테스트 상태가 「URL을 Google에 등록할 수 있음」 또는 「등록할 수 있지만 문제가 있음」일 때만 나옵니다. |
| 가끔 불러오지 못하는 리소스 | 같은 페이지인데 실행마다 결과가 조금씩 다릅니다 | If a test cannot load all the resources used by a page, you will see a warning. If you have unloadable resources or other page loading issues, you might see slightly different results every time you run the test.페이지가 쓰는 리소스를 모두 불러오지 못하면 경고가 나옵니다. 불러오지 못하는 리소스나 로딩 문제가 있으면 실행할 때마다 결과가 조금씩 다를 수 있습니다. |
| Google-InspectionTool 만 따로 차단 | 테스트 도구 결과만 달라집니다 | Crawling preferences addressed to the Google-InspectionTool user agent affect Search testing tools such as the Rich Result Test and URL inspection in Search Console. It has no effect on Google Search or other products.Google-InspectionTool 사용자 에이전트에 대한 크롤링 설정은 리치 결과 테스트와 서치 콘솔 URL 검사 같은 검색 테스트 도구에만 영향을 줍니다. 구글 검색이나 다른 제품에는 영향이 없습니다. |
결과가 실행마다 다르면 페이지보다 리소스를 의심합니다. 느린 외부 스크립트나 응답이 늦은 API가 있으면 테스트마다 그려지는 내용이 달라집니다.
Google-InspectionTool 만 따로 허용하거나 차단해도 실제 검색 크롤링은 그대로입니다. 테스트 결과와 검색 결과가 어긋날 때 이 설정을 확인합니다.
발견 04
같은 점검도 B2B·B2C·B2G 사이트마다 먼저 볼 요소가 다릅니다
예시 ① 요금표를 API로 불러오는 B2B 소프트웨어 사이트
요금 페이지 스크린샷에 요금표 자리가 비어 있었습니다. 추가 정보를 보니 요금 데이터를 주는 API 경로가 robots.txt 로 차단되어 있었습니다.
구글은 차단된 파일의 자바스크립트를 렌더링하지 않습니다. 해당 경로를 허용하고 실제 URL 테스트를 다시 돌려 요금표 문장을 렌더링된 HTML에서 찾았습니다.
예시 ② 상세 설명을 늦게 불러오는 쇼핑몰(B2C)
상품 상세 페이지의 렌더링된 HTML에 상세 설명과 사양표가 없었습니다. 화면을 내려야 불러오는 방식이었습니다.
스크롤 없이도 HTML에 들어가게 바꾸고 다시 확인합니다. 지연 로딩 설정은 「레이지 로딩 SEO」 편에 자세히 적었습니다.
예시 ③ 공개를 앞둔 공공기관 누리집(B2G)
개발 서버는 로그인 뒤에 있어 두 도구 모두 테스트할 수 없었습니다. 공개 당일 운영 URL로 리치 결과 테스트를 돌려 결과 링크를 기관 담당자에게 넘겼습니다.
결과 링크는 권한 없이 열리고 약 90일 동안 유효합니다. 같은 날 기관 계정의 서치 콘솔에서 URL 검사로 한 번 더 확인합니다.
그럼 오늘 무엇부터 확인하나요?
- 검색 유입이 가장 많은 페이지와 자바스크립트로 내용을 그리는 페이지를 하나씩 고릅니다.
- 두 페이지의 첫 HTML을 페이지 소스 보기로 저장합니다.
- URL 검사에서 실제 URL 테스트를 돌리고, 테스트된 페이지 보기의 스크린샷과 HTML을 봅니다.
- 본문 첫 문장·제목·캐노니컬·주요 링크가 렌더링된 HTML에 있는지 찾습니다.
- 빠진 것이 있으면 추가 정보의 리소스와 콘솔 오류를 보고, 고친 뒤 같은 테스트를 다시 돌립니다.
- SPA 사이트 전체 점검이 필요하면 「리액트 SPA SEO」 편의 순서로 이어 갑니다.
조사 방법
- Google Search Central 「Fix Search-related JavaScript problems」 (문서 수정일 2025-12-18) · 최종 확인일 2026-10-25 · https://developers.google.com/search/docs/crawling-indexing/javascript/fix-search-javascript
- Google Search Central 「Understand the JavaScript SEO basics」 (문서 수정일 2026-03-04) · 최종 확인일 2026-10-25 · https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics
- Search Console Help 「URL Inspection tool」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/9012289
- Search Console Help 「Rich Results Test」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/7445569
- Google Crawling Infrastructure 「Google's common crawlers」 (문서 수정일 2026-10-15) · 최종 확인일 2026-10-25 · https://developers.google.com/crawling/docs/crawlers-fetchers/google-common-crawlers
- 점검 순서 6단계와 상황 5가지는 위 문서가 렌더링 확인에 대해 적은 문장을 순서로 묶은 것입니다. 묶는 방식은 편집 판단입니다.
- 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
- 원문은 영어판(hl=en)이고, 도구·보고서 이름은 같은 문서 한국어판(hl=ko) 표기를 따랐습니다.