Documentation · Version 1.0.0
Amazon Affiliate Kit is a WordPress plugin that provides four purpose-built Gutenberg blocks for Amazon affiliate content. It allows you to create product comparison tables, single product showcases, pros & cons boxes, and specification tables — with manual or API-powered affiliate links, audience score bars calculated from Amazon rating distributions, color-coded badges, and fully responsive layouts.
Amazon Affiliate Kit is sold under three license tiers:
| License | Sites Allowed | Description |
|---|---|---|
| One Site | 1 | Activate on a single WordPress website |
| Five Sites | 5 | Activate on up to five WordPress websites |
| Ten Sites | 10 | Activate on up to ten WordPress websites |
Each license key can only be activated on the number of sites corresponding to your purchased tier. Once all activation slots are used, you must deactivate an existing site before activating a new one.
After purchase, you will receive a license key in the format AAK-XXXXX-XXXXX-XXXXX-XXXXX. Keep this key safe — you will need it to activate the plugin on your website.
License keys do not expire unless otherwise stated at the time of purchase. However, the license issuer reserves the right to revoke keys that are shared publicly or used in violation of the terms.
After purchase, download the amz-affiliate-kit.zip file from your order confirmation email or your account page.
amz-affiliate-kit.zip file from your computer.After the upload completes, click Activate Plugin. You will see "Amazon Affiliate Kit" listed in your installed plugins and a new Affiliate Kit menu item in the WordPress admin sidebar.
The plugin will not allow you to insert blocks until a valid license is activated. See Section 5 below.
AAK-XXXXX-XXXXX-XXXXX-XXXXX.Once activated, the License page displays your masked license key, license type (One Site, Five Sites, or Ten Sites), activation date, and current site URL. The plugin verifies your license with the server once every 24 hours in the background. No action is needed from you.
If you need to move the plugin to a different website:
If the plugin is installed but no license is activated:
Amazon Affiliate Kit can auto-fetch product prices, star ratings, review counts, and generate affiliate links using the Amazon Product Advertising API (PA-API) 5.0. This is optional — you can enter all product data manually without configuring the API.
yourtag-20). Find it under Account Settings → Manage Your Tracking IDs.targetfrog-20).Once configured, each product block has an ASIN field with a Fetch button in the sidebar panel. Enter a 10-character Amazon ASIN (e.g., B0DK7PT95G) and click Fetch. The plugin will auto-fill the price, affiliate link, and star ratings if available.
If the fetch fails, the error message will explain why. You can always enter all data manually regardless of API status.
All blocks are found in the Gutenberg block inserter under the Amazon Affiliate Kit category. You can also search by name (e.g., type "comparison" or "pros" in the block search).
A horizontal comparison table showing multiple products side by side with images, titles, prices, score bars, and custom specification rows.
Click on any product column in the table to select it. The sidebar panel opens with that product's settings:
$169.95).https://www.amazon.com/dp/B0DK7PT95G?tag=yourtag-20).Below the affiliate link field, you'll find the Audience Score panel. Enter the Review Count and star rating percentages (5 Star % through 1 Star %). The plugin auto-calculates the weighted score (out of 100) and displays it as a gradient score bar. See Section 9 for full details.
Use the toolbar buttons or sidebar panel to add products or spec rows. Click Remove Product in the sidebar to delete the selected product column.
The comparison table automatically displays the date when each product was added or last edited, shown next to the price (e.g., $169.95 - 04.05.2026).
If you add more products than the "Products Per Page" setting (default: 4), the table automatically shows ← Previous | Next → navigation links above the table. Visitors can page through the products without scrolling.
On the published page, the table renders as a clean, responsive HTML table. On mobile devices, the table scrolls horizontally. Hovering over the score bar shows the audience score tooltip.
A featured product card with a 50/50 split layout — product image on the left, details on the right.
In the sidebar panel:
The score appears as a large number inside a colored rectangle box in the top-right area, with the text "Overall Score" below it. Hovering shows the full tooltip breakdown.
The block renders as a responsive card. On mobile, the layout stacks vertically (image on top, details below). Both buttons use the background color, font size, padding, and border radius configured in the dashboard. A hover color change is applied on mouse-over.
A two-column block listing product advantages and disadvantages.
The block splits into two columns inside the editor:
For each item, you can:
Renders as a clean two-column box. The left side has a subtle background color (default: #F1F2F2). The right side has a left border. On mobile, the layout stacks vertically.
A labeled two-column table for listing product specifications.
Renders as a clean bordered table with the dark heading bar. Spec names appear semi-bold. All styling follows the dashboard settings.
All block appearance customizations are managed from Affiliate Kit → Settings. The settings page has five tabs. Changes apply globally to all instances of each block across your site.
| Setting | Description | Default |
|---|---|---|
| Access Key | Your Amazon PA-API access key | — |
| Secret Key | Your Amazon PA-API secret key | — |
| Associate Tag | Your Amazon tracking ID (e.g., yourtag-20) | — |
| Marketplace | Which Amazon store (US, UK, DE, etc.) | US |
| Cache (hours) | How long to cache API responses | 12 |
| Setting | Description | Default |
|---|---|---|
| Header BG | Background color of the left header column | #F1F2F2 |
| Header Border | Border color for the header column | #E6E7E8 |
| Header Font Size | Font size of row labels (Preview, Title, Price, etc.) | 18px |
| Header Column Width | Width of the left header column in pixels | 160px |
| Product Column Width | Width of each product column (leave empty for auto-fit) | auto |
| Serial # BG | Background color of the #1, #2 serial badges | #4CAF50 |
| Label Badge BG | Default background color for label badges | #4CAF50 |
| Title Font Size | Product name font size | 18px |
| Title Font Weight | Normal, Medium, Semi-Bold, or Bold | Bold (700) |
| Title Color | Product name text color | #1a1a1a |
| Price Font Size | Price and date text size | 14px |
| Price Color | Price text color | #1a1a1a |
| Affiliate Link Color | Color of "See Latest Price" link | #2962FF |
| Affiliate Link Text | Text of the affiliate link (customizable) | See Latest Price |
| Products Per Page | Number of products shown before pagination activates | 4 |
| Setting | Description | Default |
|---|---|---|
| Title Font Size | Product name font size | 20px |
| Title Color | Product name color | #1a1a1a |
| Price Font Size | Price display size | 16px |
| Price Color | Price text color | #1a1a1a |
| Score Box BG | Background of the score number box | #2d6a4f |
| Score Font Size | Font size of the score number | 36px |
| "Overall Score" Label Size | Font size of the label below the score box | 12px |
| "Overall Score" Label Color | Color of the label below the score box | #2d6a4f |
| Button BG Color | Background color of both buttons | #FF9800 |
| Button Text Color | Text color inside buttons | #ffffff |
| Button Font Size | Font size of button text | 16px |
| Button Vertical Padding | Controls button height (padding top/bottom in px) | 10px |
| Button Border Radius | Rounded corner radius of buttons | 6px |
| Button Hover BG Color | Button background color on mouse hover | #E68900 |
| Setting | Description | Default |
|---|---|---|
| Font Size | Text size of pros and cons items | 16px |
| Pros Icon Color | Color of the green + icon | #2d6a4f |
| Cons Icon Color | Color of the red − icon | #d32f2f |
| Icon Size | Size of the +/− icons in pixels | 18px |
| Pros BG | Background color of the pros (left) column | #F1F2F2 |
| Cons Border Size | Left border width of the cons column | 0.5px |
| Cons Border Color | Left border color of the cons column | #E6E7E8 |
| Setting | Description | Default |
|---|---|---|
| Left Column Width | Percentage width of the spec name column | 30% |
| Name Font Weight | Font weight of spec names | Semi-Bold (600) |
| Border Color | Border color between rows and columns | #E6E7E8 |
| Left Column BG | Background of the spec name column | #F1F2F2 |
| Heading BG | Background of the "SPECIFICATIONS" heading bar | #1a1a1a |
| Heading Text Color | Text color of the heading bar | #ffffff |
Amazon Affiliate Kit uses a weighted rating system to convert Amazon's star distribution into a 0–100 audience score.
Instead of entering a single score number, you enter the star rating distribution from the Amazon product page:
The plugin calculates the weighted average and converts it to a 100-point scale:
Weighted average = (5 × star5% + 4 × star4% + 3 × star3% + 2 × star2% + 1 × star1%) ÷ total%
Audience score = round((weighted average ÷ 5) × 100)
| Score Range | Verdict |
|---|---|
| 95–100 | Superb |
| 90–94 | Great |
| 80–89 | Good |
| 70–79 | Fair |
| 60–69 | Mixed |
| 0–59 | Poor |
On the published page, hovering over the score bar (comparison table) or score box (single product) shows a tooltip with:
On mobile, tapping the score bar opens the same tooltip. Tapping outside closes it.
Before uninstalling, deactivate your license to free up the activation slot:
What is removed: The plugin files are deleted. Plugin settings stored in the database (aak_settings, aak_license_data) remain until you manually remove them or use a database cleanup plugin.
What happens to existing content: Any posts or pages containing Amazon Affiliate Kit blocks will show a "This block is no longer available" message in the editor. The published frontend output will no longer render. The block data remains in the post content and will be restored if you reinstall the plugin.
If you encounter an issue:
Please include:
Support is typically provided within 24–48 business hours. We do not provide support for plugin modifications, third-party theme/plugin conflicts outside our control, or Amazon API eligibility issues (which are governed by Amazon).
Q: Do I need an Amazon API key to use this plugin?
No. The Amazon PA-API integration is optional. You can enter all product data manually — title, price, image, score, and affiliate link — directly in the block sidebar. The API simply automates some of that data entry.
Q: Why does the "Fetch" button show an eligibility error?
Amazon requires your Associates account to meet their PA-API eligibility requirements (typically requiring qualifying sales). This is an Amazon policy, not a plugin issue. Use manual data entry in the meantime.
Q: Can I use this plugin with the Classic Editor?
No. Amazon Affiliate Kit uses Gutenberg blocks exclusively. The Classic Editor plugin is not supported.
Q: How do I add my affiliate tag to links manually?
Paste the full Amazon product URL with your tag in the "Affiliate Link URL" field. The format is: https://www.amazon.com/dp/ASIN?tag=yourtag-20. Replace ASIN with the product ASIN and yourtag-20 with your Associate Tag.
Q: How do I get the star rating percentages?
Visit the Amazon product page. Scroll to the "Customer reviews" section. You will see a bar chart showing the percentage of 5-star, 4-star, 3-star, 2-star, and 1-star ratings. Enter these numbers in the plugin.
Q: Can I use the comparison table with more than 10 products?
Yes. There is no limit on the number of products. If you have more products than the "Products Per Page" setting, pagination links appear automatically.
Q: Why does the post show "Updating failed" when I save?
This is typically caused by a plugin conflict, a security plugin blocking the REST API, or a server-side PHP error. Try disabling other plugins temporarily to isolate the conflict. Ensure your server's PHP version is 7.4 or higher.
Q: Can I move my license to a different site?
Yes. Deactivate the license on the current site first (Affiliate Kit → License → Deactivate), then activate it on the new site.
Q: Does the plugin slow down my site?
No. The plugin loads CSS and JavaScript only on pages that contain its blocks. No assets are loaded on pages without blocks. API data is cached to avoid repeated external requests.