> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/docs/apps/llms.txt
> Use this file to discover all available pages before exploring further.

# getCurrentPageMetadata

API reference for the getCurrentPageMetadata method.

Retrieves metadata for the page the user is currently on in the design.

## Returns

Information about a page within a design. This is a `Promise` that resolves with the following object:

<Tabs>
  <Tab name="AbsolutePageMetadata">
    Information about a page within a design with fixed or unbounded dimensions.

    <Prop.List>
      <Prop name="type" required type="string" sourceLineNumbers={[9]}>
        The type of page.

        The only valid value is `"absolute"`.
      </Prop>

      <Prop name="id" type="PageId" sourceLineNumbers={[13]}>
        Stable identifier for this page within the design.
      </Prop>

      <Prop name="dimensions" type="PageDimensions" sourceLineNumbers={[20]}>
        The dimensions of the page, in pixels.

        This may be `undefined` because some types of pages don't have dimensions, such as whiteboards.

        <PillAccordion defaultExpanded={false} title={<>Properties of <strong>dimensions</strong></>}>
          <Prop.List>
            <Prop name="width" required type="number" sourceLineNumbers={[4887]}>
              The width of the page, in pixels.
            </Prop>

            <Prop name="height" required type="number" sourceLineNumbers={[4891]}>
              The height of the page, in pixels.
            </Prop>
          </Prop.List>
        </PillAccordion>
      </Prop>

      <Prop name="title" type="string" sourceLineNumbers={[26]}>
        The name of the page.

        This is optional and will be empty if the user hasn't set a title.
      </Prop>
    </Prop.List>
  </Tab>

  <Tab name="UnsupportedPageMetadata">
    Pages that do not have fixed or unbounded dimensions currently do not return metadata.

    <Prop.List>
      <Prop name="type" required type="string" sourceLineNumbers={[6279]}>
        The type of page.

        The only valid value is `"unsupported"`.
      </Prop>
    </Prop.List>
  </Tab>
</Tabs>

## Permissions

To use this method, the `canva:design:content:read` permission must be enabled for the app. To learn more, see [Permissions](https://www.canva.dev/docs/apps/configuring-intents-permissions/).