> ## 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와 테마 호환성

> 이 문서에서는 Upcart의 테마 호환성 문제를 해결하는 방법을 안내하고 최적의 성능을 위한 모범 사례를 제공해요.

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

Upcart는 대부분의 **Shopify 자체 제작 테마**와 원활하게 통합되도록 설계되었어요. 다만 일부 서드파티 테마는 코드 구조와 커스터마이징 방식의 차이로 인해 기능 문제가 발생할 수 있어요.

네이티브 Shopify 테마는 Shopify에서 직접 개발하여 완벽한 호환성이 보장되는 반면, 커스텀 또는 서드파티 테마는 Shopify 플랫폼을 통해 구매했더라도 문제를 일으킬 수 있어요.

Upcart와의 호환성과 성능이 가장 좋은 **Dawn** 같은 **Shopify 기본 테마** 사용을 권장해요. 서드파티 테마는 개발 방식의 차이로 인해 저희가 통제할 수 없는 충돌이 발생할 수 있어, 저희 팀의 지원 범위가 제한적이에요.

참고로 FOXECOM 같은 테마는 Shopify에서 구매했더라도 서드파티로 분류되며 기능에 일부 제한이 있을 수 있어요.

***

<div id="incompatible-themes">
  ## 비호환 테마
</div>

다음 테마는 Upcart에서 지속적으로 문제를 일으키는 것으로 확인되어 지원되지 않아요:

* **Trade**

이 테마를 사용 중이고 Upcart에서 문제가 발생한다면, 전체 기능을 보장하기 위해 더 호환성이 좋은 Shopify 자체 제작 테마로 전환하는 것을 권장해요.

***

<div id="themes-that-may-cause-issues">
  ## 문제를 일으킬 수 있는 테마
</div>

다음 테마는 충돌이 보고되었거나 Upcart와 의도대로 완전히 작동하지 않을 수 있어요:

* **Shrine**
* **Impulse**
* **Impact**
* **Prestige**

이 테마들은 경우에 따라 작동할 수도 있지만, Upcart의 특정 요소나 기능이 예상대로 표시되거나 작동하지 않을 수 있어요. 이 테마 중 하나를 사용하다가 문제가 발생하면 **Dawn**이나 다른 Shopify 자체 제작 테마로 테스트해 보는 것을 권장해요.

호환성 문제가 있는 테마의 경우, 개발자는 [Upcart Public API](https://rokt.notion.site/upcart-public-api)를 활용해 문제 해결을 진행할 수 있어요.

참고

여기 나열된 테마는 Upcart와 잠재적 호환성 문제가 확인된 예시예요. 아직 확인되지 않은 다른 테마가 있을 수 있어요. 새로운 사례가 발견되거나 보고되면 이 목록이 업데이트될 거예요.

***

<div id="partially-supported-themes">
  ## 부분적으로 지원되는 테마
</div>

많은 Shopify 테마가 Upcart와 호환되며, 저희는 커스텀 테마나 비기본 테마를 사용하는 판매자도 최대한 앱을 사용할 수 있도록 노력하고 있어요.

테마가 부분적으로만 지원된다고 의심된다면:

Shopify 전문가에게 Upcart API 사용을 의뢰하거나, 표준 Shopify 요소가 사용되고 있는지 확인하거나, 호환성 문제를 없애기 위해 네이티브 Shopify 테마로의 전환을 고려할 수 있어요.

1. 먼저 다음 문서를 확인하세요:

* [**테마에서 카트 유형 변경하기**](/ko/upcart/change_cart_type_in_theme)

- **Malformed Theme Code**

2. 이 단계를 따른 후에도 문제가 지속되면 **Upcart 지원팀**에 문의해 추가 지원을 받으세요.
3. 테마 호환성 문제를 효과적으로 해결할 수 있도록 테마 개발자에게 [UpCart Public API](https://rokt.notion.site/upcart-public-api) 접근 권한을 제공하세요.

***

<div id="testing-recommendation">
  ## 테스트 권장 사항
</div>

변경 사항을 라이브로 적용하기 전에 **테마 미리보기**나 테마의 **복제 버전**에서 Upcart를 테스트하는 것을 권장해요. 이렇게 하면 라이브 스토어프론트에 영향을 주지 않고 모든 카트 및 업셀 기능이 올바르게 작동하는지 확인할 수 있어요.

방법은 다음과 같아요:

1. Shopify 관리자에서 **Online Store > Themes**로 이동하세요.
2. 라이브 테마 옆의 **Actions**를 클릭한 다음 **Duplicate**를 선택하세요.
3. 복제된 테마를 열고 **Preview**를 클릭하세요.
4. 카트 상호작용, 할인, 업셀을 포함한 Upcart 설정을 테스트하세요.
5. 확인이 완료되면 업데이트된 테마를 게시하세요.

미리 테스트하면 호환성을 보장하고, 고객에게 영향을 주기 전에 표시나 성능 문제를 방지할 수 있어요.

***

<div id="best-practices">
  ## 모범 사례
</div>

최상의 성능을 유지하고 Upcart가 테마와 원활하게 작동하도록 하려면:

* **테마를 최신 상태로 유지하세요.** Shopify와 테마 개발자는 호환성과 성능을 개선하는 업데이트를 정기적으로 출시해요.
* **테마 편집 후에는 항상 테스트하세요.** 코드나 레이아웃을 변경했다면 카트 동작을 테스트해 모든 것이 올바르게 표시되는지 확인하세요.
* **과도한 서드파티 커스터마이징을 피하세요.** 대규모 디자인이나 스크립트 수정은 카트 기능을 방해할 수 있어요.
* **Shopify의 테마 에디터를 신중하게 사용하세요.** 표시나 체크아웃 문제를 방지하려면 게시 전에 변경 사항을 미리 확인하세요.

이러한 모범 사례를 따르면 안정적인 설정을 유지하고 스토어가 Upcart와 함께 원활하게 운영되도록 할 수 있어요.