> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.teeinblue.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Multiple Uploads - Tải lên nhiều ảnh

# Multiple Uploads là gì?

**Photo Upload** giờ có hai loại: **Single Upload** và **Multiple Uploads**, cho phép người mua tải lên nhiều ảnh.

Multiple Uploads có 2 loại output:

* **Single Output** dùng một hiệu ứng GenAI để ghép tất cả ảnh đã tải lên thành một ảnh cuối cùng, ví dụ: ghép ảnh của cùng một người ở các độ tuổi khác nhau, hoặc ghép nhiều thành viên trong gia đình vào một thiết kế.
* **Multiple Outputs** không áp dụng hiệu ứng nào: mỗi ảnh tải lên được đặt vào một layer Photo Upload riêng trên thiết kế, rất phù hợp cho photo collage, photo book và các bố cục nhiều ảnh khác.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/image_efcwuu.png)


# Cách hoạt động trên Storefront

## Single Output

![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/image_1sxydwu.png =273xauto)

Người mua bấm nút **+** để tải ảnh lên, có thể chọn nhiều ảnh cùng lúc hoặc từng ảnh một. Khác với Single Upload, nút **+** vẫn hiển thị để họ có thể tiếp tục thêm ảnh. Người mua có thể xoá (**X**) hoặc kéo để sắp xếp lại thứ tự ảnh, sau đó bấm **Generate image** và chờ dịch vụ AI trả về ảnh đã ghép.

## Multiple Outputs

![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/multipleoutput_bn1xd0.gif)

* Người mua bấm nút **+** để tải ảnh lên: chọn nhiều ảnh cùng lúc hoặc từng ảnh một, tối đa bằng số **Maximum photos** bạn đã thiết lập.
* **Không có** nút **Generate image**. Ảnh được tải lên ngay và hiển thị luôn trên live preview, mỗi ảnh ở đúng vị trí của nó: ảnh #1 vào layer được đặt `{{input.1}}`, ảnh #2 vào `{{input.2}}`, v.v.
* Người mua có thể xoá (`X`) hoặc kéo để sắp xếp lại các thumbnail. Khi sắp xếp lại, ảnh cũng được chuyển sang các vị trí tương ứng trên thiết kế.
* Nếu người mua tải lên ít ảnh hơn số vị trí, các vị trí trống sẽ giữ nguyên ảnh placeholder.
* Trường này là bắt buộc: chỉ có thể `Add to Cart` khi đã tải lên ít nhất một ảnh và tất cả ảnh đã chọn đều đã tải lên xong.
* Bản thân layer Multiple Uploads không hiển thị trên thiết kế, mockup hay file in; ảnh chỉ xuất hiện thông qua các layer Photo Upload nhận ảnh đó.


# Cách thiết lập layer Multiple Uploads

* Mở một Artwork (chỉ áp dụng cho Artwork 2.0), chọn **Photo Upload** trong danh sách layer, sau đó chọn **Multiple Uploads**.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/image_53uyvf.png =1000x548)

* Chọn **Output Type**: Single Output hoặc Multiple Outputs. Các tuỳ chọn cài đặt sẽ thay đổi theo lựa chọn này.

## Cài đặt cho Single Output

* **Maximum photos**: số ảnh tối đa người mua có thể tải lên, giới hạn tối đa là 3 (các dịch vụ GenAI hoạt động tốt nhất với 3 ảnh đầu vào trở xuống).
* **Upload editor**: Direct Upload hoặc Photo Reposition. Multiple Uploads không hỗ trợ Photo Cropper.
* **GenAI service**: nhà cung cấp AI (OpenAI, Gemini, Flux...). Đây là trường bắt buộc với layer này.
* **Set minimum size**: giống Single Upload, nhưng áp dụng cho tất cả ảnh người mua tải lên chứ không chỉ một ảnh.
* **Fit mode**, **Show customer's photo on live preview** và **Add instruction for customer**: hoạt động giống như ở Single Upload.

Bạn có thể dịch nút **Generate image** trong **Product Page Content** → **Generate Image Buttons**.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/image_n3wnk4.png =586xauto)

## Cài đặt cho Multiple Outputs

![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/image_wnfdxn.png)

* **Maximum photos**: tối thiểu 2, không giới hạn tối đa 
* **Upload editor**: Direct Upload hoặc Photo Reposition (không hỗ trợ Photo Cropper).

| Multiple Outputs không có **GenAI service**, **Image effects after generating** hay **Fit mode**, vì loại này không áp dụng hiệu ứng nào. Mỗi ảnh sẽ theo cài đặt của layer Photo Upload mà nó được đặt vào.

### Thêm một layer Photo Upload cho mỗi ảnh

Multiple Outputs chỉ có nhiệm vụ thu thập ảnh. Để hiển thị ảnh trên thiết kế, hãy thêm một layer Photo Upload cho mỗi ảnh và liên kết nó với layer Multiple Uploads:

* Thêm một layer **Photo Upload** → **Single Upload**, đặt vị trí/chỉnh kích thước tại nơi ảnh #1 sẽ hiển thị.
* Trong **Personalization for this layer**, chọn **No personalization** để người mua chỉ thấy trường Multiple Uploads trên form.
* Mở **POPULATE VALUES** và bật **Populate Content from another option**. Chọn layer Multiple Uploads của bạn làm **Source option**, sau đó bấm **+ Available Value** và chọn `{{input.1}}` (ảnh gốc #1).
* Lặp lại với các vị trí tiếp theo bằng `{{input.2}}`, `{{input.3}}`... Mẹo: nhân bản (duplicate) layer đầu tiên, di chuyển nó, rồi chỉ cần đổi giá trị.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/image_ehtaky.png)

**Lưu ý**

* Với Multiple Outputs, chỉ có các giá trị `{{input.1}}`, `{{input.2}}`...; `{{output}}` (ảnh đã ghép) chỉ có ở Single Output.
* Teeinblue không kiểm tra số lượng layer Photo Upload có khớp với **Maximum photos** hay không, vì vậy hãy đảm bảo bạn đã thêm đủ một layer cho mỗi ảnh muốn hiển thị.
* Mỗi ảnh sẽ dùng fit mode của layer Photo Upload mà nó được đặt vào, và nếu layer đó có hiệu ứng ảnh riêng (ví dụ: GenAI filter hoặc Remove background), hiệu ứng đó cũng sẽ được áp dụng cho ảnh.
* Nếu bạn chuyển một layer Single Output có sẵn sang Multiple Outputs, các layer Photo Upload vẫn đang đặt `{{output}}` sẽ mất cài đặt populate khi bạn lưu artwork. Hãy chọn lại `{{input.N}}` cho các layer đó.

### Photo Reposition với Multiple Outputs

* Khi **Upload editor** được đặt là Photo Reposition, sau khi tải ảnh lên người mua sẽ thấy nút **Recustomize image** trên trường Multiple Uploads. Nút này mở một popup cho phép họ chỉnh vị trí từng ảnh và chuyển qua lại giữa các vị trí ảnh. Nút chỉ hiển thị khi ít nhất một trong các layer bên dưới đã có ảnh, và bị vô hiệu hoá khi vẫn còn ảnh đang tải lên hoặc hiệu ứng đang chạy.

* Popup sẽ căn chỉnh vị trí cho các layer Photo Upload được đặt **No personalization** (mặc định toàn bộ ảnh nằm vừa trong khung), cùng với các layer có editor **Photo Reposition** riêng (cả hai dùng chung một vị trí). Các layer Photo Upload được cá nhân hoá bằng **Direct upload** hoặc **Photo Cropper** vẫn hoạt động với editor riêng của chúng và không xuất hiện trong popup.