---
title: "Subscribe to page layout changes"
slug: "subscribe-to-page-layout-changes"
abstract: "How to receive real-time updates when the page layout changes."
---
# Subscribe to page layout changes

*Required extension points: any SitecoreAI Page Builder extension point*

*Required SDK packages: client*

*Required API access: none*

> [!note]
> **Before you begin**
> -   Complete the [SDK quick start](https://doc.sitecore.com/mp/en/developers/sdk/0/sitecore-marketplace-sdk/quick-start--manual-.html "Quick start (manual)"). In the quick start, you make your first query by running `client.query("application.context")`.

If your app uses any of the SitecoreAI Page Builder extension points, you can subscribe to page layout changes. A layout change occurs when, for example, the SitecoreAI user adds, moves, or removes a component, or configures the layout properties of a component.

To subscribe to layout changes:

1. In the SDK initialization code where you run the `useMarketplaceClient` hook, at the top level of the Effect Hook, create a variable:

    ```typescript
    let unsubscribeLayout: (() => void) | undefined;
    ```

2. In the Effect Hook, below the `"application.context"` query, create a subscription:

    ```typescript
    unsubscribeLayout = client.subscribe("pages.content.layoutUpdated", {
      onData: (data) => {
        /* Example data:
        {
          itemId: string,
          language: string,
          itemVersion: number,
          layout: {
            type: "FINAL" | "SHARED",
          }
        }
        */
        console.log("Layout updated:", data);
      },
      onError: (err) => {
        console.error("Layout subscription error:", err);
      }
    });
    ```

3. In the Effect Hook's callback function, add a return statement as the last statement to clean up subscriptions, then save your changes:

    ```typescript
    return () => {
      unsubscribeLayout?.();
    }
    ```

    > [!important]
    > Always clean up subscriptions to prevent memory leaks.

4. In the SitecoreAI Page Builder, open your web browser's console, refresh the page, then open your Marketplace app.
5. In the console, filter your logs for `Layout updated`.
6. Make a layout change. For example, on the **Components** tab, select a component and drag it to a location on the page canvas. A new log appears in the console, containing the details of the layout change.