---
title: "사용자 지정 HTML 템플릿을 가져오는 방법"
description: "사용자 정의 HTML 템플릿을 Klaviyo로 가져오는 방법을 알아보세요."
canonical_url: "https://help.klaviyo.com/hc/ko-kr/articles/115005254068"
markdown_url: "https://help.klaviyo.com/hc/ko-kr/articles/115005254068.md"
locale: "ko-kr"
category: "콘텐츠"
section: "고급 템플릿 디자인"
updated: "2025-08-05"
---

# 사용자 지정 HTML 템플릿을 가져오는 방법

## 학습 내용

사용자 정의 HTML 템플릿을 Klaviyo로 가져오는 방법을 알아보세요. 

**📝 Note:** 기술에 익숙한 마케터이거나 개발자의 도움을 받을 수 있는 경우에만 맞춤 HTML 사용을 권장해요. 제품에서 맞춤 HTML은 지원하지만, 지원팀에서는 이 문서에 포함된 일반적인 안내를 제공하는 것 외에는 맞춤 템플릿 구축을 도와드릴 수 없어요. 데이터 보안을 유지하기 위해 Klaviyo 지원 팀은 HTML 파일을 열 수 없어요.

## 사용자 지정 HTML 템플릿 가져오기

**📝 Note:** 파일을 업로드하는 경우 .html 확장자여야 해요. 확장자여야 합니다. 마케팅 템플릿에는 구독 취소 링크가 포함되어야 해요. `{% unsubscribe %}`을(를) 사용해 링크를 생성하거나, 자체 링크의 href 속성에 `{% unsubscribe_link %}`을(를) 넣어 주세요. [Klaviyo에서 구독 취소](https://help.klaviyo.com/hc/en-us/articles/115005078267.md)에 관해 자세히 알아보세요.

비마케팅 확인란을 선택하면 가져오기 중에 구독 취소 확인을 건너뜁니다. 템플릿을 마케팅과 관련이 없는 트리거 이메일에 사용할 경우에만 선택해 주세요.

**▸ 지원되지 않는 템플릿 태그 및 변수 제거**

다른 ESP(이메일 서비스 공급업체)에서 템플릿을 내보내면 Klaviyo에서 지원되지 않는 태그와 변수가 포함되어 있을 수 있어요. HTML 파일을 가져오기 전에 해당 태그를 제거하고(필요한 경우 [Klaviyo 맞춤 설정 태그](https://help.klaviyo.com/hc/en-us/articles/4408802648731.md)로 바꿔 주세요).

예를 들어, 아래의 메시지와 HTML을 확인해 보세요. 이 메시지는 다른 ESP(이메일 서비스 공급업체)에서 내보낸 것으로, 현재 연도, 회사 주소 등의 태그를 포함하고 있어요. 이러한 외부 태그는 Klaviyo와 호환되지 않아요.

![A template with unsupported tags](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/48007f6ef98cf489707fb7de08bbb9f153291e45-1600x938.jpg?auto=format)

![The HTML of a template that includes unsupported tags](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/96acac96e04b0ea4e2aa2af61af6699f631cfd59-1600x924.jpg?auto=format)

Klaviyo 템플릿 태그는 중괄호 안에 포함돼요. 변수는 중괄호 두 쌍으로 둘러싸여 있고(예: `{{ first_name }}`), 템플릿 태그는 중괄호 한 쌍과 퍼센트 기호로 둘러싸여 있습니다(예: `{% unsubscribe %}`). 템플릿의 템플릿 태그와 변수가 다른 문자로 표시되어 있으면 Klaviyo에서 지원하지 않습니다.

1. **콘텐츠 > 템플릿**으로 이동해 주세요.

2. **이메일: 저장됨** 탭을 선택합니다.

3. **생성 > 이메일 템플릿 가져오기**를 클릭합니다.

4. **템플릿 이름**에 이름을 입력해 주세요.

5. **HTML 파일 업로드**를 선택하고 .html 파일을 업로드해 주세요. 파일을 업로드하거나 **HTML 붙여넣기**를 선택한 다음 **템플릿 HTML**에 코드를 붙여넣어 주세요.

6. HTML에서 로컬 이미지를 참조하는 경우 .zip을 업로드해 주세요. **템플릿에 사용된 추가 파일 업로드** 아래에 해당 파일이 포함된 파일을 업로드해 주세요. 아래의 이미지 요구 사항을 확인해 주세요.

7. **템플릿 가져오기**를 클릭해 주세요.



가져오기가 성공적으로 완료되면 대화 상자가 닫히고 이메일: 저장됨 탭에 템플릿이 표시돼요.

**📝 Note:** Klaviyo의 드래그 앤 드롭 편집기에서 만든 템플릿을 내보낸 다음 다시 Klaviyo로 가져오는 것은 권장되지 않으며, 템플릿 기능에 문제가 발생할 수 있어요.

### 이미지 추가(선택 사항)

로컬 이미지를 .zip 파일로 패키징하세요. 파일을 **템플릿에 사용된 추가 파일 업로드**에서 업로드하세요. ZIP의 각 이미지 파일명과 폴더 경로는 HTML에서 참조한 것과 일치해야 해요. 각 이미지는 10MB 이하여야 합니다.

템플릿을 가져오면 Klaviyo가 ZIP에 참조된 이미지를 콘텐츠 전송 네트워크(CDN)에 업로드하고 템플릿에서 해당 이미지 참조를 업데이트해요.

이미지가 이미 온라인에 호스팅되어 있는 경우 전체 `http://` 또는 `https://` URL로 참조해 주세요. 해당 이미지를 ZIP 파일에 포함할 필요는 없어요.

## 사용자 지정 HTML 템플릿에 숨겨진 미리보기 텍스트 추가

사용자 지정 HTML 템플릿의 미리보기 텍스트를 설정하려면(받은편지함에서 메시지 콘텐츠로부터 미리보기 텍스트를 자동으로 가져오게 하지 않으려면), 아래 코드 블록을 템플릿에 추가해 주세요. 이 코드는 템플릿의 여는 `<body>` 태그 바로 뒤에 추가해야 해요. `Insert preview text here.`을(를) 수신자가 보게 될 미리보기 텍스트로 바꿔 주세요.

```text
<div style="display:none; font-size:1px; line-height:1px; max-height:0px; max-width:0px; opacity:0; overflow:hidden;">
Insert preview text here.
</div>
```

## 이모지 및 사용자 지정 HTML 템플릿

**📝 Note:** 2024년 2월 기준, 모든 이모지가 모든 Klaviyo 이메일 편집기(예: 드래그 앤 드롭 편집기, 하이브리드 편집기, 텍스트 전용 편집기, 커스텀 HTML 편집기)에서 지원돼요.

## 추가 자료

- [Klaviyo에서 사용자 지정 CSS, JavaScript 및 HTML 문제 해결](https://help.klaviyo.com/hc/ko-kr/articles/115005254488.md)

- [하이브리드 이메일 템플릿을 만드는 방법](https://help.klaviyo.com/hc/ko-kr/articles/115005254188.md)
