Publish your script
How to share your script with the rest of the Airtable community
The Airtable Marketplace not only lets users install extensions to their base, but also install and run script templates that are run in the scripting extension.
Preparing your script for submission
Scripts in the marketplace are meant to both help Airtable users run common or complex tasks in their base, and serve as a jumping-off point to create more powerful, customized scripts.
Make sure your script follows these best practices:
The script should be able to run out-of-the-box, using script settings where necessary.
As a baseline, scripts in the marketplace should use script settings (input.config
)
to give the script a title and a description.
Users who install the script from the Marketplace should not have to edit the code itself in order to get some value out of it. Using script settings items and other input methods, the script should be able to run immediately upon installation.
The script may require particular types of tables or fields to be present in the base in order to work. The best scripts should aim to “gracefully degrade” if the user doesn’t have their base set up exactly as the script expects, and still provide functionality where possible. Scripts should aim to provide helpful error messages and other user feedback, to lead users down a “pit of success” when they go to run the script.
The script code should be clean, followable, and documented where necessary.
It should be relatively straightforward for a technical script user to be able to understand what the script is doing, and modify it as-needed to introduce more custom behavior.
The code should not be obfuscated, variable and function names should describe what they are used for.
Take a look at the example scripts here for inspiration and reference.
Submitting your script
When you’re ready to submit your script, simply fill out this submission form.
Be sure to include:
- A meaningful name for your script - this name should also match the name provided via script settings in your actual script code.
- Your publisher name and email - we may reach out!
- A publisher icon - optional, but a great way to add that extra polish to your hard work!
- A short description for your script - this will appear in the marketplace under the script name.
- A longer description - this is a great place to include what the script can help users do, what inputs it expects, what types of base schemas it will work with, and what changes it makes to the base. We’d also encourage adding a link to a base in the Airtable Universe that showcases your script - you can publish a Universe base separately here.
- A video or GIF of a screen recording of your script in action. These can be short and sweet - users find them incredibly helpful to better understand what the script is actually doing.
After submitting your script, the Airtable team will review the script for functionality and security. Specifically, the review will look at:
- Functionality
- Does the script provide compelling value to the user?
- Does it do what it says it does?
- Does it effectively use script settings for all its inputs, as necessary?
- Security
- Could it have any unintended side-effects?
- Does it make any unclear external requests?
Updating your script
If you’d like to provide an update to your script code:
- Wait until your script is initially published in the marketplace (or rejected).
- Submit your new code via the same submission form, but indicate that it is an update in the submission form and provide a link to your published script in the public Marketplace.