---
title: Loading API
description: >-
  The Loading API lets you display a loading indicator in the Shopify admin
  header. Use this to signal that a page is loading, data is being fetched, or
  an upload is processing.
api_version: 2026-07-rc
source_url:
  html: >-
    https://shopify.dev/docs/api/app-home-ui-extension/latest/target-apis/utility-apis/loading-api
  md: >-
    https://shopify.dev/docs/api/app-home-ui-extension/latest/target-apis/utility-apis/loading-api.md
---

# Loading API

The Loading API lets you display a loading indicator in the Shopify admin header. App Home UI extensions control it through `shopify.loading` on the [`shopify` global object](https://shopify.dev/docs/api/app-home-ui-extension/latest#apis-define-what-your-extension-does). Use this to signal that a page is loading, data is being fetched, or an upload is processing. The indicator appears at the top of the admin and persists until you explicitly stop it.

### Use cases

* **Page transitions:** Show a loading indicator in the Shopify admin during page transitions or route changes.
* **Data loading:** Indicate data is being fetched from the Shopify API.
* **Async operations:** Provide visual feedback during any asynchronous operation that takes time.

### Inputs

Options to configure the Admin page-level loading indicator.

* **isLoading**

  **boolean**

  Pass `true` to show the loading indicator, `false` to hide it.

Examples

### Examples

* ####

  ##### Description

  Toggle loading state. This example starts the loading indicator before an async operation and stops it when complete.

  ##### js

  ```js
  shopify.loading(true);
  // ...
  shopify.loading(false);
  ```

***