Automatically sync WordPress plugin releases to Easy Digital Downloads via the EDD Release Manager plugin.
- ✅ Zero Opinion: Just sends webhooks - use any build process
- ✅ Simple: One step in your workflow
- ✅ Flexible: Works with any GitHub release strategy
- ✅ Reliable: Proper error handling and validation
- ✅ Composable: Use with other actions (@10up, WP Engine, etc.)
- Install EDD Release Manager plugin on your WordPress site
- Configure webhook token in
wp-config.php:define( 'EDD_RELEASE_WEBHOOK_TOKEN', 'your_secure_token_here' );
- Add GitHub secrets to your repository (Settings → Secrets → Actions)
- name: Sync to EDD Storeuses: code-atlantic/edd-release-sync@v1with:
edd_id: '123456'version: '1.2.3'release_url: 'https://github.com/user/repo/releases/tag/v1.2.3'download_url: 'https://github.com/user/repo/releases/download/v1.2.3/plugin.zip'asset_api_url: 'https://api.github.com/repos/user/repo/releases/assets/12345'webhook_url: ${{ secrets.EDD_WEBHOOK_URL }}webhook_token: ${{ secrets.EDD_WEBHOOK_TOKEN }}name: Release My Pluginon:
push:
tags: ['v*']jobs:
release:
runs-on: ubuntu-lateststeps:
# Build your plugin (your way)
- uses: actions/checkout@v4
- name: Build pluginrun: | composer install --no-dev npm ci && npm run build zip -r my-plugin.zip . -x "*.git*" "node_modules/*"# Create GitHub release (your way)
- name: Create Releaseid: create_releaseuses: softprops/action-gh-release@v1with:
files: my-plugin.zip# Get asset API URL for Git Updater
- name: Get Asset API URLid: assetenv:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}run: | ASSET_URL=$(gh api repos/${{ github.repository }}/releases/tags/${{ github.ref_name }} \ --jq '.assets[] | select(.name == "my-plugin.zip") | .url') echo "url=$ASSET_URL" >> $GITHUB_OUTPUT# Sync to EDD (our action)
- name: Sync to EDD Storeuses: code-atlantic/edd-release-sync@v1with:
edd_id: ${{ secrets.EDD_PRODUCT_ID }}version: ${{ github.ref_name }}release_url: ${{ steps.create_release.outputs.url }}download_url: 'https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/my-plugin.zip'asset_api_url: ${{ steps.asset.outputs.url }}webhook_url: ${{ secrets.EDD_WEBHOOK_URL }}webhook_token: ${{ secrets.EDD_WEBHOOK_TOKEN }}| Input | Description | Example |
|---|---|---|
edd_id | EDD Download/Product ID | 123456 |
version | Release version | 1.2.3 |
release_url | GitHub release URL | https://github.com/user/repo/releases/tag/v1.2.3 |
download_url | Browser download URL | https://github.com/user/repo/releases/download/v1.2.3/plugin.zip |
asset_api_url | GitHub API asset URL | https://api.github.com/repos/user/repo/releases/assets/12345 |
webhook_url | EDD webhook endpoint | https://yoursite.com/wp-json/edd-release-manager/v1/webhook |
webhook_token | Bearer token | your_secret_token |
Important URL Formats:
download_url: Browser download URL (what users click) - used for file processingasset_api_url: GitHub API URL (for Git Updater dropdown) - NOT the browser download URL
| Input | Description | Default |
|---|---|---|
plugin_slug | Plugin slug (fallback if edd_id invalid) | - |
readme_url | README URL (reserved for future use) | - |
is_prerelease | Is this a pre-release (beta/alpha/rc) | false |
changelog | Changelog content (auto-detects from CHANGELOG.md or readme.txt) | Auto-detect |
test_mode | Creates version in EDD but doesn't update download URL | false |
| Output | Description |
|---|---|
status | success or failed |
http_code | HTTP response code |
response | Response body from webhook |
Add these secrets to your repository (Settings → Secrets → Actions):
| Secret | Value | Description |
|---|---|---|
EDD_PRODUCT_ID | Your EDD product ID | Found in EDD Downloads |
EDD_WEBHOOK_URL | https://yoursite.com/wp-json/edd-release-manager/v1/webhook | Your webhook endpoint |
EDD_WEBHOOK_TOKEN | Your webhook token | Configured in wp-config.php |
This action requires two different URL formats for different purposes:
https://github.com/user/repo/releases/download/v1.2.3/plugin.zip
- Purpose: File download and processing by EDD Release Manager
- Format: Standard GitHub browser download URL
- Used for: Customer downloads from their EDD account
https://api.github.com/repos/user/repo/releases/assets/12345
- Purpose: Git Updater dropdown compatibility
- Format: GitHub API URL (not browser URL!)
- Used for: Version selection in WordPress admin dashboard
Why both? Git Updater's dropdown requires API URLs to fetch asset metadata, while actual file downloads need browser URLs. The EDD Release Manager plugin uses both appropriately.
The action supports pre-releases with automatic beta version management in EDD Software Licensing:
- name: Detect pre-releaseid: prereleaserun: | if [[ "${{ github.ref_name }}" =~ -beta|-alpha ]]; then echo "is_prerelease=true" >> $GITHUB_OUTPUT else echo "is_prerelease=false" >> $GITHUB_OUTPUT fi- name: Sync to EDDuses: code-atlantic/edd-release-sync@v1with:
edd_id: ${{ secrets.EDD_PRODUCT_ID }}version: ${{ github.ref_name }}release_url: ${{ steps.release.outputs.url }}download_url: ${{ steps.release.outputs.download_url }}asset_api_url: ${{ steps.asset.outputs.url }}webhook_url: ${{ secrets.EDD_WEBHOOK_URL }}webhook_token: ${{ secrets.EDD_WEBHOOK_TOKEN }}is_prerelease: '${{ steps.prerelease.outputs.is_prerelease }}'What happens for pre-releases:
- ✅ Enables beta version in EDD Software Licensing metabox
- ✅ Sets beta version number (e.g., "2.0.0-beta.1")
- ✅ Uploads beta file for users opted into beta updates
- ✅ Separate beta changelog (extracted from CHANGELOG.md or readme.txt)
- ✅ Version validation (ensures beta > stable before enabling)
The action automatically extracts changelog content from your repository:
Priority Order:
- Manual
changeloginput (if provided) CHANGELOG.md- Looks for version-specific sectionreadme.txt- Extracts from WordPress changelog section- Empty (logs warning, uses GitHub release body as fallback)
Supported CHANGELOG.md formats:
## [2.0.0] - 2025-10-02## 2.0.0## Version 2.0.0## v2.0.0Supported readme.txt format:
== Changelog ==
= 2.0.0 =
* Feature: New awesome feature
* Fix: Bug fix description
Manual override:
- name: Sync with custom changeloguses: code-atlantic/edd-release-sync@v1with:
edd_id: ${{ secrets.EDD_PRODUCT_ID }}version: '1.2.3'changelog: | ## What's New - Added feature X - Fixed bug Y# ... other required inputsUse GitHub CLI to get the correct API URL for your release asset:
- name: Get Asset API URLid: assetenv:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}run: | # Get API URL for specific asset ASSET_URL=$(gh api repos/${{ github.repository }}/releases/tags/${{ github.ref_name }} \ --jq '.assets[] | select(.name == "my-plugin.zip") | .url') echo "url=$ASSET_URL" >> $GITHUB_OUTPUT- name: Sync to EDDuses: code-atlantic/edd-release-sync@v1with:
asset_api_url: ${{ steps.asset.outputs.url }}# ... other inputsTest webhook connectivity and version creation without updating GitHub download settings:
- name: Test webhookuses: code-atlantic/edd-release-sync@v1with:
edd_id: '123456'version: '1.0.0'release_url: 'https://github.com/user/repo/releases/tag/v1.0.0'download_url: 'https://github.com/user/repo/releases/download/v1.0.0/plugin.zip'asset_api_url: 'https://api.github.com/repos/user/repo/releases/assets/12345'webhook_url: ${{ secrets.EDD_WEBHOOK_URL }}webhook_token: ${{ secrets.EDD_WEBHOOK_TOKEN }}test_mode: 'true'What test_mode does:
- ✅ Creates version in EDD Software Licensing (version number visible in EDD)
- ✅ Logs activity in Release Manager activity log
- ✅ Validates webhook authentication and connectivity
- ❌ Does NOT update GitHub Update Settings metabox (download URL remains unchanged)
- ❌ Does NOT affect customer downloads (they still get the old version)
Use test_mode to:
- Verify webhook authentication is working
- Test version creation in EDD SL
- Validate the complete flow without affecting production downloads
- Debug connectivity issues safely
- name: Sync to EDDid: edd_synccontinue-on-error: trueuses: code-atlantic/edd-release-sync@v1with:
edd_id: ${{ secrets.EDD_PRODUCT_ID }}version: ${{ github.ref_name }}release_url: ${{ github.event.release.html_url }}download_url: 'https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/plugin.zip'asset_api_url: ${{ steps.asset.outputs.url }}webhook_url: ${{ secrets.EDD_WEBHOOK_URL }}webhook_token: ${{ secrets.EDD_WEBHOOK_TOKEN }}
- name: Handle failureif: steps.edd_sync.outputs.status == 'failed'run: | echo "Webhook failed with status ${{ steps.edd_sync.outputs.http_code }}" echo "Response: ${{ steps.edd_sync.outputs.response }}"- name: Sync Free Versionuses: code-atlantic/edd-release-sync@v1with:
edd_id: ${{ secrets.EDD_FREE_ID }}version: ${{ github.ref_name }}release_url: ${{ steps.release.outputs.url }}download_url: ${{ steps.release.outputs.download_url }}asset_api_url: ${{ steps.asset.outputs.url }}webhook_url: ${{ secrets.EDD_WEBHOOK_URL }}webhook_token: ${{ secrets.EDD_WEBHOOK_TOKEN }}
- name: Sync Pro Versionuses: code-atlantic/edd-release-sync@v1with:
edd_id: ${{ secrets.EDD_PRO_ID }}version: ${{ github.ref_name }}release_url: ${{ steps.release.outputs.url }}download_url: ${{ steps.release.outputs.download_url }}asset_api_url: ${{ steps.asset.outputs.url }}webhook_url: ${{ secrets.EDD_WEBHOOK_URL }}webhook_token: ${{ secrets.EDD_WEBHOOK_TOKEN }}- Verify
EDD_WEBHOOK_TOKENsecret matches token in wp-config.php - Check Authorization header is being sent correctly
- Verify
EDD_PRODUCT_IDmatches actual EDD download ID in your store - Check product exists and is published
- Check your WordPress site is accessible from GitHub Actions
- Verify firewall isn't blocking GitHub's IP addresses
- Check WordPress debug log for errors
Add ACTIONS_STEP_DEBUG secret with value true to see detailed action output.
Unlike opinionated workflow templates, this action:
- ✅ Works with any build process (webpack, vite, composer, whatever)
- ✅ Works with any release strategy (tags, releases, manual)
- ✅ Works with any other actions (10up, WP Engine, etc.)
- ✅ Does one thing well: sends webhooks
- ❌ Doesn't force you into a specific build process
- ❌ Doesn't create releases for you
- ❌ Doesn't build your assets
You control everything. We just send the webhook. 🚀
- EDD Release Manager - WordPress plugin for automated EDD releases
- Git Updater - Plugin updater for GitHub-hosted plugins
GPL-2.0-or-later - Same as WordPress
- Issues: GitHub Issues
- Documentation: EDD Release Manager Docs
- Community: WordPress.org Forums
Built with ❤️ by Code Atlantic for the WordPress community.
Make your EDD releases automatic. Install the EDD Release Manager plugin and use this action to automate everything.