Skip to main content

New reference documentation for Shopify Function APIs

We've completely revamped our highly-visited and least-loved Shopify Function API reference docs. You’ve shared many helpful comments and questions through our Was this page helpful? form, and we’ve reviewed and addressed them in this latest revision.

Here’s the lowdown on the latest updates.

One comprehensive overview

We’ve added a single, consolidated overview that outlines the foundational information you need before diving into any specific Function API. No more feeling lost right from the start!

Overview

A dedicated page for each Function API

Each Function API now has its own dedicated page, meaning you’ll no longer need to jump between various pages to find the information you need. This streamlined approach helps you to understand the API, its targets, data structures, and common use cases.

And what can you expect on each page?

  • End-to-end examples for every Function API, demonstrating complete implementation patterns tailored to common merchant scenarios.
  • Interactive object exploration to help you dive deep into GraphQL objects—all in one convenient location.
  • Visual diagrams that clearly illustrate how each Function operates within the Shopify ecosystem, making complex concepts easier to grasp.
  • Performance metrics that show execution costs for each Function API, helping you to optimize your integrations efficiently.

E2E Examples, Performance metrics, GQL explorer Visual Illustration of Function APIs

A version picker for easy navigation

We’ve introduced a centralized version picker that allows you to toggle between different API versions easily, right from the sidebar.

Version Picker

Give it a try!

These updates are all about making your life easier. Less time scratching your head or making guesses means more time building amazing things!

Explore the revamped docs—we'd love to know what you think. Where have these updates helped, and where else in the Function API docs would you like to see improvements? You can leave comments by clicking the Was this page helpful? button.

Was this section helpful?