설명
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.
스크린샷

Air Asset Picker listed on the WordPress Plugins page 
Settings Air Media page for entering your workspace ID 
Adding the Air block from the Gutenberg block inserter 
The Air asset picker gallery — browse and search your workspace 
Log in to your Air account from within the block editor 
Preview an asset before inserting it 
An Air asset embedded in a WordPress page via CDN URL 
Asset details panel with metadata, tags, and insert options 
Inserted Air asset shown in the post editor with Replace toolbar
블록
이 플러그인은 1개의 블록을 제공합니다.
- Air Embed an image or video asset from Air
설치
- Install the plugin from the WordPress.org plugin directory, or upload the
air-asset-pickerfolder to/wp-content/plugins/. - Activate the plugin through the Plugins menu in WordPress.
- Go to Settings Air Media and enter your Air workspace ID.
- Edit any page or post, add the Air block, and click Add asset to start inserting assets.
FAQ
-
Where do I find my workspace ID?
-
Log in to your Air account, go to your workspace settings, and copy the workspace ID from the URL or settings panel.
-
Do I need an Air account?
-
Yes. This plugin requires an active Air account on an Enterprise plan. Visit air.inc to learn more.
-
Does this upload files to WordPress?
-
No. Assets are embedded via Air’s CDN URL. No files are stored in your WordPress media library.
-
Which editor is supported?
-
The Gutenberg block editor (WordPress 6.3+). The classic TinyMCE editor is not supported.
후기
이 플러그인에 대한 평가가 없습니다.
기여자 & 개발자
변경이력
0.3.0
- WordPress.org compliance: renamed PHP function/option/define/admin-page prefixes from
air_inc/airtoairpicker(4+ char prefix requirement). Renamed localized JS global fromairAssetPickerDatatoairpickerData. Added one-shot migration that copies the legacyair_workspace_idoption toairpicker_workspace_idon activation and onplugins_loadedso existing installs retain their workspace ID without manual reconfiguration. - Renamed main plugin file from
index.phptoair-asset-picker.phpto match the plugin slug. - Documented the public source repository and build instructions in the readme so reviewers and downstream developers can rebuild
/build/index.jsfrom/src. - Plugin zip no longer ships the WordPress.org directory assets (
/assets), webpack/biome configs, ornode_modules— added.distignoreso only runtime files (air-asset-picker.php,readme.txt,/build) are distributed.
0.2.13
- Removed the
Plugin URIheader; the WordPress.org submission form requires the plugin and author URIs to be distinct.
0.2.12
- Replaced stock-photo screenshots (5–9) with Air-owned imagery and captured the recent QA design improvements.
0.2.11
- Removed the wp-admin plugin-directory filters (
plugins_api/plugins_api_result) that previously replaced the WordPress.org search and details responses with a local payload. WordPress.org is now the sole source of plugin metadata, ratings, and updates.
0.2.10
- Removed canonical slug
air-asset-pickerfrom the internal legacy-listing replacement filter so the plugin will not override its own WordPress.org plugin-info payload (auto-updates, ratings, and stats from WordPress.org are now authoritative once the plugin is listed there).
0.2.9
- Renamed plugin to “Air Asset Picker” to comply with WordPress.org trademark restrictions on the term “WordPress” in plugin names.
- Added canonical submission build (
air-asset-picker.zip) so the installed folder matches the plugin’s text domain — resolves Plugin Check text-domain-mismatch errors.
0.2.8
- Readme prepared for WordPress.org submission: accurate short description, External Services disclosure, current changelog, updated screenshots and CTA references.
0.2.7
- Inspector buttons (Replace image, View in Air) resized to match Figma spec
- Preview thumbnail pinned to 47×76 with center-crop for tall images
- Empty-state and picker CTAs unified as “Add asset” (single upload)
- Enterprise paywall copy updated: “Upgrade to Enterprise” / “Explore plans”
0.2.6
- Internal version bump
0.2.5
- Restored “View in Air” copy (was briefly “View in AIR”)
0.2.4
- QA fixes for inspector layout and button heights
0.2.3
- Pinned Replace button to deterministic 32px height across WordPress versions
0.2.2
- Fallback to
urls.selectedfor “View in Air” whenurls.airDetailis absent
0.2.1
- Inspector polish and accessibility improvements
0.2.0
- Asset detail panel improvements
- Inspector controls for resolution and resize
0.1.0
- Initial release
- Air Gutenberg block with iframe-based asset picker
- Settings page for workspace ID configuration
- Image and video asset support with Air CDN delivery
