About Shopify Functions

Function extension targets inject code into the backend logic of Shopify. The following diagram shows how Shopify invokes a function which has been configured for an extension target:

• Function input: The function input is a JSON object which is the result of a GraphQL input query you define. Input queries allow you to select the specific data you need for your function, such as cart line product data or metafields.

• Function logic: The function logic is written in any language that can compile a WebAssembly module which meets function requirements. Function templates and client libraries are available for Rust and JavaScript.

• Function output: The function output is a JSON document that describes the operations you'd like Shopify to carry out.

GraphQL schemas provided by Shopify specify the targets, available inputs, and expected outputs for a Functions API.

The following diagram shows an example lifecycle of a Shopify Function:

• App developers create and deploy apps that contain functions.

• Merchants install the app on their Shopify store and configure the function. An API call is made with the function configuration.

• Customers interact with a Shopify store and Shopify executes the function.

For example, an app developer might create and deploy an app with a function that defines a new discount type. The merchant can then install the app on their Shopify store and create a new discount from a discount type provided by the app. Shopify executes the function to calculate the discount when a customer adds a product to their cart.

Shopify Functions are never invoked directly by URL or otherwise. Shopify invokes them as-needed within the customer journey.

Learn how to use Shopify Functions by following one of our use case tutorials:

Build a discount function

Use Shopify Functions to create a new discount type for users.

Create a payments function

Use Shopify Functions to hide a payment option offered to customers at checkout.

Build a delivery options function

Use Shopify Functions to rename a delivery option offered to customers at checkout.

Create server-side validation

Use Shopify Functions to block progress on a checkout when the cart line quantities exceed a limit.

Build a location rule function

Use Shopify Functions to choose a different order location during checkout.

Add a customized bundle

Use Shopify Functions to group products together and sell them as a single unit.

Build fulfillment constraints

Use Shopify Functions to customize fulfillment and delivery strategies.

Build local pickup options

Use Shopify Functions to generate local pickup delivery options at checkout.

Generate pickup points

Use Shopify Functions to generate pickup point delivery options at checkout.

Explore the developer tools and resources available for Shopify Functions.

Shopify Function APIs reference

Learn about the available APIs for Shopify Functions.

Language support

Learn about the language support and tooling that are available in Shopify Functions.

Function APIs are versioned. Updates are released quarterly and supported API versions are listed in the release notes.

Learn how to update to a new version of a Function API.

The following limitations and considerations apply to all functions:

• Apps can reference only their own functions in GraphQL Admin API mutations, such as discountAutomaticAppCreate and cartTransformCreate. Referencing a function from another app results in a Function not found error.
• Shopify doesn't allow nondeterminism in functions, which means that you can't use any randomizing or clock functionality in your functions.
• You can't debug your function by printing out STDOUT, which is reserved for function output. Use STDERR instead.
• Apps that provide dynamic editing and execution of function code aren't permitted on the Shopify App Store.
• Network access is supported for some functions, refer to network access for more information. You can also pre-populate data by using metafields on products and customers, or passing data using cart attributes.

The following resource limits apply to all functions:

Certain limits are dynamic and scale based on the number of line items in a cart. The following resource limits apply to all functions for carts with up to 200 line items:

For carts with more than 200 line items, these values will scale proportionally as the number of cart lines increases. Calculated limits for a function execution are available in your Partner Dashboard and can be tested with Shopify CLI.

To delete a Shopify Function, you need to remove the relevant files from your app's /extensions directory, and then redeploy your app. Learn more about removing a Shopify Function.

When you delete a function, the following behavior occurs:

• The function, including all associated function owners, is permanently deleted.
• The function no longer runs, and becomes inaccessible to any Shopify stores that have your app installed.

• Learn about how data is input to and output from Shopify Functions.
• Explore the references for each Function API.