The Amazon Affiliate Product Engine for WordPress
Note
AzonMate is free, open-source, and community-driven.
Most Amazon affiliate plugins charge $49 – $199/year. AzonMate gives you the same power — 8 stunning layouts, Gutenberg blocks, geo-targeting, analytics — for $0. No premium tier, no upsells, no nag banners.
Our goal is simple: build the best free Amazon affiliate toolkit on the planet, together. Star the repo, share it with fellow affiliate marketers, submit ideas or pull requests — every contribution makes AzonMate better for everyone.
If you find AzonMate useful, the best way to support it is to give it a ⭐ on GitHub and tell your friends.
Important
🔴 Amazon PA-API 5.0 is being deprecated on April 30, 2026.
Amazon is retiring the Product Advertising API (PA-API 5.0) and replacing it with the Creators API. Starting v2.0.0, AzonMate has fully migrated to the new Creators API with OAuth 2.0 authentication.
If you are upgrading from v1.x, you must generate new Creators API credentials (Credential ID, Credential Secret, and Version) from your Amazon Associates account and enter them in AzonMate → Settings → API. Your old PA-API Access Key and Secret Key will no longer work after the deprecation date.
🆕 What's New in v2.0.0 — Amazon Creators API
AzonMate v2.0.0 replaces the legacy PA-API 5.0 with Amazon's next-generation Creators API. Here's what changed under the hood:
| PA-API 5.0 (old) | Creators API (v2.0.0) | |
|---|---|---|
| Authentication | AWS Signature v4 (HMAC-SHA256) | OAuth 2.0 Bearer token |
| Credentials | Access Key + Secret Key | Credential ID + Credential Secret + Version |
| API Endpoint | webservices.amazon.*/paapi5/... |
creatorsapi.amazon/catalog/v1/... |
| Token Caching | None (signed per-request) | Auto-cached for 1 hour |
| Request Format | PascalCase params | lowerCamelCase params |
| Offers Resource | Offers.Listings.* |
offersV2.listings.* |
| Price Structure | Flat (Price.Amount) |
Nested (price.money.amount) |
Key benefits of the Creators API:
- Simpler authentication — no more complex AWS Signature v4 signing. Just a Bearer token.
- Automatic token caching — OAuth tokens are cached for ~1 hour, reducing overhead.
- Single API host — all marketplaces use
creatorsapi.amazon(no per-region hosts). - Future-proof — PA-API 5.0 shuts down April 30, 2026. Creators API is Amazon's long-term replacement.
What's no longer available (removed by Amazon):
⚠️ CustomerReviews(star rating, review count) — not available in Creators API⚠️ DeliveryInfo.IsPrimeEligible(Prime badge) — not available in Creators API- Existing manually-set ratings and Prime badges on your products will remain unchanged.
Quick Start · Features · Layouts · Shortcodes · Configuration · Changelog · License
- Download the latest
.zipfrom the Releases page — or click the green Code button above → Download ZIP. - In WordPress go to Plugins → Add New → Upload Plugin and upload the zip.
- Click Install Now, then Activate.
- Head to AzonMate → Settings, enter your Amazon Creators API credentials, hit Test Connection — done.
That's it. Start dropping shortcodes or using the visual Showcase Builder.
Theme-proof product displays — admin preview = live post:
Product Box · Product List · Comparison Table · Bestseller · Text Link · Product Search · Showcase · Collage |
Point-and-click shortcode generator with live WYSIWYG preview — no code required. Database-backed cache with configurable TTL + WP-Cron auto-refresh. Auto-detect visitor country → swap affiliate tag → redirect to correct Amazon store. Privacy-safe tracking with SHA-256 hashed IPs, per-product stats, dashboard widget, CSV export. AES-256-CBC key encryption · nonce-verified AJAX · capability checks · rate limiting. Fully scoped BEM classes · CSS Custom Properties · dark mode · template overrides. Add products manually without an API key — full CRUD admin interface. Fetch from Amazon button auto-populates all fields from the Creators API. Dynamic multi-product collage shortcode with auto-adjusting grid layout and hover-reveal buy buttons. Built-in update manager — check for new GitHub releases and install updates with one click from Settings → Updates. Dashboard notification banner when a new version is available. |
| Layout | Description |
|---|---|
| Grid Cards | Responsive 1–4 column card grid with badges, savings %, ratings, and a prominent CTA button. |
| Row List | Full-width horizontal rows — thumbnail left, details center, price + button right. Highlighted rows for badged products. |
| Masonry | Pinterest-style CSS-column layout. Products flow dynamically for a magazine feel. |
| Comparison Table | Data-rich column-per-product table — image, title, rating, price, buy button. Highlight the recommended pick. |
| Layout | Description |
|---|---|
| Hero Card | Large spotlight card with 42% image panel + full body. Perfect for "top pick" callouts. |
| Compact | Slim inline card that sits between paragraphs — thumbnail, title, price, CTA in one row. |
| Split | Clean 50/50 grid — image on one side, details + features + CTA on the other. |
| Deal Card | Price-drop focused design with orange accent, savings % badge, and "Save X%" callout. |
[azonmate box="ASIN"] → Product box
[azonmate link="ASIN"]anchor text[/azonmate] → Inline text link
[azonmate image="ASIN"] → Product image link
[azonmate field="price" asin="ASIN"] → Single data field
[azonmate list="ASIN1,ASIN2" layout="grid"] → Product list
[azonmate table="ASIN1,ASIN2" highlight="1"] → Comparison table
[azonmate showcase="ASIN1,ASIN2" layout="grid" columns="3"] → Showcase (8 layouts)
[azonmate collage="ASIN1,ASIN2,ASIN3"] → Product collage
Tip: Use the Showcase Builder (
AzonMate → Showcasein the admin) to generate shortcodes visually — no syntax to memorize.
| Setting | Where |
|---|---|
| API credentials (Credential ID, Credential Secret, Version, Partner Tag, Marketplace) | AzonMate → Settings → API |
| Cache TTL & auto-refresh schedule | AzonMate → Settings → Cache |
| Geo-targeting regions & fallback tags | AzonMate → Settings → Geo |
| Click tracking & analytics options | AzonMate → Settings → Tracking |
| Manual products CRUD | AzonMate → Products |
| Visual showcase builder | AzonMate → Showcase |
| Minimum | |
|---|---|
| WordPress | 6.0 |
| PHP | 7.4 |
| Amazon Creators API | Credential ID, Secret & Version |
azonmate/
├── azonmate.php → Main plugin bootstrap
├── uninstall.php → Clean uninstall handler
├── composer.json → Composer config (Creators API SDK)
├── assets/
│ ├── css/ → Admin, public, editor, showcase, collage styles
│ ├── js/ → Admin, public, click tracker, search modal, manual products
│ └── images/ → Icons & SVG assets (icon, prime badge, star)
├── build/ → Compiled Gutenberg blocks (8 blocks)
├── includes/
│ ├── class-plugin.php → Core plugin orchestrator
│ ├── class-autoloader.php → PSR-4 autoloader
│ ├── class-activator.php → Activation hook handler
│ ├── class-deactivator.php → Deactivation hook handler
│ ├── admin/ → Settings, analytics, showcase builder, manual products, product search
│ │ └── views/ → Admin page templates & partials
│ ├── api/ → Amazon Creators API client & marketplace config
│ ├── blocks/ → Block registrar & Gutenberg source (JSX)
│ │ └── src/ → 8 block sources + shared React components
│ ├── cache/ → Cache manager & cron refresh
│ ├── geo/ → Geo-targeting & link rewriter
│ ├── models/ → Product data model
│ ├── shortcodes/ → 9 shortcode handlers + abstract base + manager
│ ├── templates/ → Template renderer & helper functions
│ └── tracking/ → Click tracker
├── templates/ → Frontend templates (theme-overridable)
│ ├── showcase/ → 8 showcase layout templates
│ ├── product-box/ → Box templates (default, horizontal, compact)
│ ├── comparison-table/ → Table template
│ ├── product-list/ → List templates (default, grid)
│ ├── bestseller/ → Bestseller template
│ ├── collage/ → Collage template
│ ├── image-link/ → Image link template
│ └── text-link/ → Text link template
├── vendor/ → Composer dependencies (Creators API SDK, Guzzle)
└── languages/ → Translation .pot file
Full history in CHANGELOG.md.
- Fixed: Critical error on page reload after update — navigates to fresh URL instead of reloading to avoid opcache/autoloader conflicts
- Improved: Redesigned update buttons with gradient styling, spinner animation, and color-coded result messages
- Fixed: Removed premature
activate_plugin()from upgrader hook — WordPress handles reactivation automatically - Improved: readme.txt and README.md updated to document one-click updates and dashboard notifications
|
Numan Rashed GitHub @numanrki numanrki@gmail.com |
|
Found a bug? · Have a feature idea? · Something not working right?
|
|
✅ You CAN:
❌ You CANNOT:
|
Built with ☕ by Numan Rashed — for the Amazon affiliate community.
Questions? Reach out at numanrki@gmail.com
If AzonMate saves you time or money, consider giving it a ⭐ — it helps others find it too.