Air Asset Picker
Air Asset Picker is a Gutenberg block that connects your WordPress site to your Air workspace. Content editors can browse, search, and insert brand-approved images and videos from Air without ever leaving the WordPress block editor — no downloading, no re-uploading.
How it works:
- Add the Air block to any page or post
- Click Add asset to open the Air asset picker
- Log in to your Air account
- Browse or search your workspace and select an asset
- The asset is embedded via Air’s CDN URL — no files are stored in WordPress
Why CDN delivery?
Assets are served directly from Air’s CDN. This means no storage overhead in WordPress, and any updates made to an asset in Air are reflected on your site immediately.
Requirements:
- An active Air account on an Enterprise plan
- Your Air workspace ID (found in your Air account settings)
External Services
This plugin connects to Air (https://air.inc) to enable asset selection and embedding. Air is a digital asset management service operated by Air Labs, Inc.
When is data sent?
- When a user opens the asset picker inside the WordPress block editor, the plugin loads the Air picker UI from
https://wordpress-plugin.air.incin an iframe. This is required to authenticate the user and display the asset gallery. - When an asset is selected, only the asset’s CDN URL and metadata (filename, dimensions, alt text, caption) are sent back to WordPress and stored as block attributes. No binary file data is transferred to WordPress.
- When a published page is viewed, the browser loads the embedded image or video directly from Air’s CDN.
What data is sent?
- Your Air workspace ID (entered in Settings → Air Media)
- Authentication credentials you enter into the Air picker (handled entirely by Air, never seen by the plugin)
- No personal data from WordPress is transmitted to Air
Terms and privacy:
- Air Terms of Service: https://air.inc/terms
- Air Privacy Policy: https://air.inc/privacy
Source Code
The compiled JavaScript shipped in /build is generated from human-readable sources in /src using @wordpress/scripts (webpack). The full source code, build configuration, and development instructions are publicly available at:
https://github.com/AirLabsTeam/air-wordpress-plugin
Build prerequisites:
- Node.js 22 or later
- npm 10 or later (or Yarn 1.x)
Build steps:
git clone https://github.com/AirLabsTeam/air-wordpress-plugin.git
cd air-wordpress-plugin
npm install
npm run build:prod
The build outputs /build/index.js, /build/index.asset.php, and /build/block.json — the exact files shipped in the WordPress.org zip. No third-party minified libraries are bundled; all dependencies are sourced from @wordpress/* packages provided by WordPress core.
