Teable Airtable Migration Helper

This Chrome extension helps you migrate attachment URLs (from Airtable CSV exports) into actual Teable attachment fields.

Features

• No File Downloads Required: The extension sends URLs directly to the Teable server, which handles the download and storage.
• Append Mode: New attachments are appended to existing ones, preventing data loss.
• Batch Processing: Handles records efficiently with automatic retries for failed uploads.
• Smart Parsing: Correctly handles Airtable's export format (e.g., filename.png (http://...)).

Installation

1. Download Source Code: Click the Code button on the GitHub repository page and select Download ZIP. Unzip the downloaded file to your desired location.
2. Open Extensions Page: In Google Chrome, go to chrome://extensions/.
3. Enable Developer Mode: Toggle the switch in the top-right corner.
4. Load Unpacked: Click the Load unpacked button and select the airtable-import-extension folder.
5. Pin Extension: Find the extension in your toolbar and pin it for easy access.

How to Usage

1. Prepare Your Data:

   • Export your data from Airtable to CSV.
   • Import the CSV into Teable. (Attachments will appear as text URLs in a text field).
   • Create a new empty Attachment field in your Teable table (this will be the destination).

2. Run the Migration:

   • Open your Teable table in the browser.
   • Click the extension icon.
   • Source Field: Select the text field containing the URLs.
   • Target Field: Select the empty Attachment field you created.
   • API Host: Verify the address (usually detected automatically, e.g., https://app.teable.io).
   • Click Start Migration.

3. Wait for Completion:

   • The extension will process all records.
   • You will see a progress bar and a log of successful/failed uploads.
   • Once finished, refresh your Teable page to see the attachments.

Troubleshooting

• "API Host is missing": Manually enter your Teable domain in the API Host box (e.g., https://your-domain.com).
• "Context detection error": Ensure you are on a specific table page (URL should contain /table/...). Refresh the page and try again.
• Upload Failures: The extension automatically retries failed uploads. If persistent, check if the source URLs are publicly accessible.