> ## 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.

# requestExport

API reference for the requestExport method.

Exports the user's design as one or more static files.

## Parameters

<Prop.List>
  <Prop name="request" required type="ExportRequest" sourceLineNumbers={[5146]}>
    The request object containing configurations of the design export.

    <PillAccordion defaultExpanded={true} title={<>Properties of <strong>request</strong></>}>
      <Prop.List>
        <Prop name="acceptedFileTypes" required type="object[]" sourceLineNumbers={[3795]}>
          The types of files the user can export their design as.

          You must provide at least one file type.

          <Tabs>
            <Tab name="ExportFileType">
              The types of files that Canva supports for exported designs.

              <Prop.Extras>
                **Available values**:

                * `"png"`
                * `"jpg"`
                * `"pdf_standard"`
                * `"video"`
                * `"gif"`
                * `"pptx"`
                * `"svg"`
              </Prop.Extras>
            </Tab>

            <Tab name="ExportFileTypeWithProperties">
              Object representation of the supported file types with properties where applicable.

              <Tabs>
                <Tab name="ExportImageFileType">
                  Supported image file types with properties.

                  Zip behavior for image file types:

                  * `auto` (default): Files are zipped together if the design has multiple pages, unzipped if it has one page.
                  * `always`: Files are always zipped into a single zip file, regardless of page count.
                  * `never`: Files are never zipped, providing an array of files.

                  <Prop.List>
                    <Prop name="type" required type="string" sourceLineNumbers={[3772]}>
                      <Prop.Extras>
                        **Available values**:

                        * `"png"`
                        * `"jpg"`
                        * `"svg"`
                      </Prop.Extras>
                    </Prop>

                    <Prop name="zipped" type="ZipBehavior" sourceLineNumbers={[3773]}>
                      The behavior of zipping the exported files.

                      <Prop.Extras>
                        **Available values**:

                        * `"auto"`
                        * `"always"`
                        * `"never"`
                      </Prop.Extras>
                    </Prop>
                  </Prop.List>
                </Tab>

                <Tab name="ExportVideoFileType">
                  Supported video file types with properties.

                  Zip behavior for video file types:

                  * `auto` (default): Files are not zipped together unless the 'Downloading pages as separate files' option is selected in the export panel.
                  * `always`: Files are always zipped into a single file.
                  * `never`: Files are never zipped. NOTE: The `Download pages as separate files` option is not shown in the export panel when `never` is passed.

                  <Prop.List>
                    <Prop name="type" required type="string" sourceLineNumbers={[3815]}>
                      <Prop.Extras>
                        **Available values**:

                        * `"gif"`
                        * `"video"`
                      </Prop.Extras>
                    </Prop>

                    <Prop name="zipped" type="ZipBehavior" sourceLineNumbers={[3816]}>
                      The behavior of zipping the exported files.

                      <Prop.Extras>
                        **Available values**:

                        * `"auto"`
                        * `"always"`
                        * `"never"`
                      </Prop.Extras>
                    </Prop>
                  </Prop.List>
                </Tab>

                <Tab name="ExportPrintFileType">
                  Supported print file types.

                  <Prop.List>
                    <Prop name="type" required type="string" sourceLineNumbers={[3781]}>
                      <Prop.Extras>
                        **Available values**:

                        * `"pdf_standard"`
                        * `"pptx"`
                      </Prop.Extras>
                    </Prop>
                  </Prop.List>
                </Tab>
              </Tabs>
            </Tab>
          </Tabs>
        </Prop>
      </Prop.List>
    </PillAccordion>
  </Prop>
</Prop.List>

## Returns

The result of exporting a design. This is a `Promise` that resolves with the following object:

<Tabs>
  <Tab name="Completed">
    The result when a user successfully completes an export flow.

    <Prop.List>
      <Prop name="status" required type="string" sourceLineNumbers={[3735]}>
        The status of the export flow.

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

      <Prop name="exportBlobs" required type="ExportBlob[]" sourceLineNumbers={[3746]}>
        The exported files.

        This array can contain a single link either to a file or a ZIP, or multiple links to individual files.

        <PillAccordion defaultExpanded={false} title={<>Properties of <strong>exportBlobs</strong></>}>
          <Prop.List>
            <Prop name="url" required type="string" sourceLineNumbers={[3724]}>
              The URL of the exported design.

              If a user's design contains multiple pages but is exported in a format that doesn't support multiple pages,
              by default this URL will point to a ZIP file that contains each page as a separate file.

              If the user has configured the export to not zip the exported files (using the `zipped` property), this URL will point to a single file.

              For example:

              * If a single-page design is exported as a JPG, the URL will point to a JPG file.
              * If a multi-page design is exported as a JPG, the URL will point to a ZIP file that contains a JPG file for each page.
              * If a multi-page design is exported as a JPG and the user has set `zipped` to `never` for JPGs, the URL will point to a JPG file and will be one of multiple urls in the exportBlobs array.
              * If a multi-page design is exported as a PDF file, the URL will point to a PDF file.
              * If a multi-page design is exported as a VIDEO file and the user has set `zipped` to `always` for VIDEOs, the URL will point to a ZIP that contains a VIDEO file.

              The following file types support multiple pages:

              * `"GIF"`
              * `"PDF_STANDARD"`
              * `"PPTX"`
              * `"VIDEO"`

              The following file types do not support multiple pages:

              * `"JPG"`
              * `"PNG"`
              * `"SVG"`
            </Prop>
          </Prop.List>
        </PillAccordion>
      </Prop>

      <Prop name="title" type="string" sourceLineNumbers={[3739]}>
        The title of the design, if set by the user.
      </Prop>
    </Prop.List>
  </Tab>

  <Tab name="Aborted">
    The result when a user abandons the export flow, such as by closing the export menu.

    <Prop.List>
      <Prop name="status" required type="string" sourceLineNumbers={[3686]}>
        The status of the export flow.

        The only valid value is `"aborted"`.
      </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/).

## Rate limit

This method has a rate limit of 10 requests every 10 seconds.