Skip to main content
상품 애드온(Product add-on) 블록은 여러분이 선택한 특정 상품 하나를 장바구니 안에서 애드온으로 제안해, 알려진 상품 하나(보증, 샘플, 베스트셀러)를 장바구니에서 바로 빠르게 추가할 수 있도록 홍보해요.
전략에 따라 선택된 상품을 표시하는 업셀과 달리, 상품 애드온은 항상 여러분이 선택한 정확히 그 상품을 보여줘요.
쇼핑객이 장바구니에 함께 담을 수 있는 추가 상품을 제안하는 상품 애드온 블록

동작 방식

  • 활성 변형(variant)이 확인되지 않으면 — 상품이 설정되지 않았거나, 보관 처리되었거나, 품절인 경우 — 블록은 작동하지 않는 버튼 대신 아무것도 렌더링하지 않아요.
  • 컨트롤은 이 블록 자체의 애드온 라인이 장바구니에 있는지를 반영하므로, 끄면 이 블록이 추가한 라인만 제거돼요(다른 곳에서 추가된 같은 상품에는 영향을 주지 않아요).
  • 실제 할인이 있을 때 정가(compare-at price)에 취소선이 표시되며, 할인율이 반올림해서 1% 미만이면 ”% off” 레이블이 숨겨져요.
  • 선택한 변형에 이미지가 없으면 애드온 이미지는 상품의 대표 이미지로 대체돼요.

설정

Title, Price label, Description은 모두 같은 네 가지 토큰을 지원해요: {{product_title}}, {{price}}, {{compare_at_price}}, {{savings}}.

배치 및 제한

  • 영역: 본문(body) 또는 하단(bottom).
  • 최대: 장바구니 상태당 3개 — 채워진 장바구니와 빈 장바구니 각각 별도의 허용량이 있어요.
  • 상태: 채워진 장바구니와 빈 장바구니 모두.
  • 기본으로 추가되지 않아요. 잠겨 있지 않으므로 제거하거나 숨길 수 있어요.

커스텀 템플릿

코드(Code) 탭에서 커스텀 템플릿을 지원하며, 이 블록의 기본 마크업을 여러분의 JSX로 대체해요. 이 블록이 받는 props는 다음과 같아요.

콘텐츠

상태 및 액션

format이 어떤 핸들러가 적용되는지 결정해요: buttonhandleAdd, checkboxtogglehandleToggle이에요. variantIdnull이면 추가할 것이 없다는 뜻이므로, 성공할 수 없는 핸들러를 호출하기보다 이 값으로 컨트롤을 제한하세요.

디자인

설정 패널의 Design 섹션에서 이 블록의 스타일을 지정하세요. 이는 전역 디자인 위에 적용되는 블록별 재정의이며, 비워 두면 전역 디자인으로 대체돼요.

텍스트

Design의 Text 섹션에서 세 요소의 타이포그래피를 제어할 수 있어요. Text element 선택기로 요소를 전환하세요. Title — 상품명이에요. 커스텀 글꼴 패밀리도 지원해요. 굵기와 텍스트 색상은 (Settings 탭의) 위쪽 리치 텍스트 에디터에서 설정하며, 이곳에서 설정하지 않아요. Price — 가격 표시 줄이에요. 굵기와 텍스트 색상은 위쪽 리치 텍스트 에디터에서 설정해요. Description — 보조 문구예요. 굵기와 텍스트 색상은 위쪽 리치 텍스트 에디터에서 설정해요.
장바구니 미리보기에서 텍스트 요소를 직접 클릭하면 해당 요소가 강조되고, 패널에서 해당 컨트롤이 자동으로 열려요.
디자인 설정이 무엇인가요? 자세한 내용은 여기에서 확인하세요: 디자인 설정.