* Prerequisite:
You must have a paid Bubble application plan. The Bubble Data API, required by this plugin, is only available on paid plans.

A. Setting up Your Bubble App:

i) Prepare Data Type: Go to the Data tab -> Data types. Define the Bubble Data Type (e.g., Contacts, Products) where you want to import data. Ensure all necessary fields exist. Crucially, set this Data Type to be Publicly visible in its definition (check privacy rules separately if needed).
ii) (Recommended) Add Sample Data: Manually add at least one record (row) to this Data Type in the App data view. This helps Impler correctly identify columns during setup.
iii) Enable API Access: Go to the Settings tab -> API sub-tab.
- Check the box to Enable Data API.
- Check the box next to the specific Data Type you prepared in step A1.
- Scroll down to API Tokens, generate a New API Token, give it a label (e.g., "Impler Key"), and copy the Private key immediately. Save it securely – you'll need it for Impler.

B. Setting up the Impler Application:

i) Create Import Project: Log in to web.impler.io and click Create Import. Give it a name and continue.
ii) Configure Destination: Navigate to the Destination tab within your new Impler project.
- Toggle Bubble.io ON.
- Fill in your Bubble App details:
- Bubble App Name (the name part of your .bubbleapps.io URL).
- Environment (production or development).
- Custom Domain Name (if applicable).
- API Private Key (paste the key saved from step A3).
- Select Data Type: Enter the exact Datatype Name from Bubble (step A1) where data should be sent.
iii) Test & Save: Click Test and Save to verify the connection.
iii) Map Columns: Click the Map Columns button. Impler will use your Bubble Data Type's structure to automatically suggest mappings. Review and confirm.

C. Using the Plugin in Bubble:
i) Install Plugin: Go to the Plugins tab in Bubble, click + Add plugins, search for "CSV Excel Import Plugin Impler", and click Install.
ii) Add Impler Element: Go to the Design tab. Drag the CSVExcelImporter visual element onto your page. (Note: This element is typically invisible to end-users, so placement isn't critical for appearance).
iii) Get Impler Credentials: Go back to your Impler project (web.impler.io). Click the Integrate button (usually top-right). Copy the projectId, templateId, and accessToken provided. (This corresponds to the "Snippet section" mentioned in your source).
V) Configure Element & Actions:
- Double-click the CSVExcelImporter element on your Bubble page to open its properties. Paste the projectId, templateId, and accessToken into the corresponding fields. Configure other options like User Id or Primary Color here if needed.
- Go to the Workflow tab. Create a new event: General -> Page is loaded. Add an action: Element Actions -> Initialize Importer (select your CSVExcelImporter element).
- Add a Button element to your Design tab (e.g., label it "Import Data"). Click Start/Edit workflow for the button. Add an action: Element Actions -> Open Import Widget (select your CSVExcelImporter element).

By following these steps, you can embed a scalable and user-friendly CSV/Excel Importer into your Bubble.io application using Impler.

For comprehensive details and advanced options:
https://docs.impler.io/widget/bubble.io-embed