For the complete documentation index, see llms.txt. This page is also available as Markdown.

Preorders API

Before diving into the API reference, it's important to understand the key term we use - Selling Plans

What are Selling Plans?

Selling Plans in the context of preorders are configurations that define how a preorder product is sold, billed, and delivered to customers.

Core Purpose:

  • Enable merchants to sell products before they're in stock or available for immediate shipping

  • Define payment schedules, delivery timelines, and inventory management for preordered items

  • Provide customization options for how preorders appear and function in the storefront

What data is present in a Selling Plan?

  • Basic Information: Name, internal reference name, enabled status

  • Billing Configuration: When and how much to charge (at checkout or later), charge types (percentage or fixed amount)

  • Delivery Settings: When products will be delivered (exact date or interval after purchase)

  • Inventory Management: How inventory is reserved and which system manages it

  • Pricing Options: Discount amounts or percentages for preordered items

  • UI Customization: Button text, badge styling, shipping information text

Variant Association:

  • Selling plans can be associated with product variants in three ways:

    • All products in the store

    • Products in a specific collection

    • Custom selection of individual variants

  • Each variant can have custom settings like shipping text and maximum preorder quantity

Multi-Market Support:

  • Selling plans can be configured for specific markets in multi-market stores

  • Different markets may have different preorder terms or availability

Last updated