---
title: New reference documentation for Shopify Function APIs - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/new-reference-documentation-for-shopify-function-apis
  md: https://shopify.dev/changelog/new-reference-documentation-for-shopify-function-apis.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

May 21, 2025

Tags:

* Functions

# 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](https://cdn.shopify.com/s/files/1/0262/2383/7206/files/functions-overview.png?v=1747772969)

## 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](https://cdn.shopify.com/s/files/1/0262/2383/7206/files/examples_metrics_explorer.png?v=1747772969) ![Visual Illustration of Function APIs](https://cdn.shopify.com/s/files/1/0262/2383/7206/files/visual-functions.png?v=1747772969)

## 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](https://cdn.shopify.com/s/files/1/0262/2383/7206/files/version-picker.png?v=1747772969)

## 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](https://shopify.dev/docs/api/functions)—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.