---
title: "구독 위젯: Subscriptions 문서 | Chargezen"
description: "Shopify 제품 페이지에 Chargezen 구독 위젯을 추가하세요. 템플릿을 고르고, 문구와 디자인을 정하고, 장바구니 담기 전에 보여 줄 제안을 추가해요."
url: "https://chargezen.com/ko/docs/subscriptions/subscription-widget"
lang: "ko"
updated: "2026-10-18"
---

Canonical URL: https://chargezen.com/ko/docs/subscriptions/subscription-widget

# 구독 위젯

Shopify 제품 페이지에 Chargezen 구독 위젯을 추가하세요. 템플릿을 고르고, 문구와 디자인을 정하고, 장바구니 담기 전에 보여 줄 제안을 추가해요.

마지막 업데이트: 2026-10-18

구독 위젯은 제품 페이지에 있는 구매 상자로, 쇼핑객이 일회성 구매와 구독 중에서 고르고, 배송 주기를 정하고, 장바구니에 담는 곳이에요. 대부분의 구독이 여기서 시작되니 알기 쉽게 만들어 두면 효과가 커요. **Subscriptions → Customer experience → Subscription widget**을 여세요.

## 설정하기

1

#### 위젯 만들기

**Create widget**을 선택한 다음, **Product widget**(어떤 제품 페이지에나 맞는 간결한 구매 상자) 또는 **Variant cards**(옵션 상품 카드, 일회성 또는 구독, 장바구니 담기 전 제안)에서 **Use template**을 선택하세요.

2

#### 문구와 디자인 편집하기

편집기 섹션(Content, Layout, Behavior, Style 등)을 차례로 설정하세요. **Previewing**으로 제품을 고르고, 데스크톱·모바일 버튼으로 두 화면 크기를 확인하세요.

3

#### 표시할 위치 고르기

**Publish**에서 **Widget name**(나만 봐요)을 입력하고, **Show on**을 **All products** 또는 **Specific products**로 설정하세요.

4

#### 저장하기

**Save**를 선택하세요.

5

#### 테마에 블록 추가하기

**On your store**에서 **Add the block in Shopify**를 선택하세요. Shopify에서 **Online Store → Themes → Customize**를 열고, 제품 템플릿을 열어 **Chargezen product widget** 또는 **Chargezen variant cards** 블록을 추가한 다음 테마를 저장하세요.

플랜에서 시작하기

플랜의 **Storefront widget** 카드에서 **Customize widget**을 누르면 그 플랜 제품의 위젯이 열리거나 새 위젯이 시작돼요.

## Product widget 옵션

*   **Content**: 버튼 문구(Add to cart, Buy now), 일회성 옵션의 제목과 부제목, 구독 옵션의 제목, 부제목, **Delivery selector label**, 수량 레이블이에요. 처음 문구는 “One-time purchase”, “Subscribe and save”, “Pause, skip, or cancel anytime.”이에요.
*   **Layout**: 판매처, 제품명, 가격, 옵션 상품 선택기, 일회성·구독 옵션, 배송 주기 선택기, 수량 선택기, Add to cart, Buy now를 보이거나 숨겨요.
*   **Behavior**: **Selected by default**(Auto, One-time, Subscription), **Shown first**, 수량 한도, 그리고 위젯이 옵션 상품 미디어를 보여 줄지 테마의 제품 이미지를 바꿀지 정해요.
*   **Rules**: 확인 팝업이 있는 **Allow preorders**, 경고 메시지가 있는 **Confirm before purchase**, 레이블과 할인율이 있는 **Discount this product**, 그리고 **Offer all variants as a bundle**이에요.
*   **Style**: 버튼 색상과 문구, 글자 색상, 선택 색상, 배경면과 테두리

## Variant cards 옵션

*   **Content**: 일회성·구독 카드, 버튼 문구, 품절 문구, 통화 기호예요. 구독 제목의 `{{savings}}`는 할인 금액으로 바뀌어요.
*   **Layout**: 가격, 옵션 상품 카드와 열, 어떤 카드와 버튼을 보여 줄지 정해요.
*   **Offers**: **Bundle (try them all)**, **Upsell**, **Buy more**, **Sell as another variant**, **Preorder**를 추가해요. 제안마다 **Show this offer**가 있고, 필수 필드를 채울 때까지 꺼져 있어요. 추가 판매 제안은 고객이 거절하면 다른 제안을 보여 주거나 아무것도 보여 주지 않을 수 있어요.
*   **Variants**: 카드를 낮은 가격순, 높은 가격순, 직접 정한 순서로 정렬하고, 옵션 상품의 이름을 바꾸거나 숨기거나 품절로 표시해요.
*   **Behavior**: **Selected by default**예요. Auto는 /start, /pay 링크에서는 구독을, 그 밖의 모든 곳에서는 일회성 구매를 선택해요.
*   **Style**과 **Custom CSS**: 색상, 모서리, 타이포그래피, 그리고 위젯 자체 스타일 다음에 불러오는 CSS예요(선택자는 `#ketonaid-widget`으로 시작하세요).

## 제품이 어떤 위젯을 쓰는지

**All products**로 설정한 위젯은 자체 위젯이 있는 제품을 빼고 모든 제품에 표시돼요. 특정 제품용 위젯 여러 개에 같은 제품이 들어 있으면 **Priority**가 더 높은 위젯이 적용돼요.

위젯 목록에는 위젯마다 **Type**, **Template**, **Status**, **Scope**, **Offers**가 표시돼요. **Filter**로 All, Active, Draft 위젯을 골라 보고, 행 메뉴에서 **Edit**나 **Delete**를 할 수 있어요.

## 문제 해결

### 제품 페이지에 위젯이 보이지 않아요

*   사용 중인 제품 템플릿에 블록을 추가했는지, 테마를 저장했는지 확인하세요.
*   위젯이 그 제품이나 All products에 표시되도록 설정되어 있는지 확인하세요.
*   그 제품이 들어 있는 다른 위젯의 우선순위가 더 높지 않은지 확인하세요.

### 위젯은 보이는데 구독 옵션이 보이지 않아요

*   플랜이 Active 상태이고, 그 제품을 포함하고, **Online Store** 채널이 켜져 있어야 해요. Online Store에서 숨긴 플랜은 어떤 위젯에서도 제공되지 않아요.
*   쇼핑객이 제품 페이지에서 구독할 수 있도록 플랜에 제품을 추가하세요.

### 위젯이 저장되지 않아요

위젯 이름을 정하고, 제품을 하나 이상 고르거나 모든 제품에 표시하세요.

## 관련 문서

*   [추가 판매와 교차 판매](https://chargezen.com/ko/subscriptions/upsells-and-cross-sells): 일회성 구매 고객을 구독자로 바꾸세요.
*   [구독이 처음이라면](https://chargezen.com/ko/subscriptions/getting-started): 첫 구독 프로그램을 시작하세요.
*   용어집: [구독 할인](https://chargezen.com/glossary/subscribe-and-save), [제품 상세 페이지](https://chargezen.com/ko/glossary/product-detail-page), [장바구니 담기](https://chargezen.com/ko/glossary/add-to-cart).

### 관련 문서

[

#### 구독 플랜 만들기

위젯이 제공하는 플랜



](https://chargezen.com/ko/docs/subscriptions/create-product)[

#### 판매 플랜의 작동 방식

Online Store 채널이 중요한 이유



](https://chargezen.com/ko/docs/subscriptions/selling-plans-explained)[

#### 박스 구성 번들

고객이 직접 채우는 박스



](https://chargezen.com/ko/docs/subscriptions/build-a-box)

이 페이지가 도움이 되었나요?

도움이 더 필요하신가요? [고객 지원 문의](https://chargezen.com/docs/checkoutos/troubleshooting/support)
