Shopify Scripts에서 Shopify Functions로 마이그레이션

Shopify Functions는 Shopify Scripts와 유사하며 개발자가 사용자 지정 상거래 환경을 제작하는 데 사용됩니다.

플랜 요구 사항

Shopify Scripts 및 Script Editor 앱은 Shopify Plus 플랜을 이용하는 스토어만 사용할 수 있습니다. Script Editor 앱은 더 이상 Shopify App Store에서 다운로드할 수 없습니다.

2026년 6월 30일부터 Shopify Scripts가 제거되고 더 이상 작동하지 않습니다. 이 날짜 전에 기존 Scripts를 Shopify Functions로 마이그레이션하세요.

Shopify Functions

Shopify Functions는 앱에 포함되어 설치됩니다. 즉, Shopify Admin에서 다른 기능과 함께 직접 구성되므로 판매자는 사용자 지정을 생성하거나 수정할 때 코드를 사용할 필요가 없습니다. Shopify Functions를 실행하는 WebAssembly 플랫폼은 5밀리초 미만으로 코드를 실행하여 Shopify Scripts보다 성능을 향상합니다. 따라서 Shopify Functions는 반짝 세일과 같은 대규모 판매 이벤트를 성능 저하 없이 지원할 수 있습니다.

개발자는 Shopify Functions를 사용하여 자신의 로컬 환경에서 코딩과 유닛 테스트를 수행할 수 있습니다. 또한 Ruby 코드를 스토어마다 복사하고 붙여 넣는 대신 앱의 일부로 각 스토어에 Shopify Functions 사용자 지정을 배포할 수 있습니다. 마지막으로, Shopify Functions를 사용하면 시간 초과 및 CPU 메모리 제한 문제를 줄일 수 있습니다.

Shopify Functions 맞춤 설정 보고서로 Shopify Functions로 마이그레이션

Shopify Scripts 맞춤 설정 보고서는 스토어에 활성인 기존 Shopify 맞춤 설정을 표시하고 맞춤 설정을 다시 만드는 데 도움이 될 수 있는 Shopify Functions 문서 또는 관련 앱 링크를 제공하는 Shopify 관리자의 개인화된 페이지입니다.

Shopify Scripts 맞춤 설정 보고서는 자동으로 생성됩니다. 보고서를 내보내고 CSV 파일로 볼 수도 있습니다. 2026년 6월 30일 이전에 Shopify Functions를 사용하여 맞춤 설정을 다시 생성해야 합니다.

맞춤 설정 검토

사용 중인 스크립트에 따라 보고서 페이지에는 전자결제 대행사, 배송, 제품 할인 맞춤 설정 섹션이 포함될 수 있습니다.

각 섹션에는 Shopify Scripts 맞춤 설정의 이름, 설명 및 소스 파일 링크와 Shopify Functions로 빌드하여 자신의 맞춤 설정에 맞는 추천 앱에 대한 링크와 Shopify Functions 튜토리얼에 대한 링크가 포함될 수 있습니다.

다음 옵션을 사용하여 맞춤 설정을 다시 만들 것인지 결정하려면 보고서의 정보를 검토하세요.

• Shopify Functions를 사용하여 자체 솔루션을 구축
• Shopify Functions 기반으로 구축한 앱을 설치

참고 사항

Shopify Functions 기반 앱은 Shopify App Bridge를 사용해야 합니다. Shopify Admin에서 생성된 사용자 지정 앱은 Shopify App Bridge를 지원하지 않습니다. 따라서 사용자 지정 Functions 기반 앱은 파트너 대시보드를 사용해 생성한 다음 스토어에 연결해야 합니다.

맞춤 설정을 다시 만들기

1. Shopify 관리자에서 설정 > 앱 및 판매 채널로 이동합니다.

2. Script Editor를 클릭합니다.

3. Shopify Scripts 바꾸기 배너에서 Shopify Scripts 바꾸기를 클릭합니다.

4. 맞춤 설정 보고서의 각 섹션에서 다음 중 하나를 수행하세요.

   • 기존 Shopify Scripts 맞춤 설정을 보려면 자동으로 감지된 맞춤 설정의 번호 아래에 있는 스크립트 이름을 클릭하세요.
   • 스크립트와 일치하는 호환되는 앱을 보거나 설치하려면 추천 앱 섹션에서 사용하려는 앱에 대한 설치를 클릭하거나 이와 유사한 앱 더 보기를 클릭하여 다른 호환되는 앱을 찾으세요.
   • Shopify Functions 튜토리얼을 보려면, Shopify Functions를 사용하여 재구성하는 방법 섹션에서 관련 기능 API 링크를 클릭하세요.

앱 또는 Shopify Functions 맞춤 설정으로 성공적으로 테스트를 완료한 후에는 바꾸려는 스크립트를 비활성화할 수 있습니다.

Shopify Functions와 함께 Shopify Scripts 사용

Shopify Scripts는 checkout.liquid를 사용해 맞춤 설정된 결제 페이지 및 2026년 6월 30일까지 업그레이드한 결제 페이지에서 계속 사용할 수 있습니다.

Shopify Scripts 및 Shopify Functions는 한 스토어에서 동시에 사용할 수 있습니다. Shopify Functions를 사용해 현재 사용 중인 스크립트를 교체할 수 없는 경우 Shopify Functions API가 스토어의 요구 사항을 충족할 때까지 Shopify Scripts를 계속 사용하십시오. Shopify Scripts와 Shopify Functions가 상호 작용하는 방식은 다음을 참조하십시오.

품목 스크립트

품목 스크립트는 Shopify Functions 이전에 실행되며 여기에는 앱에서 생성된 할인이 포함됩니다. 품목 스크립트는 함수 및 앱에 의해 할인된 금액에 액세스할 수 없습니다.

스크립트는 결제에 적용된 첫 번째 할인 코드에만 액세스할 수 있으며 사용되는 다른 할인 코드에는 액세스할 수 없습니다. 예를 들어, reject을(를) 사용하면 결제에 처음 적용되는 할인에만 작동하고 다른 할인은 영향을 받지 않습니다.

배송 스크립트

배송 스크립트는 Shopify Functions에서 생성된 배송 사용자 지정 후에 실행됩니다. 스크립트는 수정된 배송 사용자 지정 이름 변경 결과에 작동할 수 없지만, 이동되거나 숨겨진 사용자 지정에는 작동합니다.

결제 스크립트

결제 스크립트는 Shopify Functions에서 생성된 결제 사용자 지정 후에 실행됩니다. 스크립트는 수정된 결제 사용자 지정 이름 변경 결과에 작동할 수 없지만, 이동되거나 숨겨진 사용자 지정에는 작동합니다.