유튜브 임베드 코드 생성기

영상, 쇼츠, 재생목록 링크를 붙여 넣고 옵션을 고른 다음 깔끔한 임베드 코드를 복사하세요. 시작·종료 시간, 개인정보 보호 강화 모드, 반응형 크기를 지원하며 모든 처리는 브라우저 안에서 이루어집니다.

플레이어 옵션
크기

이 YouTube 임베드 코드 생성기는 YouTube 영상, 쇼츠, 재생목록을 웹사이트에 넣는 HTML을 만들어 줍니다. YouTube 자체의 공유 → 퍼가기 상자에는 없는 옵션까지 지원합니다. 시작·종료 시간, 자동 재생(브라우저가 허용하는 음소거 자동 재생 포함), 반복, 자막, 개인정보 보호 강화 모드, 모든 화면에 맞는 반응형 크기를 설정한 뒤 코드를 복사해 페이지에 붙여 넣으세요. 작업하는 동안 실시간 미리보기가 플레이어를 보여 줍니다. 모든 처리는 브라우저 안에서 이루어지고 Marqly로는 아무것도 전송되지 않으며, 모든 옵션은 YouTube 공식 플레이어 레퍼런스에 문서화된 매개변수에 대응합니다.

웹사이트에 YouTube 영상을 임베드하는 방법

  1. YouTube에서 영상 링크를 복사하세요. 시청 페이지, 쇼츠, 라이브 스트림, youtu.be 링크, 또는 list=가 들어 있는 재생목록 링크면 됩니다.
  2. 위에 붙여 넣으세요. 링크에 ?t=90 같은 타임스탬프가 있으면 시작 시간이 채워집니다.
  3. 옵션을 고르세요. 코드와 미리보기가 즉시 갱신됩니다.
  4. 코드 복사를 누르고 페이지의 HTML에 붙여 넣으세요. WordPress에서는 사용자 정의 HTML 블록을, 대부분의 사이트 빌더에서는 임베드 또는 HTML 요소를 쓰면 됩니다.

모든 옵션과 그 뒤의 매개변수

옵션매개변수기능
시작 시간start영상의 이 초 지점부터 재생을 시작합니다. 플레이어는 가장 가까운 키프레임으로 이동하므로 최대 2초 정도 앞에서 시작할 수 있습니다.
종료 시간end이 시간에 재생을 멈춥니다. 시작 시간이 아니라 영상의 처음부터 센 시간입니다.
자동 재생autoplay=1플레이어가 로드될 때 영상을 시작합니다. YouTube는 이 경우 재생 데이터 수집이 페이지 로드 시점에 일어난다고 밝힙니다.
반복loop=1재생목록을 반복합니다. 영상 하나일 때는 playlist도 같은 영상 ID로 설정해야 하며, 생성기가 추가해 줍니다.
플레이어 컨트롤 표시끄면 controls=0컨트롤 막대를 숨깁니다.
전체 화면 버튼끄면 fs=0전체 화면 버튼을 숨깁니다.
자막 기본 켜기cc_load_policy=1자막이 있는 영상이면 기본으로 자막을 보여 줍니다.
같은 채널 추천만rel=0끝에 나오는 관련 영상을 같은 채널의 영상으로 제한합니다.
iPhone에서 인라인 재생playsinline=1iOS에서 전체 화면으로 넘어가지 않고 페이지 안에서 재생합니다.
키보드 컨트롤 끄기disablekb=1일시정지의 k, 10초 건너뛰기의 j/l 같은 단축키를 끕니다.
흰색 진행 막대color=white진행 막대에서 이미 본 부분을 빨간색 대신 흰색으로 표시합니다.
개인정보 보호 강화 모드youtube-nocookie.comYouTube의 개인정보 보호 강화 임베드 도메인을 사용합니다(아래 참고).

시작 시간과 종료 시간

YouTube 플레이어는 시작·종료 시간을 정수 초로 받으므로, 생성기는 입력한 90, 1:30,1:02:03, 1h2m3s를 모두 초로 변환합니다. 둘 다 영상의 맨 처음부터 잰 시간입니다. 1:30부터 2:00까지의 구간을 재생하려면 종료 시간에 0:30이 아니라 시작 1:30, 종료 2:00을 입력하세요. 임베드가 아니라 링크로 특정 장면을 공유하려면 YouTube 타임스탬프 링크 생성기를 쓰세요.

임베드한 영상이 자동 재생되지 않는 이유와 해결법

영상이 저절로 시작해도 되는지는 브라우저가 결정합니다. YouTube IFrame API 문서는 사용자 상호작용 없는 소리 있는 재생을 브라우저가 차단하는 경우로 꼽으므로, autoplay=1만으로는 아무 일도 일어나지 않는 경우가 많습니다. 확실한 방법은 음소거로 시작하는 것입니다. 음소거 자동 재생(JavaScript API)을 고르면 생성기가 임베드와 함께 짧은 스크립트를 만들어 줍니다. 이 스크립트는 YouTube 공식 IFrame Player API를 불러오고, 플레이어가 준비되면 음소거한 다음 재생을 시작합니다. 방문자는 한 번의 클릭으로 음소거를 해제할 수 있습니다.

API 클라이언트에 대한 YouTube의 규칙에는 지켜야 할 두 가지 조건이 더 있습니다. 플레이어의 절반 넘는 면적이 화면에 보이기 전에는 자동으로 재생을 시작하면 안 되고, 한 페이지에서 YouTube 플레이어 둘 이상이 동시에 자동 재생되면 안 됩니다. 페이지 맨 위의 히어로 영상은 괜찮지만 페이지 한참 아래에서 자동 재생되는 영상은 안 됩니다.

개인정보 보호 강화 모드 (youtube-nocookie.com)

개인정보 보호 강화 모드는 임베드 URL의 www.youtube.com을 www.youtube-nocookie.com으로 바꿉니다. YouTube 고객센터에 따르면 임베드된 영상의 시청이 시청자의 YouTube 이용 환경에 영향을 주는 것을 막고, 맞춤이 아닌 광고를 보여 주며, 그 시청 기록이 내 사이트 밖에서 시청자에게 보이는 광고를 맞춤화하는 데 쓰이는 것을 막아 줍니다. 비용이 들지 않으므로 여기서는 기본으로 켜져 있습니다. 하지만 임베드가 쿠키를 설정하지 않거나 추적을 하지 않는다는 약속은 아니며, 그것만으로 임베드가 어떤 개인정보 보호법을 준수하게 되는 것도 아닙니다. 어느 쪽이든 개인정보 처리방침과 동의 설정에 YouTube를 명시하세요.

쇼츠를 포함한 반응형 YouTube 임베드

기본 iframe은 560 × 315 고정 크기라 휴대전화에서 화면을 넘칩니다. 반응형을 켜면 코드가 플레이어를 컨테이너 너비의 100%로 설정하고 CSS aspect-ratio 속성으로 비율을 유지합니다. 현재 모든 브라우저에서 padding-bottom 래퍼가 필요 없습니다. 쇼츠는 9:16을 골라야 세로 영상에 검은 여백이 생기지 않으며, 이때 너비 입력란은 커질 수 있는 최대 너비를 정합니다. YouTube는 임베드 플레이어가 최소 200 × 200 픽셀이어야 하고 16:9 플레이어는 최소 480 × 270 이상을 권장하므로, 생성기는 너비를 200픽셀 아래로 내리지 않습니다.

더 빠른 페이지를 위한 클릭 시 로드 임베드

YouTube iframe은 페이지가 로드되자마자 플레이어 전체를 불러옵니다. 대부분의 방문자가 재생하지 않는 영상이 있는 페이지에는 무거운 부담입니다. 클릭 시 로드 출력은 재생 버튼이 있는 영상 썸네일을 보여 주다가 누군가 클릭하거나(또는 Enter를 누르면) 그때 실제 플레이어로 바꾸고 재생을 시작합니다. 페이지 속도가 좋아지고, 방문자가 시청하기로 하기 전까지는 플레이어에 아무것도 요청하지 않습니다. 영상 하나에서 쓸 수 있으며, 재생목록은 표준 iframe을 사용합니다.

더 이상 작동하지 않는 매개변수

  • modestbranding은 지원이 중단되어 효과가 없습니다. 이제 YouTube가 플레이어 크기와 기타 신호로 브랜딩을 결정합니다. 아직도 이 옵션을 제공하는 생성기는 오래된 것입니다.
  • showinfo는 2018년에 지원이 중단되어 문서에서 삭제되었습니다.
  • rel=0은 2018년 9월 25일부터 관련 영상을 끌 수 없고 같은 채널로만 제한합니다.
  • controls=2는 지원이 중단되었으니 0 또는 1을 쓰세요.

작동하지 않는 임베드 문제 해결

  • 오류 153 또는 빈 플레이어. YouTube는 임베드가 HTTP Referer 헤더로 자신이 있는 사이트를 알릴 것을 요구하며 strict-origin-when-cross-origin 리퍼러 정책을 권장합니다. 생성된 코드는 그 정책을 설정하지만, 사이트가 전체에 no-referrer를 보내면 플레이어가 실패할 수 있습니다.
  • «동영상을 재생할 수 없음.» 소유자가 그 영상의 임베드를 껐거나, 비공개이거나, 삭제되었거나, 방문자의 국가에서 차단된 경우일 수 있습니다. 이는 소유자만 바꿀 수 있습니다.
  • 플레이어가 잘리거나 너무 작아요. 높이가 고정되었거나 overflow: hidden이 걸린 부모 요소가 잘라 내고 있는 것입니다. 반응형을 켠 상태에서는 컨테이너에 너비만 주고 높이는 따라가게 두세요.
  • 반복이 되지 않아요. 영상 하나는 URL에 같은 영상 ID의 playlist=가 있어야 합니다. loop=1을 직접 추가하지 말고 생성된 코드를 복사하세요.

관련 YouTube 도구

유튜브 자막 추출 도구로 시작할 알맞은 지점을 찾고,챕터 생성기로 긴 임베드에 챕터를 더하고, 또는썸네일 다운로더로 맞춤 포스터 이미지를 내려받으세요. 강의 전체를 임베드하나요? 재생목록 길이 계산기가 방문자에게 총 재생 시간을 알려 줍니다.

자주 묻는 질문

특정 시간부터 시작하는 YouTube 영상은 어떻게 임베드하나요?

생성기에 시작 시간을 초, M:SS, H:MM:SS, 1m30s 중 편한 형식으로 입력하고 코드를 복사하세요. YouTube 플레이어가 기대하는 형식인 초 단위의 start 매개변수가 임베드 URL에 추가됩니다. 붙여 넣은 링크에 이미 t= 타임스탬프가 있으면 시작 시간이 자동으로 채워집니다.

임베드한 YouTube 영상이 자동 재생되지 않는 이유는 무엇인가요?

대부분의 브라우저는 방문자가 페이지와 상호작용하기 전에 소리가 나는 영상이 재생되는 것을 막습니다. YouTube 개발자 문서도 사용자 상호작용 없는 소리 있는 재생을 브라우저가 차단하는 경우의 하나로 꼽습니다. 플레이어를 음소거 상태로 시작하는 «음소거 자동 재생(JavaScript API)» 출력을 사용하세요.

YouTube 임베드를 반응형으로 만들려면 어떻게 하나요?

«반응형»을 켠 채로 두세요. 코드가 플레이어를 컨테이너의 전체 너비로 설정하고 CSS aspect-ratio 속성으로 16:9(쇼츠는 9:16) 비율을 유지하므로, 별도의 래퍼 꼼수 없이 모든 화면에서 크기가 맞춰집니다.

개인정보 보호 강화 모드는 무엇을 하나요?

임베드를 youtube-nocookie.com 도메인으로 바꿉니다. YouTube 고객센터에 따르면 이 경우 임베드된 영상의 시청이 시청자의 YouTube 이용 환경에 영향을 주지 않고, 내 사이트 밖에서 보이는 광고를 맞춤화하는 데도 쓰이지 않습니다. 임베드에서 추적이 사라지는 것은 아니므로 개인정보 처리방침에는 계속 명시하세요.

영상 하나를 반복 재생하려면 어떻게 하나요?

«반복»을 체크하세요. 영상 하나를 반복하려면 YouTube는 loop=1과 함께 같은 영상 ID로 설정된 playlist 매개변수를 요구하며, 생성기가 둘 다 추가해 줍니다.

끝에 나오는 관련 영상을 숨길 수 있나요?

완전히는 안 됩니다. 2018년 9월부터 rel=0은 관련 영상을 숨기지 못하고 같은 채널의 영상으로만 제한합니다. 생성기의 «같은 채널 추천만» 옵션이 이 값을 설정합니다.

재생목록도 임베드할 수 있나요?

네. 재생목록 링크(list=가 들어 있는 링크)를 붙여 넣으세요. 생성기가 재생목록 임베드를 만들고, 링크가 특정 영상도 가리키면 플레이어가 그 영상부터 시작합니다.

← 무료 도구

홈 · Marqly