> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 테마에서 카트 유형 변경하기

> 이 문서는 테마의 카트 유형 설정을 수정해 Upcart 드로어 문제를 해결하는 방법을 설명해요.

<div id="overview">
  ## 개요
</div>

이 가이드는 **Upcart가 열리지 않거나** 고객이 Upcart 드로어 대신 카트 페이지로 리디렉션되는 상황을 해결하도록 도와드려요. 이러한 문제 대부분은 테마 카트 유형 설정, Enhanced AJAX API Compatibility 구성, 서드파티 앱 리디렉션, 체크아웃 버튼 라우팅이 원인이에요.

<Note>
  Upcart가 전혀 열리지 않거나 카트 페이지로 리디렉션된다면 더 포괄적인 문제 해결 가이드인 [Upcart가 열리지 않거나 카트 페이지로 리디렉션되는 문제 해결](/ko/upcart/troubleshooting_upcart_not_opening_or_redirecting)을 참조하세요.
</Note>

***

<div id="what-cart-type-to-choose">
  ## 어떤 카트 유형을 선택해야 할까요
</div>

문제 해결에 들어가기 전에 가장 흔한 원인인 테마의 카트 유형 설정부터 확인하세요.

* **Page** - Upcart가 **/cart** 페이지로의 요청을 가로채기 때문에 보통 가장 좋은 옵션이에요.
* **Drawer** - Upcart가 실행되지 않고 대신 **/cart** 페이지가 트리거된다면 이 옵션을 선택하세요.
* **Confirmation Popup** - 테마가 지원하고 다른 옵션으로 문제가 해결되지 않는 경우 사용하세요.

두 옵션을 모두 테스트하는 데 몇 분밖에 걸리지 않지만, 일반적으로 **Page**가 가장 효과적인 선택이에요.

<div id="how-to-change-cart-type-in-your-theme">
  ### 테마에서 카트 유형을 변경하는 방법
</div>

1. Shopify 관리자에서 **Online Store > Themes > Customize**로 이동하세요.
2. **Theme Settings > Cart > Cart Type**을 여세요.
3. 문제 해결 중인 동작에 따라 **Page** 또는 **Drawer**를 선택하세요.
4. 변경 사항을 저장하고 스토어프론트에서 카트를 테스트하세요.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-type-theme-editor-settings-option.gif?s=81eef4e6af5190720b3eb86be578c605" alt="카트 유형 옵션이 표시된 Shopify 테마 편집기 카트 설정" width="644" height="1080" data-path="images/upcart/cart-type-theme-editor-settings-option.gif" />

<Note>
  이 설정을 찾을 수 없다면 테마 개발자에게 문의하세요. 이 설정은 테마가 제어하며 Upcart가 직접 수정할 수 없어요.
</Note>

***

<div id="troubleshooting-steps">
  ## 문제 해결 단계
</div>

카트 유형을 변경해도 문제가 해결되지 않으면 다음 단계를 순서대로 진행하세요.

<div id="1-check-enhanced-ajax-api-compatibility">
  ### 1. Enhanced AJAX API Compatibility 확인하기
</div>

이 설정은 Upcart가 Add to Cart 이벤트를 처리하는 방식을 제어하며 리디렉션 문제의 가장 흔한 원인 중 하나예요.

1. **Upcart > Cart Editor > Settings > Cart settings**로 이동한 다음 **Advanced Settings**를 펼치세요.
2. **Enhanced Ajax API compatibility**를 찾으세요.
3. 이 설정은 대부분의 스토어에서 **기본적으로 비활성화**되어 있어요. 비활성화 상태에서는 Upcart가 Add to Cart 호출을 가로채 리디렉션을 방지해요.
4. 활성화되어 있으면 다른 앱이 카트 동작을 제어해 고객을 카트 페이지로 리디렉션할 수 있어요. 비활성화하고 테스트해 보세요.
5. 비활성화가 다른 문제를 일으키면 다시 활성화하고 대신 수동 Upcart API(`upcartRegisterAddToCart`)를 사용하세요.

이 설정에 대한 전체 안내는 [Enhanced AJAX API Compatibility](/ko/upcart/enhanced_ajax_api_compatibility)를 참조하세요.

<div id="2-check-for-third-party-app-redirects">
  ### 2. 서드파티 앱 리디렉션 확인하기
</div>

많은 서드파티 앱이 카트 동작을 재정의해 고객을 Upcart 드로어에서 벗어나게 리디렉션할 수 있어요. Add to Cart 버튼이 고객을 카트 페이지로 보내고 있다면 자세한 내용은 ['Add to Cart'가 Upcart 대신 카트 페이지로 이동하는 이유는?](/ko/upcart/why_does_add_to_cart_go_to_the_cart_page_instead_of_upcart)을 참조하세요.

카트 관련 앱들의 설정을 열고 다음과 같은 옵션을 찾아보세요:

* Redirect to cart
* Go to cart after add
* Automatically open cart page
* Action after product is added

이 설정들을 **Stay on page** 또는 **Do nothing**으로 변경하세요.

**흔한 앱별 해결 방법:**

* **PageFly** - PageFly 앱 설정에서 리디렉션 규칙을 비활성화하세요.
* **Globo Product Options** - Shopify 카트로의 자동 리디렉션을 비활성화하세요.
* **Replo** - 카트 드로어를 활성화하도록 "go to page" 설정을 조정하세요.
* **Zepto Product Personalizer** - Zepto > Settings > Add to Cart Settings로 이동해 "Action after a product is added to the cart"를 "Stay on the product page and show a success message"로 변경하세요.

어떤 앱이 충돌을 일으키는지 확실하지 않다면 카트 관련 앱을 하나씩 비활성화하면서 Upcart가 올바르게 작동할 때까지 매번 테스트하세요.

<div id="3-check-checkout-button-routing">
  ### 3. 체크아웃 버튼 라우팅 확인하기
</div>

고객이 Upcart 안의 체크아웃 버튼을 클릭했는데 체크아웃 대신 카트 페이지로 리디렉션된다면:

1. **Upcart > Cart Editor > Settings > Cart settings**로 이동하세요.
2. \*\*"Go to cart page when pressing checkout button"\*\*을 찾으세요.
3. 이것을 **끄세요**.
4. 저장하고 테스트하세요.

<Note>
  커스텀 체크아웃 페이지 리디렉션은 고급 코딩이 필요하며 Upcart에서 직접 지원하지 않아요. 고객을 커스텀 체크아웃 페이지로 라우팅해야 한다면 개발자와 협업해야 해요.
</Note>

<div id="4-check-theme-cart-redirect-settings">
  ### 4. 테마 카트 리디렉션 설정 확인하기
</div>

일부 테마는 상품 추가 후 고객을 자동으로 리디렉션해 Upcart를 완전히 우회해요.

1. **Online Store > Themes > Customize**로 이동하세요.
2. **Theme Settings > Products**(또는 Cart)를 여세요.
3. 다음과 같은 설정을 찾아보세요:
   * Enable cart redirection
   * Redirect to cart after add
   * Go to cart after add
4. 이것들을 **끄세요**.
5. 저장하고 테스트하세요.

<div id="5-clear-browser-cache">
  ### 5. 브라우저 캐시 지우기
</div>

오래된 캐시 스크립트가 이전 카트 동작을 유지해 Upcart가 올바르게 로드되지 않을 수 있어요.

1. 브라우저 설정을 여세요.
2. **개인 정보 보호 및 보안**으로 이동하세요.
3. **인터넷 사용 기록 삭제**를 선택하세요.
4. 캐시된 이미지, 파일, 쿠키를 삭제하세요.
5. 스토어를 새로고침하고 테스트하세요.

<div id="6-test-with-a-default-shopify-theme">
  ### 6. 기본 Shopify 테마로 테스트하기
</div>

문제가 지속되면 테마별 충돌을 배제하기 위해 일시적으로 Dawn 같은 기본 Shopify 테마로 전환해 보세요.

1. **Shopify Admin > Online Store > Themes**로 이동하세요.
2. Dawn 같은 무료 테마를 추가하고 활성화하세요.
3. 기본 테마에서 Upcart를 테스트하세요.

Dawn에서 Upcart가 올바르게 작동한다면 문제는 커스텀 테마에 있어요. 테마 개발자에게 도움을 요청하세요.

***

<div id="preventative-measures">
  ## 예방 조치
</div>

* **업데이트 후 설정 검토하기** - 테마 및 앱 업데이트는 카트 설정을 초기화하거나 재정의할 수 있어요. 주요 업데이트 후에는 카트 유형과 앱 설정을 확인하세요.
* **설치 전 앱 호환성 테스트하기** - 새 서드파티 앱을 추가하기 전에 Upcart와 호환되는지 확인하세요.
* **테스트에는 초안 테마 사용하기** - 라이브 스토어에 지장을 주지 않도록 게시 전에 초안 테마에서 변경 사항을 테스트하세요. 방법은 [초안 테마에서만 Upcart 활성화하기](/ko/upcart/enabling_upcart_in_a_draft_theme_only)를 참조하세요.

***

<div id="frequently-asked-questions">
  ## 자주 묻는 질문
</div>

<AccordionGroup>
  <Accordion title="Upcart 체크아웃 버튼이 커스텀 체크아웃 페이지로 리디렉션할 수 있나요?">
    아니요, 커스텀 체크아웃 페이지 리디렉션은 고급 코딩이 필요하며 Upcart에서 직접 지원하지 않아요. 필요하다면 개발자와 협업해야 해요.
  </Accordion>

  <Accordion title="Upcart를 활성화한 후에도 카트가 여전히 Shopify로 리디렉션되는 이유는 뭔가요?">
    Cart Editor에서 Upcart가 활성화되고 게시되었는지 확인하세요. 또한 업데이트된 동작이 적용되도록 브라우저 캐시를 지우세요. 문제가 지속되면 위 단계를 사용해 서드파티 앱 충돌을 확인하세요.
  </Accordion>

  <Accordion title="리디렉션을 일으키는 상품 애드온 앱은 어떻게 해결하나요?">
    애드온 앱의 설정을 열고 자동 리디렉션이나 "go to cart" 설정을 찾아보세요. Upcart와 충돌한다면 비활성화하세요. 앱별 예시는 위의 2단계를 참조하세요.
  </Accordion>
</AccordionGroup>

***

**도움이 필요하신가요?**

위의 모든 단계를 진행했는데도 문제가 지속되면 앱 내 채팅이나 [support@upcart.app](mailto:support@upcart.app) 이메일을 통해 지원팀에 문의하세요.