Submitting your extension to the Airtable Marketplace
Learn how to submit your extension to be reviewed for the Marketplace, so anyone can install it. 🚀
Before you get started
Before you send us your extension, read our guide to polishing your extension, review the developer policy, and take a look at the extension review process. Making sure you follow the rules and guidelines in these documents is a great way to help your extension pass the review process.
Get your extension ready
To submit your extension for review, you need to provide us with some information about it. Make sure you have all this information prepared before you submit your extension for review.
General extension information
- A name. Keep it short & memorable.
- An icon. This should be a single square image between 200x200px and 1000x1000px in size.
- Publisher name. Who is this extension by? This is probably your name or the name of your organization.
- Publisher icon. A small icon/logo that will be shown next to the publisher name. This should be a single square image between 200x200px and 1000x1000px in size.
Marketplace listing information
- A short description. In one sentence, what does your extension do? This will be shown when listing your extension alongside others in the marketplace.
- A longer description. What does your extension do, and why should someone use it? This can be several paragraphs, and will be shown on the detail page for your extension.
- Some screenshots. These show users how your extension looks and give an idea of what it does. You can upload between one and ten. These should be at least 300x500px, and no more than 1800px wide.
- A video. You can upload a short video demonstrating your extension to potential users. Optional.
Support information
- A support email. Who can users of your extension get in touch with if they encounter an issue?
- A support URL. Where can users go learn how to use your extension and get help?
Reviewer information
- Thorough reviewer instructions. Explain to the reviewer how to install and use your extension. If your extension requires any special information, API keys, or user credentials etc. make sure to include copies of that information that the reviewer can use.
- A reviewer walk-through video. Record a video showing a complete demonstration of your extension, from setup to usage. Demonstrate each of the features of your extension 1-by-1, and show how they interact with the base.
- An example base invite link. Create a base that demonstrates your extension, and use the sharing options to create a read-only invite link. A copy of this base will be used when reviewing your extension.
- A list of external services. If your extension integrates with any sort of external service, or sends data anywhere other than within the user's base, list out the service, how it's used, and why it's required.
Submit your extension
First, make sure you're using the latest version of the Airtable developer tools. If you're not sure, you can usually upgrade to the latest version by running npm install --global @airtable/blocks-cli
.
From your extension's home directory (the same one you use for block run
and block release
), run block submit
. This command will send all of the code for your extension to Airtable for review. Once your code has been uploaded successfully, you'll get a link to a form where you can submit the information about your extension that you gathered previously.
When we've received code & extra information, we'll start to review your extension. We'll get in touch with you with updates to this process and any extra information we might need from you.
If you have questions regarding an extension you've submitted, reply directly to the email you received after running block submit
.
What next?
Once your extension has been listed in the marketplace, Airtable users can install it. You’re responsible for ongoing maintenance of the extension and the experience of those users. If there are bugs in your extension, for example, it’s up to you to fix them. If you make changes to your extension and want to update it, run block submit
again. We'll review it, and every installation will update automatically once approved.