---
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: v1.0
source_url:
  html: >-
    https://shopify.dev/docs/api/app-home/latest/apis/user-interface-and-interactions/loading-api
  md: >-
    https://shopify.dev/docs/api/app-home/latest/apis/user-interface-and-interactions/loading-api.md
api_name: app-home
---

# Loading API

**Info:**

App Bridge isn't versioned with Polaris. App Bridge APIs and web components are identical in every App Home reference version.

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. 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 your backend or the Shopify API.
* **Upload processing:** Signal to merchants that an upload is being processed.
* **Async operations:** Provide visual feedback during any asynchronous operation that takes time.

### Inputs

The `loading` function controls the loading indicator in the Shopify admin header. The indicator persists until it's explicitly stopped.

* **is​Loading**

  **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);
  ```

***