Skip to main content

Shopify Winter '26 에디션: 완전 개발자 가이드

Shopify Winter '26 에디션 (2026년 1월)은 Shopify 역사상 가장 큰 플랫폼 업데이트로, 150개 이상의 새로운 기능과 개선 사항을 포함합니다. 이 가이드는 개발자에게 중요한 모든 것을 영향 영역별로 정리합니다.

이 에디션이 다른 이유

Winter '26은 Shopify의 에이전틱 커머스로의 전면 전환을 나타냅니다 -- AI 에이전트가 (인간뿐만 아니라) 소비자를 대신하여 탐색, 협상, 구매를 수행한다는 개념입니다. 이 에디션의 모든 주요 기능은 AI 에이전트를 가능하게 하거나 AI 지원으로 구축되었습니다. 개발자로서 이 변화를 이해하는 것은 2026년 이후에 관련성 있는 App을 구축하는 데 필수적입니다.

AI 및 에이전틱 커머스​

Winter '26의 핵심입니다. Shopify는 다음 전자상거래 성장의 파도가 AI 기반 쇼핑 에이전트에서 올 것이라고 베팅하고 있습니다.

Shopify Sidekick (메이저 업그레이드)​

Shopify의 상인용 내장 AI 어시스턴트인 Sidekick이 출시 이후 가장 중요한 업그레이드를 받았습니다.

새로운 기능:

  • Sidekick Extensions API -- 서드파티 App이 Sidekick에 커스텀 기능을 확장 가능. 상인이 Sidekick에 "이메일 캠페인 최적화해 줘"라고 요청하면, 당신의 App이 처리할 수 있습니다.
  • Sidekick Actions -- Sidekick이 다중 단계 워크플로우를 실행 가능: 제품 생성, 할인 설정, 마케팅 캠페인 스케줄을 하나의 대화에서.
  • 컨텍스트 인식 -- Sidekick이 스토어 분석, 최근 주문, 고객 데이터를 읽고 상황에 맞는 추천을 제공.
  • 상인 승인 플로우 -- Sidekick이 액션을 제안하고 실행 전에 상인의 확인을 기다립니다. 신뢰에 필수적.

개발자 영향:

  • App 개발자를 위한 새로운 Sidekick Extension Points
  • sidekick.action.propose 및 sidekick.action.execute API 엔드포인트
  • Partner Dashboard를 통한 커스텀 도구 등록
# Register a Sidekick Extension
mutation sidekickExtensionCreate {
  sidekickExtensionCreate(input: {
    title: "Email Campaign Optimizer"
    description: "Analyzes store data and optimizes email campaigns"
    actionDefinitions: [
      {
        name: "optimize_campaign"
        description: "Optimize an email campaign based on store analytics"
        inputSchema: "{ ... }"
      }
    ]
  }) {
    sidekickExtension { id }
    userErrors { field message }
  }
}
Sidekick Extensions는 개발자 프리뷰 중

Winter '26 기준으로, Sidekick Extensions는 승인된 파트너가 사용 가능합니다. Partner Dashboard의 "Beta Programs"에서 신청하세요.

Catalog API (신규)​

Catalog API는 AI 에이전트와 외부 시스템이 구조화된 머신 리더블 포맷으로 스토어의 제품 카탈로그와 상호작용할 수 있게 합니다.

주요 기능:

  • AI 소비에 최적화된 구조화된 제품 데이터
  • 제품 속성 전반에 걸친 시맨틱 검색
  • 실시간 정확도를 가진 가격 및 재고 쿼리
  • 제품 비교 및 추천 지원
  • 다국어 및 다중 통화 지원

중요한 이유: 기존 제품 API는 인간이 구축한 프론트엔드를 위한 데이터를 반환합니다. Catalog API는 AI 에이전트가 이해하고 추론할 수 있는 구조화된 데이터를 반환합니다.

# Catalog API: semantic product search
query {
  catalog {
    productSearch(
      query: "comfortable running shoes for flat feet under $150"
      semanticMatch: true
      limit: 10
    ) {
      results {
        product {
          id
          title
          semanticDescription
          priceRange { minVariantPrice { amount currencyCode } }
          attributes { key value confidence }
        }
        relevanceScore
      }
    }
  }
}

AI 에이전트용 Checkout Kit​

AI 쇼핑 에이전트가 소비자를 대신하여 구매를 완료할 수 있는 새로운 SDK.

구성요소:

  • 에이전트 인증 -- 사용자를 대신하는 AI 에이전트의 보안 신원 확인
  • 카트 조립 -- 에이전트 최적화된 검증이 포함된 프로그래매틱 카트 생성
  • 결제 위임 -- 에이전트가 카드 정보를 보지 않고 사용할 수 있는 토큰화된 결제 수단
  • 동의 프레임워크 -- 에이전트 발의 구매 전 사용자 승인 플로우

개발자 영향: AI 쇼핑 어시스턴트, 챗봇, 또는 음성 커머스를 구축하는 경우, 이것이 주요 통합 포인트입니다.

SimGym​

실제 데이터에 영향을 주거나 실제 결제를 트리거하지 않고 AI 에이전트와 Shopify 스토어의 상호작용을 테스트하기 위한 시뮬레이션 환경.

기능:

  • 에이전트 테스트를 위한 샌드박스 스토어 복제본
  • 시뮬레이션된 결제 처리
  • 구성 가능한 재고, 가격, 배송 시나리오
  • 에이전트 의사결정의 성능 벤치마킹
  • 에이전트 전략의 A/B 테스트

사용 사례:

  • 실제 스토어에 연결하기 전에 AI 쇼핑 에이전트 테스트
  • 다양한 스토어 구성에서 에이전트 성능 벤치마크
  • 시뮬레이션된 전자상거래 상호작용에서 커스텀 모델 트레이닝

Tinker App​

AI 기반 스토어 기능을 관리자 화면에서 직접 프로토타입 및 실험하기 위한 새로운 Shopify App.

기능:

  • Sidekick Extensions의 비주얼 프롬프트 빌더
  • 스토어의 실시간 데이터로 AI 에이전트 상호작용 테스트
  • AI 생성 제품 설명이 테마에서 어떻게 보이는지 미리보기
  • 동적 가격 알고리즘 실험
  • 커스텀 추천 엔진 프로토타입

개발자 플랫폼​

Shopify Dev MCP Server​

AI 지원 Shopify 개발을 위한 공식 MCP Server. 상세 가이드를 참조하세요.

Winter '26 추가 사항:

  • 전체 API 2026-01 스키마 지원
  • JavaScript 및 Rust Shopify Functions 스캐폴딩
  • Checkout Extension 문서 및 예제
  • 검색 관련성 및 응답 품질 개선
  • 쿼리 검증을 위한 새로운 validate_graphql 도구

Shopify Functions (일반 제공)​

Shopify Functions가 개발자 프리뷰에서 **일반 제공(GA)**으로 이동 (Winter '26).

지원되는 Function API:

Function 타입용도상태
Delivery Customization커스텀 배송비 및 옵션GA
Payment Customization커스텀 결제 수단 필터링GA
Discount커스텀 할인 로직GA
Cart Transform카트 내용 변경 (번들, 선물)GA
Fulfillment Constraints이행 옵션 제한GA
Order Routing Location Rule커스텀 이행 라우팅GA
Validation커스텀 체크아웃 검증GA
Gate토큰 게이트 커머스GA

Winter '26의 새로운 기능:

  • Rust와 함께 JavaScript 지원 (Javy 런타임)
  • 증가된 실행 제한 -- 5MB 메모리, 10ms 실행 시간
  • 외부 API 호출을 위한 네트워크 액세스 (제한적)
  • Function 입력에서 Metafield 읽기 액세스를 통한 영속 스토리지
  • shopify app function test를 사용한 테스트 프레임워크
// Example: Delivery Customization Function (JavaScript)
// @ts-check
import { DeliveryCustomization } from "@shopify/shopify-functions";

export default function deliveryCustomization(input) {
  const operations = [];

  // Block express shipping for oversized items
  for (const delivery of input.cart.deliveryGroups) {
    for (const option of delivery.deliveryOptions) {
      const hasOversizedItem = input.cart.lines.some(line =>
        line.merchandise?.product?.hasTag("oversized")
      );

      if (hasOversizedItem && option.title.includes("Express")) {
        operations.push({
          hide: { deliveryOptionHandle: option.handle }
        });
      }
    }
  }

  return { operations };
}

테마 에디터 대개편​

온라인 스토어 에디터가 대폭 리디자인되었습니다:

  • 실시간 협업 편집 -- 여러 팀원이 동시에 테마 편집 가능
  • 버전 히스토리 -- diff 뷰와 롤백이 포함된 전체 변경 이력
  • AI 지원 콘텐츠 -- 에디터에서 섹션 콘텐츠, alt 텍스트, 카피 생성
  • 컴포넌트 라이브러리 -- 드래그 앤 드롭 프리빌트 컴포넌트 (히어로 섹션, 제품 그리드 등)
  • 성능 예산 -- 편집 중 실시간 성능 스코어링

개발자 대시보드​

Shopify App 개발자를 위한 새로운 중앙 집중식 대시보드:

  • API 사용 분석 -- API 호출 볼륨, 오류율, 지연 시간의 실시간 모니터링
  • Webhook 안정성 -- 토픽별 Webhook 전달 성공률 추적
  • App 성능 -- 로딩 시간, 오류율, 상인 만족도 메트릭
  • 수익 분석 -- MRR, 이탈, 설치/제거 트렌드
  • 규정 준수 상태 -- GDPR, 데이터 접근, 보안 요구사항 추적

Tangle (내부 프레임워크, 이제 문서화)​

Shopify가 복잡하고 타입 안전한 GraphQL API를 구축하기 위한 내부 프레임워크인 Tangle을 공개 문서화했습니다. 외부 개발자가 직접 사용할 수는 없지만, Tangle을 이해하면 Shopify의 API를 더 효과적으로 사용할 수 있습니다.

핵심 개념:

  • 모든 Shopify GraphQL 타입은 Tangle 모델에 의해 지원됨
  • Mutation은 일관된 패턴을 따름: input → model → output + userErrors
  • Connection (페이지네이션)이 모든 타입에 걸쳐 표준화
  • 접근 스코프가 Tangle 인가 규칙에 직접 매핑

OAuth 자격 증명 업그레이드​

Shopify의 OAuth 시스템이 크게 개선되었습니다:

  • Proof Key for Code Exchange (PKCE) -- 모든 새 App에 필수
  • 로테이션 Refresh Token -- 보안 강화를 위한 자동 토큰 로테이션
  • 스코프 지정 Access Token -- 세션별로 필요한 스코프만 요청
  • Token 인트로스펙션 엔드포인트 -- 스토어 왕복 없이 토큰 유효성 검증
  • 오프라인/온라인 Token 명확화 -- 토큰 유형에 대한 더 나은 문서화 및 도구

API 버전 2026-01​

2026년 첫 번째 API 버전이 가져오는 것:

새로운 타입과 필드:

  • CatalogProduct -- AI 에이전트에 최적화된 제품 표현
  • SidekickExtension -- Sidekick Extensions 등록 및 관리
  • FunctionRunResult -- 개선된 Function 실행 결과 타입
  • CheckoutBranding -- 확장된 체크아웃 커스터마이징 옵션

2025-10에서의 브레이킹 체인지:

  • Product.images 지원 중단, Product.media 사용
  • Order.shippingLine이 Order.shippingLines (복수형)로 이동
  • orders/create 및 orders/update의 Webhook 페이로드 포맷 변경
  • InventoryLevel.available 지원 중단, InventoryLevel.quantities 사용

지원 중단:

  • REST Admin API 제품 이미지 엔드포인트 (GraphQL productMedia mutation 사용)
  • ScriptTag 리소스 (WebPixel로 대체)
  • 레거시 체크아웃 커스터마이징 (Checkout UI Extensions 사용)
API 마이그레이션 타임라인
  • 2026-01 2026년 1월 출시
  • 2025-04 2026년 4월 종료 예정
  • 2025-07 2026년 7월 종료 예정

2025-04 또는 그 이전 버전을 사용 중이라면, 지금 마이그레이션을 시작하세요.

스토어 및 테마​

Rollouts​

테마 변경을 위한 새로운 배포 기능:

  • 단계적 롤아웃 -- 테마 변경을 먼저 트래픽의 일정 비율에 배포
  • 자동 롤백 -- 오류율이 급증하면 변경이 자동으로 되돌려짐
  • A/B 테스트 통합 -- 전환 메트릭에 대해 테마 버전 비교
  • 예약 배포 -- 특정 날짜/시간에 테마 변경 큐잉

제품당 2,048개 배리언트​

배리언트 제한이 100에서 제품당 2,048개로 증가.

개발자 영향:

  • 제품 폼과 배리언트 셀렉터가 더 큰 옵션 매트릭스를 처리해야 함
  • 재고 관리 UI에 배리언트 목록의 페이지네이션 필요
  • 배리언트의 GraphQL 쿼리는 커서 페이지네이션이 있는 Connection 사용
  • 배리언트별 Metafield 관리에 벌크 오퍼레이션 패턴 필요
# Paginating through variants of a high-variant-count product
query {
  product(id: "gid://shopify/Product/123") {
    variants(first: 50, after: "cursor") {
      edges {
        node {
          id
          title
          price
          inventoryQuantity
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
}

비공개 제품​

제품을 이제 비공개로 표시 가능 -- 직접 링크로 접근 가능하지만 검색, 컬렉션, 사이트맵에는 표시되지 않음.

사용 사례:

  • 특정 고객 세그먼트를 위한 독점 제품
  • 인플루언서와 공유하는 사전 출시 페이지
  • 커스텀 포털을 통해서만 접근 가능한 B2B 제품
  • 한정 배포의 이벤트 전용 상품

API:

mutation {
  productUpdate(input: {
    id: "gid://shopify/Product/123"
    status: ACTIVE
    publishedScope: UNLISTED
  }) {
    product { id status }
    userErrors { field message }
  }
}

모바일 테마 생성기​

기존 데스크톱 테마에서 모바일 최적화된 테마 변형을 생성하는 AI 기반 도구:

  • 작은 화면을 위한 자동 레이아웃 조정
  • 터치 타겟 크기 최적화
  • 이미지 리사이징 및 아트 디렉션
  • 내비게이션 간소화
  • 모바일 네트워크를 위한 성능 최적화

커머스 및 결제​

Product Network​

스토어가 Shopify 상인 네트워크 전체에서 제품 카탈로그를 공유할 수 있는 새로운 B2B 기능:

  • 공급자가 네트워크에 제품 게시
  • 소매상이 제품을 탐색하고 자신의 스토어에 추가 가능
  • 네트워크 전체에서 실시간 재고 동기화
  • 공급자가 설정하는 가격 및 마진 규칙
  • 공급자가 처리하는 이행 (드롭십 모델)

개발자 영향: 네트워크 관리, 카탈로그 공유, 스토어 간 운영을 위한 새로운 API 엔드포인트.

ACH 결제​

**ACH (자동 청산소)**결제가 Shopify Payments를 통해 지원:

  • 신용카드보다 낮은 거래 수수료 (0.5% vs 2.9%)
  • B2B 상인이 은행 간 결제 수락 가능
  • 구독을 위한 반복 결제 지원
  • 3-5 영업일 정산

POS 대개편​

Shopify POS가 대폭 업데이트:

  • 통합 API -- POS와 온라인 스토어가 재고, 주문, 고객에 동일한 API 사용
  • POS UI Extensions -- 온라인 체크아웃과 동일한 Extension 프레임워크로 커스텀 POS 경험 구축
  • Tap to Pay -- iPhone 및 Android 기기에서 NFC 결제
  • 직원 권한 API -- POS 직원 역할 및 권한의 프로그래매틱 관리

Uber Direct 통합​

당일 지역 배송을 위한 Uber Direct와의 네이티브 통합:

  • 체크아웃 시 실시간 배송 견적
  • 주문 이행 시 자동 드라이버 배차
  • 상인과 고객을 위한 실시간 추적
  • 커스텀 배송 워크플로우 통합 API

인프라​

Oxygen V2​

Hydrogen 스토어프론트용 Shopify의 호스팅 플랫폼이 대폭 업그레이드:

  • Edge 컴퓨트 -- 300개 이상의 글로벌 엣지 위치에서 서버 사이드 렌더링
  • 스트리밍 SSR -- 더 빠른 TTFB를 위한 React Server Components와 스트리밍
  • 자동 스케일링 -- 0에서 수백만 요청까지 자동 스케일링
  • 환경 브랜치 -- 모든 Git 브랜치의 프리뷰 배포
  • 로그 스트리밍 -- 모니터링 플랫폼으로의 실시간 로그 출력

Webhook 안정성 개선​

  • 구성 가능한 재시도 정책 (최대 72시간)을 통한 보장된 전달
  • 데드 레터 큐 -- 실패한 Webhook을 수동 검사용으로 저장
  • 개발자 대시보드의 전달 메트릭
  • Webhook 버저닝 -- 페이로드 포맷이 API 버전에 고정
  • GraphQL을 통한 벌크 Webhook 관리

GraphQL 비용 개선​

  • 일반적인 쿼리 (products, orders, customers)의 비용 감소
  • 병렬 쿼리 실행 -- 단일 요청에서 여러 독립적인 쿼리
  • 쿼리 복잡도 추정기 -- 실행 전 비용 확인을 위한 새 API 엔드포인트
  • 버스트 레이트 증가 -- Shopify Plus 스토어의 더 높은 버스트 제한

마이그레이션 체크리스트​

Winter '26에 맞춰 App을 업데이트하는 개발자용:

높은 우선순위​

  • API 버전 2026-01로 업데이트
  • Product.images에서 Product.media로 마이그레이션
  • Order.shippingLine을 Order.shippingLines로 업데이트
  • OAuth 플로우에 PKCE 구현
  • UI에서 2,048 배리언트 제품 처리

중간 우선순위​

  • App 카테고리에 맞는 Sidekick Extensions 탐색
  • AI 에이전트 호환성을 위해 Catalog API 테스트
  • 새로운 페이로드 포맷에 맞춰 Webhook 처리 업데이트
  • 해당하는 경우 ScriptTag을 WebPixel로 마이그레이션

낮은 우선순위 (하지만 탐색할 가치 있음)​

  • 현재 App 서버에 있는 커스텀 로직에 Shopify Functions 평가
  • SimGym에서 App의 에이전트 호환성 테스트
  • 모니터링을 위한 개발자 대시보드 설정
  • 모바일 테마 생성기 실험

타임라인​

날짜이벤트
2026년 1월 15일Winter '26 에디션 발표
2026년 1월 15일API 2026-01 출시
2026년 2월 1일Sidekick Extensions 개발자 프리뷰 시작
2026년 3월 1일Catalog API 퍼블릭 베타
2026년 4월 1일API 2025-04 종료
2026년 4월 15일Functions JavaScript 런타임 GA
2026년 6월Summer '26 에디션 (예정)

리소스​