> ## 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. # Data Connector intent implementation guide Import data from external sources into Canva. This guide helps you implement the [Data Connector intent](https://www.canva.dev/docs/apps/intents/data-connector/) to import data from external sources into Canva. ## Quickstart To get a Data Connector up and running as quickly as possible, we recommend scaffolding a project with the [Canva CLI](https://www.canva.dev/docs/apps/canva-cli/) and using the Data Connector template: ```bash canva apps create my-data-connector --template data_connector ``` This template includes all of the essential boilerplate code to get started. You can also view a complete working example of a data connector in the [starter kit for apps inside Canva](https://github.com/canva-sdks/canva-apps-sdk-starter-kit/tree/main/examples/intents/data_connector_intent). This example is deliberately simpler than the CLI template, making it ideal for understanding the core concepts before building more complex implementations. ## Creating a Data Connector ### Step 1: Enable the intent Before an intent can be implemented, it must be enabled. Enabling an intent informs Canva of when and where the app should be invoked throughout the user experience. You can configure intents for your app with either the Developer Portal or the Canva CLI: 1. Navigate to an app via the [Your apps](https://www.canva.com/developers/apps) page. 2. Go to **Inside Canva**. If the app already has an intent, select **Intents** beneath it. 3. Under **Available intents**, find the "Data Connector" intent and click **Set up**. 4. In the **Set up Data Connector** dialog, click **Add Data Connector**. The following sections in this guide will walk you through implementing the intent in your code. 1. Set up your app to use the Canva CLI to manage settings via the [canva-app.json](https://www.canva.dev/docs/apps/app-configuration/#manage-configuration-using-the-canva-cli) file. 2. Set the `intent.data_connector` property to be enrolled. For more information, see [canva-app.json](https://www.canva.dev/docs/apps/app-configuration/canva-app-json/#intent-optional). For example, the following enables the Data Connector intent. ```json { "intent": { "data_connector": { "enrolled": true } } } ``` ### Step 2: Enable the required permissions In the Canva Developers SDK, certain methods require certain permissions to be enabled. If an app attempts to call methods without the required permissions being enabled, the SDK will throw an error. The Data Connector intent requires the following permissions: * **Design read (`canva:design:content:read`)** * **Design write (`canva:design:content:write`)** To learn more, see [Permissions](https://www.canva.dev/docs/apps/configuring-intents-permissions/). ### Step 3: Register the intent Before an intent can be implemented, it must be registered. Registering the Data Connector intent establishes how data is fetched and what UI to display for selecting and filtering data. To register the intent, call the `prepareDataConnector` method as soon as the app loads: ```tsx import { prepareDataConnector } from "@canva/intents/data"; // Register the data connector when your app loads prepareDataConnector({ getDataTable: async (request) => { // Return the data table based on the data source reference return { status: "completed", dataTable: { rows: [], }, }; }, renderSelectionUi: (request) => { // Render your selection UI here console.log("Rendering selection UI"); }, }); ``` **Note:** Intents must only be registered once. To learn more, see [Technical requirements](https://www.canva.dev/docs/apps/intents/#technical-requirements). ### Step 4: Render the data selection UI When a user initiates a data import flow, the intent must render a UI that allows the user to select and filter the data that will be imported. To accomplish this, use the `renderSelectionUi` method: ```tsx import React, { useState } from "react"; import { createRoot } from "react-dom/client"; import { AppI18nProvider } from "@canva/app-i18n-kit"; import { AppUiProvider, Rows, Select, FormField, Button, } from "@canva/app-ui-kit"; import { prepareDataConnector, type RenderSelectionUiRequest, } from "@canva/intents/data"; const categories = [ { value: "electronics", label: "Electronics" }, { value: "clothing", label: "Clothing" }, { value: "food", label: "Food" }, ]; function SelectionUI({ updateDataRef, limit }: RenderSelectionUiRequest) { const [selectedCategory, setSelectedCategory] = useState(""); const [isLoading, setIsLoading] = useState(false); const handleImportData = async () => { setIsLoading(true); await updateDataRef({ source: selectedCategory, title: `${selectedCategory} Products`, }); setIsLoading(false); }; return ( (