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.inc in 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/view.js, /build/index.asset.php, /build/view.asset.php, and /build/block.json — the exact files shipped in the WordPress.org zip. The only third-party runtime dependency bundled in /build/view.js is hls.js (Apache-2.0), used so non-Safari browsers can play Air’s HLS preview videos; everything else is sourced from @wordpress/* packages provided by WordPress core.