> ## Documentation Index
> Fetch the complete documentation index at: https://cdbd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 개별 이미지 적용하기
# 개별 이미지 적용하기
> **한 줄 요약** — 고객마다 다른 사진이 표시되는 페이지를 만들고 싶을 때, 데이터 관리하기에서 이미지를 등록하고 에디터의 이미지 카드에 적용하는 방법을 안내해요.
## 이 기능이 필요한 순간
* 고객마다 다른 프로필 사진이나 상품 이미지를 보여주고 싶을 때
* 이름·포인트 같은 글자뿐 아니라 **이미지까지 한 사람씩 다르게** 넣고 싶을 때
* 한 페이지로 여러 사람에게 각자 다른 이미지가 담긴 링크를 보내고 싶을 때
## 개별 이미지가 무엇인가요?
개별 이미지는 **고객마다 서로 다른 이미지**를 페이지에 표시하는 기능이에요. 예를 들어 고객별 프로필 사진이나 맞춤 쿠폰 이미지를 한 사람씩 다르게 보여줄 수 있어요.
별도의 메뉴가 따로 있는 것은 아니에요. [데이터 관리하기](/data/management) 안에 있는 **"이미지 연결하기"** 기능을 사용해요. 데이터 표의 한 열을 이미지와 연결해 두면, 고객마다 발급된 개별 URL에서 그 고객의 이미지가 자동으로 표시돼요.
## 사용 방법
개별 이미지 적용은 두 단계로 나뉘어요. 먼저 **데이터 관리하기**에서 이미지를 등록하고(1\~5단계), 그다음 **에디터**에서 이미지 카드에 적용해요(6단계).
### 1단계. 데이터 관리하기 열기
내 페이지 목록에서 원하는 페이지 카드에 마우스를 올려요. 썸네일 오른쪽 위의 **⋯ 버튼**을 눌러요. 열린 메뉴에서 **\[데이터 관리하기]** 를 선택해 보세요.
데이터 관리 화면이 처음이라면 **\[데이터 생성하기]** 버튼을 눌러 데이터 표를 만들어요.
> ⚠️ **주의** — 이 기능은 **URL을 만든(게시한) 페이지**에서 사용할 수 있어요. 평생 무료(FREE) URL을 사용 중인 페이지는 데이터를 만들 수 없어요. 이때는 해당 페이지를 복제한 뒤 복제본에서 시작해 보세요.
### 2단계. 이미지를 담을 열 만들기
이미지는 데이터 표의 **한 열**에 담아요. 좌측 위의 **\[데이터 추가 ▾]** 버튼을 눌러요. 메뉴에서 **\[열 추가]** 를 선택하면 새 열이 만들어져요.
새로 만든 열의 이름 부분을 누르면 원하는 이름(예: `프로필 사진`)으로 바꿀 수 있어요.
### 3단계. 이미지 연결하기 열기
이미지를 담을 열의 헤더에는 아이콘 세 개가 있어요. 그중 **가운데 이미지 아이콘(🖼️)** 을 누르면 **"이미지 연결하기"** 창이 열려요.
연결 방법은 **파일 업로드** 와 **URL로 연결** 중에서 고를 수 있어요. 다음 단계에서 자세히 살펴볼게요.
### 4단계. 연결 방법 고르고 이미지 등록하기
두 가지 방법은 아래와 같이 동작해요. 가지고 있는 이미지 형태에 맞는 방법을 골라 보세요.
| 연결 방법 | 이렇게 동작해요 | 이런 점이 좋아요 |
| ----------- | ---------------------------------- | --------------------------- |
| **파일 업로드** | 데이터 값과 같은 파일명의 이미지를 올리면 자동으로 짝지어져요 | 내 컴퓨터에 있는 이미지를 바로 사용할 수 있어요 |
| **URL로 연결** | 데이터 칸에 이미지 주소(URL)를 입력해 연결해요 | 데이터를 수정하면 이미지도 자동으로 다시 연결돼요 |
#### 방법 1. 파일 업로드
"이미지 연결하기" 창에서 **\[파일 업로드]** 를 선택해요. 그다음 **\[계속하기]** 를 누르면 업로드 화면이 나와요.
*\[계속하기]를 누르면 나타나는 이미지 파일 업로드 화면이에요.*
1. 데이터 값과 **똑같은 파일명**으로 이미지 파일을 준비해요. 예를 들어 데이터 값이 `김재인`이면 파일명은 `김재인.png` 처럼 맞춰요.
2. 업로드 영역을 누르거나 파일을 끌어와 이미지를 올려요. 이미지 한 장은 최대 10MB까지 올릴 수 있어요.
3. **\[연결하기]** 를 누르면 파일명과 데이터 값이 같은 항목끼리 이미지가 연결돼요.
> ⚠️ **주의** — 데이터 값과 파일명이 정확히 같아야 연결돼요. 데이터를 나중에 수정하면 이미지를 다시 올려야 해요.
#### 방법 2. URL로 연결
데이터 칸에 이미지 주소(URL)를 직접 입력하는 방법이에요. 먼저 연결할 열의 각 칸에 이미지 URL을 입력해요.
*각 데이터 칸에 이미지 주소를 입력한 모습이에요.*
그다음 열 헤더의 이미지 아이콘(🖼️)을 눌러요. "이미지 연결하기" 창에서 **\[URL로 연결]** 을 선택해요. **\[계속하기]** 를 누르면 안내 화면이 나와요.
*\[계속하기]를 누르면 나타나는 URL 안내 화면이에요.*
이때 사용할 수 있는 URL과 사용할 수 없는 URL이 정해져 있어요.
| 사용할 수 있어요 | 사용할 수 없어요 |
| ---------------------------------------------------------- | -------------------------------------- |
| 웹에서 이미지 파일만 바로 열리는 주소 (예: `https://example.com/image.png`) | 이미지가 포함된 일반 웹페이지 주소 / 로그인이나 권한이 필요한 주소 |
안내를 확인했다면 **\[연결하기]** 를 눌러요.
*\[연결하기]를 누른 결과 화면이에요. "데이터에 이미지가 연결되었습니다" 안내가 표시되고, 해당 열의 이미지 아이콘이 보라색으로 바뀌어요.*
### 5단계. 변경사항 저장하기
이미지를 연결한 뒤에는 화면 오른쪽 위의 **\[변경사항 저장하기]** 버튼을 꼭 눌러야 저장돼요. 저장하지 않으면 연결한 내용이 사라져요.
### 6단계. 에디터에서 이미지 카드에 적용하기
이미지 등록을 마쳤다면, 이제 에디터에서 이미지 카드에 연결할 차례예요. 데이터 관리 화면 위쪽의 **\[에디터 바로가기]** 를 눌러 에디터로 이동해 보세요.
에디터에서는 아래 순서로 적용해요.
1. 에디터에서 **이미지 카드**를 선택해요.
2. 폰 미리보기에서 이미지 영역을 눌러 편집 상태로 들어가요.
3. 카드 오른쪽에 나타나는 **주황색 ⊕ 아이콘**을 눌러요.
4. 목록에서 이미지가 연결된 **데이터 열**을 선택해요.
이렇게 하면 고객마다 발급된 개별 URL에서 그 고객의 이미지가 자동으로 표시돼요. 텍스트나 링크에 데이터를 넣는 방법은 [에디터에 데이터 적용하기](/data/editor-data)에서 더 자세히 볼 수 있어요.
## 개별 이미지는 어디에 적용할 수 있나요?
개별 이미지는 **이미지 카드**에 적용할 수 있어요. 이미지 카드에 데이터 열을 연결하면, 고객마다 다른 사진이 그 자리에 표시돼요.
텍스트 카드나 버튼 같은 다른 카드에는 이미지 데이터를 넣을 수 없어요. 대신 이름·포인트 같은 **글자 데이터**나 **링크 주소 데이터**를 넣을 수 있어요. 글자와 링크를 개인화하는 방법은 [에디터에 데이터 적용하기](/data/editor-data)를 참고해 보세요.
## 자주 묻는 질문
**Q. 파일 업로드와 URL로 연결 중 무엇을 골라야 하나요?**
A. 이미지 파일이 내 컴퓨터에 있다면 파일 업로드가 편해요. 이미지가 이미 웹에 올라가 있고 주소가 있다면 URL로 연결이 편해요. URL 방식은 데이터를 수정해도 이미지가 자동으로 다시 연결되는 장점이 있어요.
**Q. 이미지를 올렸는데 연결되지 않아요.**
A. 파일 업로드 방식은 데이터 값과 파일명이 정확히 같아야 연결돼요. URL 방식은 이미지 파일만 바로 열리는 주소인지 확인해 보세요. 일반 웹페이지 주소나 로그인이 필요한 주소는 연결되지 않아요.
**Q. 데이터를 수정하면 이미지도 다시 등록해야 하나요?**
A. 파일 업로드 방식은 데이터를 수정하면 이미지를 다시 올려야 해요. URL로 연결한 경우에는 데이터(주소)를 수정하면 이미지가 자동으로 다시 연결돼요.
**Q. 이미지 파일 용량 제한이 있나요?**
A. 파일 업로드 방식에서는 이미지 한 장당 최대 10MB까지 올릴 수 있어요.
## 함께 보면 좋은 문서
* [데이터 관리하기](/data/management)
* [에디터에 데이터 적용하기](/data/editor-data)
* [이미지 카드](/editor/card-image)