Affiliate links will be generated, products, prices, and discounts refreshed automatically. You don't have to take care of this! Functionality and output can be adjusted generally via the plugin settings or individually by enhancing the shortcodes. Choose between different designs, add custom styles or create new templates in order to adapt the layout of your website.

Plugin Version: 5.1.1
 
WordPress plugin AAWP

Plugin Features

The plugin is a powerful tool for WordPress users who are Amazon Partners. With its robust features, it simplifies the process of integrating Amazon products into WordPress websites seamlessly. Users can efficiently display Amazon products, prices, and reviews on their site, enhancing the overall shopping experience for their visitors. By utilizing this plugin, website owners can potentially increase their affiliate earnings through Amazons associate program. Its user-friendly interface and customizable options make it a valuable asset for those looking to monetize their WordPress sites effectively.

Hailed as a game-changer in the realm of affiliate marketing, the plugin offers dynamic features that cater specifically to Amazon affiliate websites. Its integration with Amazons API enables real-time updates on products, prices, and availability, ensuring that the displayed information is always current and accurate. With customizable templates and layouts, users have the flexibility to design product displays that align with their websites aesthetic and branding. Additionally, AAWP geo-targeting capabilities allow for personalized content delivery based on the visitors location, optimizing the user experience and potentially boosting conversions.

Designed with performance and optimization in mind, this plugin boasts lightning-fast loading times and clean code that adheres to WordPress best practices. Its responsive design ensures that product displays look great on any device, whether desktop or mobile. With SEO-friendly features, including customizable metadata and schema markup, the plugin helps improve the visibility of Amazon products on search engines, driving organic traffic to the site. The seamless integration of the plugin with popular page builders further enhances its usability, allowing users to effortlessly create engaging product showcases without any coding knowledge.

One of the standout features of the plugin is its comprehensive reporting and analytics tools, providing users with valuable insights into the performance of their affiliate links and product displays. By tracking clicks, conversions, and revenue generated through Amazon referrals, users can make informed decisions to optimize their affiliate marketing strategies. The plugins compatibility with caching plugins and CDN services ensures optimal performance even on high-traffic websites, making it a reliable choice for affiliate marketers seeking to maximize their earnings. With regular updates and dedicated support, users can rest assured that the plugin will continue to evolve to meet their growing needs in the ever-changing landscape of affiliate marketing.

Specifications:

Release date: 12-07-2019
Last updated: 08-10-2026
Type: Paid
License: GPL 
Subject: Ads & Affiliates
Compatibility: W5.x W6.x
Includes: Plugin
Language packs: English
Developer: getaawp

Rating:
4.470297029703 1 1 1 1 1 (202 Votes)

Download by subscription!

You need to log in on the site and purchase a club subscription!

Share with your friends!

 

Guide to AAWP: Setting Up Amazon Blocks, Tables, and Troubleshooting in WordPress

AAWP is not just for dropping yet another affiliate link into WordPress. Its real job is to turn an ASIN, a search query, or a selected group of Amazon products into a clean on-page element: a product box, bestseller list, comparison table, text link, standalone price field, or button. This guide focuses on the practical workflow rather than a promotional overview: what to check before installation, which settings to open first, how to build a real product block, and how to confirm that the data, links, and click tracking are all working correctly.

This article is written for content site owners, review authors, roundup editors, SEO specialists, and WordPress administrators who need a safe way to display Amazon products without hand-coding every product card. AAWP relies on Amazon product data and the plugin's own configuration, so the quality of the output depends not only on a nice-looking template, but also on a correct setup across the API, Tracking ID, cache, theme, block editor, and display rules.

One important limitation up front: this guide does not cover purchasing, payment, license key entry, or activation bypasses. It deals with configuring a plugin you already have, its features, typical use cases, and troubleshooting. Secret keys, API credentials, and site access details should never be pasted into public articles, comments, contractor tasks, or generator prompts.

AAWP in WordPress: guide cover with a live Amazon block output check
The core idea behind AAWP is to connect configuration in the WordPress admin panel with a readable Amazon block on the page, then verify the result on a live post.

Where AAWP Is Actually Useful

AAWP works best on sites where Amazon offers are part of the content itself, not just a random link at the end of an article. That includes tech reviews, tool roundups, comparison pieces, "what to buy" guides, accessory rankings, book recommendation pages, and any niche where readers need to see the product name, image, price, availability, rating, CTA button, and a bit of context.

The main benefit of the plugin is that editors no longer have to manually copy product cards and keep them up to date. Instead, they insert a shortcode or block, and AAWP handles the output. The official documentation describes the main formats: text links, product boxes, bestseller lists, new releases, data fields, widgets, and comparison tables. This is not a single universal block, but a set of ways to present products for different editorial goals.

When the Plugin Is a Good Fit

AAWP is worth considering if your site regularly publishes content featuring Amazon products and you need to manage that output from inside WordPress instead of building every product card manually. It is especially effective in scenarios where readers are comparing options or making a purchase decision based on several criteria.

  • A review of a single product where you need a prominent box with a button and up-to-date data.
  • A roundup of several products where a list, grid, or compact table makes more sense.
  • A comparison article where each column should display the same types of data.
  • A content site with traffic from multiple countries, where local Tracking IDs and link geotargeting need to be configured carefully.
  • An editorial team that wants to see click stats for Amazon links inside WordPress.

When AAWP May Not Be the Right Starting Point

The plugin may be unnecessary if your site only has two or three static affiliate links, you do not have access to the required product data, or Amazon is not your primary focus. AAWP is built specifically for Amazon use cases. If your project revolves around multiple affiliate programs, SaaS products, coupons, financial products, or your own offers, a general affiliate link manager with product cards for any merchant may be a better fit.

There is also a separate case to consider: a new Amazon Associates account without access to the Product Advertising API. In those situations, AAWP documentation describes a separate AAWP API, but it comes with its own access model, quotas, and limitations. So before rolling it out, you need to be clear about where the plugin will get its data and which output formats will be available under your chosen setup.

Practical takeaway: AAWP is worth using not for a "pretty button," but when your site has a repeatable workflow: choose a product, display it in a clear format, verify the data, measure clicks, and maintain the blocks without manually rebuilding every article.

What to Check Before Installation

Before you install anything, do not start with design. First, make sure the site can retrieve data, render blocks without conflicts, and stay in line with WordPress, Amazon Associates, and your local privacy requirements. If you skip this step, the problems usually show up later: product blocks cannot find items, prices do not update, clicks are not recorded, or geotargeting behaves oddly for admins.

Your WordPress Technical Baseline

The official AAWP requirements list the versions of WordPress, PHP, MySQL, and the PHP extensions needed for requests and data processing. Do not rely on memory here: open the current documentation before deployment and compare it against your hosting environment. If the site has not been updated in a while, first test theme, cache, block editor, and other critical plugin compatibility on a staging copy.

Pay special attention to PHP extensions, outbound request access, and proper WP Cron behavior. AAWP fetches and refreshes data, so aggressive outbound request blocking, disabled cron, or strict security rules can look like "the plugin doesn't work" even though the real cause is at the hosting or security plugin level.

Access to Amazon Product Data

AAWP can work through the official Amazon Product Advertising API, and for some use cases the documentation also describes a separate AAWP API. For a site owner, this is a foundational decision. The official API requires valid credentials and compliance with Amazon Associates requirements. The AAWP API can help when access to the official API is not available yet or is limited, but it has its own quotas and restrictions. For example, AAWP documentation notes that when using the AAWP API, certain list types such as bestsellers and new releases cannot be used.

Do not paste secret API keys into article text, editor comments, or theme templates. They should only be stored in protected site settings. If multiple people work on the site, decide in advance who has access to those settings and who is responsible for checking API errors.

Your Content Workflow

The plugin does not replace editorial work. It outputs data and formats a block, but it does not decide which products to compare, which specs matter, or where a block genuinely helps the reader. For stronger results, prepare a list of ASINs, article categories, formatting rules, and brief editorial guidelines. For example: use a product box for a single-product review, a list or grid for a ranking post, and a comparison table with a limited number of items plus clear manual feature rows for a "what should I choose" article.

AAWP preparation map: WordPress, Amazon API, ASIN, cache, and result validation
Before publishing your first block, check not only the plugin installation, but also the data source, ASIN availability, cache, theme, and final validation method.

Installation and First Launch Without Unnecessary Risk

Technically, installing AAWP looks much like installing a standard WordPress plugin from a ZIP archive: the administrator opens the Plugins section, uploads the archive, activates the plugin, and goes to its settings. But in a real project, the goal is not just to click Activate. You want a controlled rollout.

A Safe Rollout Sequence

  1. Create a backup of the site or use a staging copy if the site is already getting traffic.
  2. Update WordPress, the theme, and key plugins only after checking compatibility, not right before publishing an important article.
  3. Install AAWP and confirm that its section appears in the admin panel.
  4. Fill in only the settings needed for the first test: data source, primary Tracking ID, basic link format, and output for one test product.
  5. Create a draft page with a single product box and review it in preview mode.
  6. Clear the site and browser cache, then check the public-facing page in a private window.

This sequence helps separate installation issues from content issues. If a draft with one product already fails to render, there is no point in immediately building a large comparison table. First, you need to confirm that the data connection works, the ASIN is recognized, and the styles are loading.

What Not to Do on Day One

Do not enable everything at once: geotargeting, click tracking, custom templates, extra Tracking IDs, custom CSS, widgets, and dozens of tables. Every extra layer makes troubleshooting harder. First get one product rendering reliably, then add lists, tables, and analytics.

Do not edit plugin files directly. In its template documentation, AAWP explicitly warns that original files inside the plugin folder may be overwritten during updates. For safe changes, use built-in settings, a child theme, a small standalone plugin, or a trusted snippet manager. For styling, CSS added through the theme or a safe CSS tool is usually enough.

The Data Source: Amazon API, AAWP API, and Cache

To understand AAWP errors, you need to understand the data chain. An editor inserts an ASIN, a search query, or a ready-made table. The plugin queries a product data source, stores the result in its own database, generates the HTML output, and displays it through a shortcode, block, widget, or table. If any part of that chain breaks, you end up with an empty block, an outdated price, a "Products not found" message, or an incorrect link.

The Official Amazon Product Advertising API

Through the official API, AAWP retrieves images and product data, including pricing where access and requests allow it. This is a strong option for a mature Amazon site, but it depends on Amazon Associates requirements, a correct Tracking ID, the right store region, and request limits. AAWP documentation lists typical API error codes such as AccessDenied, AssociateNotEligible, InvalidPartnerTag, RequestThrottled, TooManyRequests, and others. Not all of them mean the plugin itself is broken. Often the issue comes from account access, the wrong storefront, request limits, or server settings.

AAWP API as a Separate Data Source

The developer describes the AAWP API as a standalone Amazon data service that can be used with the plugin and independently of the plugin license status, as long as the plugin version is compatible. One important nuance: access to it is not automatically included in the standard plugin workflow, and it has its own quotas. For this guide, the point is not to promote it, but to understand where it fits: it can be useful when the official Product Advertising API is unavailable, but it is not a full replacement for every feature. The documentation explicitly states one limitation: bestseller and new release lists are not used through the AAWP API.

Cache and Database Cleanup

AAWP stores fetched products and lists in the WordPress database so it does not have to call the API on every page view. That helps with speed and request limits, but it also requires some discipline. Old test products, deleted lists, and items you no longer use can accumulate over time. To deal with that, the plugin includes Database Garbage Collection, which helps remove stale records by default and reduce load on both the database and the API.

If the site actively tests dozens of ASINs, do not disable database cleanup without a reason. If you need to turn it off for troubleshooting, treat that as a temporary measure and re-enable it after testing. Cache should improve stability, not hide a problem: after changing the API, template, or Tracking ID, always verify the result in a private window and clear the site cache when needed.

Detailed Configuration After Installation

After the first launch, approach the AAWP settings not as a checklist of toggles, but as several working areas. The interface may vary between versions, so use the meaning of the tabs and the official documentation as your guide: data source, features, output, links, tables, database, tracking, and advanced modes.

Primary Tracking ID and Store Region

First, make sure the primary Tracking ID belongs to the Amazon Associates storefront you actually use. An error in this field can lead to broken links or API errors. If the site targets one country, start with one store and one Tracking ID. Leave multiregional settings for phase two, after the basic output is already stable.

If you use multiple Tracking IDs, do not turn them into a mess. Name them with a clear convention: country, project, placement type. That way, when you analyze clicks, it is obvious which ID belongs to the main article, which one to a widget, and which one to a test block.

Link Output and Attributes

In the output settings, check how the plugin builds affiliate links, whether they open in a new tab, which attributes are added, and how button elements are displayed. For affiliate links, it is often important to use safe attributes such as nofollow or sponsored if that matches your site's policy. Do not rely on the theme for this: inspect the final block HTML with your browser's developer tools.

Design of Product Boxes and Lists

AAWP supports different templates and styles for product boxes and lists. The feature settings documentation outlines template and design options, along with the ability to override styling through shortcode attributes. For a typical site, it makes sense to start with the default or light variant, test it on mobile, and only then add CSS. A dark product box may look great in the admin area but read poorly inside a light article or clash with your theme's button styles.

Minimum Visual QA Checklist

  • The product title does not get cut off too early or break the layout on mobile.
  • The CTA button is visible without scrolling inside the product box.
  • The price, rating, and image do not look like third-party ad clutter if the article has an editorial layout.
  • The block does not cause content shifting when the image loads late.
  • The comparison table fits the content width or behaves predictably on mobile.

Link Geotargeting

Geotargeting in AAWP changes the destination of the affiliate link based on the visitor's country, but it does not change the contents of the product box: the title, price, and description still come from the original store. That nuance matters. If a German product box shows a product from Amazon.de, a visitor from France may be redirected to Amazon.fr, but the block itself does not turn into a French catalog entry.

Enable geotargeting only when you have local Tracking IDs for the required countries and a clear privacy policy in place. AAWP documentation states that country detection analyzes IP data and may use a cookie. That means the feature should be reviewed against your privacy policy text and the legal requirements for your region before you turn it on.

Click Tracking

Click tracking is disabled by default and must be enabled separately. Once enabled, AAWP records clicks on Amazon links and lets you analyze the source, Tracking ID, time period, element type, and other parameters. That is useful for an editorial team: you can see where people click the image, where they click the button, and where a table is overloaded and not helping the user.

But click tracking adds a technical dependency: requests have to go through the WP JSON API. If a security or optimization plugin blocks unauthenticated REST API requests, clicks may never be recorded. So after enabling it, make a test click in a private window, then check both the click report section and your browser console.

AAWP settings after installation: data source, output, geotargeting, and click tracking
It is easier to configure AAWP in layers: first the data source and basic output, then design, geotargeting, and click stats.

Product Boxes, Fields, and Lists: Choosing the Right Format

One common mistake is using the same format in every article. AAWP offers multiple output types because different parts of a page serve different purposes. In some places you need a large product box with a button, elsewhere a text link is enough, and sometimes a standalone price or rating field works better inside your own editorial block.

Product Box for a Primary Recommendation

A product box works well when the article centers on a single product or when a review includes a "top recommendation." The base shortcode uses the box attribute and an ASIN. The documentation also describes attributes for the title, description, template, buttons, and other settings. The goal is not to override every field, but to keep automatic data where it helps and add editorial context where Amazon data alone is not enough.

[amazon box="B00EXAMPLE" /]
[amazon box="B00EXAMPLE" title="Short editorial title" /]

Use a custom title carefully. If you rewrite the product box heading for readability, do not distort what the product actually is. For a manual description, it is usually better to add a normal paragraph next to the box than to force the box itself to function like a full review.

Data Fields for Precision Inserts

Data fields let you output a single value: title, thumbnail, price, button, or another supported element. That is useful when you are building your own editorial block but still want the price or button to be pulled in through AAWP. This approach works especially well in long-form guides where one large product box would interrupt the reading flow.

[amazon fields="B00EXAMPLE" value="price" /]
[amazon fields="B00EXAMPLE" value="button" /]

Make sure an individual field does not feel disconnected from its context. A price with no explanation may confuse readers, and a button with no product name is risky. The best approach is to pair the field with a short editorial note.

Bestsellers and New Releases

Bestseller and new release lists are useful when the user is looking for current options in a category rather than one specific product. In AAWP, a bestseller list is built around a keyword or browse node, and the number of items can be limited. In a practical guide, you should not display too many entries. The official documentation itself warns that comparing too many products can confuse visitors. The same rule applies to lists: five strong options are often more useful than a long strip of ten nearly identical cards.

If the list is built from a keyword, choose the query the way a shopper would think, not the way an SEO headline is written. For a "home coffee" niche, it is usually better to test specific categories and phrases than to rely on a broad query like "coffee." After publishing, check whether irrelevant products slipped into the list.

Comparison Tables: One of AAWP's Strongest Features

Comparison tables are one of the most product-focused use cases in AAWP. A table is not there to decorate the page, but to help the reader choose. In its official materials, AAWP describes table creation as a three-step process: add products by ASIN or search, create rows and assign content types, then insert the table with a shortcode.

A good comparison table should not have twenty rows "just in case." The reader came for a decision, not a copy of the Amazon catalog. So first decide which criteria actually influence the choice: price, size, compatibility, material, key feature, weight, runtime, Prime availability, rating, an editorial "best for..." note, and the CTA button.

How to Build a Table Without Overloading It

  1. Choose two to five products that genuinely compete with each other.
  2. Add products by ASIN or through search, if search is available in your setup.
  3. Create rows with the same meaning across all products: image, title, price, rating, button, and 2 to 4 manual attributes.
  4. Disable rows that do not help the decision.
  5. Highlight only one or two important rows with color so the table does not turn into a loud visual grid.
  6. Copy the table shortcode and insert it into the appropriate part of the article.

Which Rows Should Be Entered Manually

AAWP can pull in product data that is available through the chosen data source, but it does not automatically know every spec that matters in your niche. The official table builder description explicitly notes that specs such as processor or memory are not provided by the Amazon API and must be entered manually. That is a normal part of editorial work.

Manual rows should be used for criteria that genuinely help the reader choose, but those rows still need to be verified against reliable sources. If a specification is uncertain, it is better to leave it out of the table than create the illusion of a precise comparison. In the article body, you can explain the uncertainty in plain language, but the table itself should remain clear and trustworthy.

AAWP comparison table: ASINs, rows, manual attributes, and shortcode
A strong AAWP table is built around the reader's decision: products first, then rows and manual criteria, followed by a short shortcode in the article.

Block Editor and Shortcodes: Two Valid Ways to Work

AAWP supports both the classic shortcode workflow and a Gutenberg Block workflow. There is no need to turn this into an "old versus new" debate. Shortcodes are convenient for consistent, portable, highly controlled output. The block is convenient for editors who want to choose a feature from the interface, use sidebar settings, and avoid memorizing attributes.

When to Use the Gutenberg Block

The AAWP block can be found by adding a block in the WordPress editor or searching by name. The documentation describes options for Product Boxes, Bestseller Lists, New Releases, Data Fields, Text Links, and Comparison Tables. For product boxes, the block lets you specify one or more ASINs, use product search, change the title and description, control title length, choose a template or style, add an extra button, and set a Tracking ID.

That is convenient for editors working visually. They can see the block in article context and notice more quickly when a card is placed poorly, a table is too wide, or a product list interrupts an important paragraph.

When Shortcodes Are Better

Shortcodes are easier to control in templates, reusable blocks, older articles, widgets, and internal editorial documentation. They are easy to copy, compare, replace, and store in an internal guide. For developers, shortcodes are also useful when auditing content at scale: you can search for all instances of [amazon and quickly see which output formats the site uses.

[amazon box="B00EXAMPLE" template="horizontal" /]
[amazon bestseller="coffee grinder" items="5" template="list" /]
[amazon table="123" /]

An Editorial Rule That Helps

Choose one primary method for the team and keep the other as an allowed exception. For example: new articles are built with the Gutenberg Block, while repeatable tables and older content are maintained with shortcodes. That helps prevent editors from accidentally creating different versions of the same block.

AAWP workflow: Gutenberg Block, shortcode, and output validation
The block and the shortcode solve the same problem in different ways: editors care about visibility, administrators care about control and repeatability.

Practical Example: A Product Block for a Review and a Mini Comparison

Let's walk through a specific scenario. Imagine an article titled "How to Choose a Coffee Grinder for Home Use." You need to feature one primary recommended product, add a short list of alternatives, and include a comparison table for three models. The goal is not just to display products, but to help the reader move from category choice to a confident final decision.

Goal

Create a page where the recommendation block starts with one product box for the main pick, followed by a short list of similar models, and then a comparison table with manual rows for burr type, grind range, hopper capacity, who it is best for, and an editorial note.

Preparation

Before you start, prepare the ASINs for the selected products, verify that they are available through your data source, and decide which attributes will be entered manually. Do not try to auto-pull data that the API does not provide. If a spec matters, verify it against the product page, the manufacturer's documentation, or a reliable review.

Steps

  1. Create a draft article or open an existing piece in the editor.
  2. Insert the main product box using the AAWP block or the shortcode [amazon box="ASIN" /].
  3. Add a nearby paragraph with an editorial explanation of why this product is the main pick.
  4. Create a bestseller list or a manually curated set of products if the automatic list is too broad.
  5. In the AAWP tables section, build a table with three products and add both automatic and manual rows.
  6. Copy the table shortcode and insert it into the comparison section.
  7. Open the preview and verify the mobile view, button click behavior, and link accuracy.

Validation

On the public page, it should be obvious which product is the main pick, what the alternatives are, and why the table helps with the decision. If the page only shows three similar-looking cards with no explanation, the task is not done. If the table displays nothing but price and a button, it is not a real comparison. A good AAWP block strengthens editorial content instead of replacing it with a catalog.

One Important Nuance

If one product in the table is not found or its price is missing, do not publish the article "as is." Check the ASIN, product availability for the affiliate program, AAWP logs, API connection, and cache. Sometimes a product exists on Amazon but is unavailable through affiliate tools or is not returned for your store. In that case, replace the product or explain the recommendation manually without an automated block.

Checking the Result After Setup

Validating AAWP should not be a casual visual pass through the page. It should be a short test plan. Otherwise, you may see a nice-looking product box and miss the fact that the link goes to the wrong store, the click was never recorded, the mobile table breaks the layout, or the price is not updating because of an API error.

Functional Testing

  • Open the page in a private window so you are not logged in as an administrator.
  • Check that the product box, list, and table render without empty spaces or errors.
  • Hover over the button and confirm that the link contains the correct affiliate identifier.
  • Make a test click and confirm that it appears in the click tracking section if the feature is enabled.
  • Check the mobile view: the cards should not spill beyond the content width, and the table should remain readable.
  • Clear the page cache and repeat the check after changing settings.

SEO and Trust Review

AAWP can improve page usability, but by itself it does not guarantee better rankings, more clicks, or more revenue. For a search-focused page, the blocks should not replace helpful content, but support it. Keep real explanations on the page: buying criteria, pros and cons, limitations, personal or editorial conclusions, compatibility warnings, and answers to common questions. If the whole article is nothing but product blocks, it serves the reader less effectively.

Also verify that the affiliate nature of the links is disclosed in line with your platform rules and applicable law. AAWP helps render the links, but responsibility for affiliate disclosure and privacy policy compliance remains with the site owner.

Performance Check

On a page with several AAWP blocks, review performance after caching is in place. Large images, wide tables, multiple lists, and widgets can affect how the page feels to use. If a block is not visible in the first screen, it may be better placed lower on the page after a short introduction. If a table is too heavy for mobile, reduce the number of products or rows.

Safe Customization: CSS, Templates, and Targeted Text Strings

AAWP customization should start with settings and CSS, not plugin file edits. The official template documentation explains the template structure and explicitly warns against editing original files inside the plugin folder because they may be overwritten during updates. For most sites, small visual adjustments are enough.

CSS for Cleaner Spacing and Buttons

The example below does not change AAWP logic or interfere with the API. It only makes the product box feel a bit calmer inside the article. Add this code wherever your site stores custom CSS: theme settings, a child theme, or a safe CSS tool. Before publishing, verify the mobile view.

.aawp-product {
  margin: 24px 0;
  border-radius: 8px;
}

.aawp-button,
.aawp-product__button {
  font-weight: 700;
  text-decoration: none;
}

@media (max-width: 640px) {
  .aawp-product {
    margin: 18px 0;
  }
}

If the selectors differ in your version of the output, do not guess. Open your browser's developer tools and inspect the element's real classes. Rolling back is simple: remove the CSS and clear the cache.

Replacing Individual Text Strings

To replace certain text strings, AAWP documents the aawp_replace_translations filter. Use it only if you understand exactly which string you are changing, and add the code through a safe snippet manager or a separate mini-plugin, not inside the AAWP plugin file.

add_filter( 'aawp_replace_translations', function( $translations ) {
    $translations['%s Reviews'] = '%s Amazon Reviews';
    return $translations;
} );

After adding the snippet, open a page with a product box, verify the target string, and make sure other translations did not break. If the result is wrong, disable the snippet instead of trying to patch the plugin core.

Templates for Larger Projects

Custom PHP templates make sense when the site has its own design system and a developer is ready to maintain it after updates. This is not a quick editorial tweak. If you only need to change a button color, use CSS. If you need to change the card structure, element order, and reusable markup pattern across dozens of pages, then it makes sense to dig into templating, child themes, and a staging environment.

Common AAWP Issues and How to Troubleshoot Them

Most AAWP problems fall into one of five areas: the product is not available through the selected data source, the API is not connected or is limited, the cache is showing stale data, the theme or optimization layer is interfering with output, or the REST API is blocking click tracking. Troubleshooting should move from simple to more complex.

AAWP troubleshooting: Products not found, API errors, REST API, and WordPress cache
AAWP troubleshooting starts with the ASIN and logs, then moves on to the API, cache, theme, REST API, and security settings.

"Products not found" Appears Instead of a Product Box

Symptom: the article contains what looks like a valid shortcode or block, but no product appears on the public page. In some cases, you see a product not found message.

Possible cause: the ASIN is incorrect, the product is unavailable to affiliate tools, the product has been removed, the data source is not returning data, or the API connection is broken.

Check the ASIN on Amazon and confirm that you can retrieve an affiliate link through Amazon Associates tools. Then open the AAWP logs in the support section and see whether there is a recent entry for that ASIN. If there is an error code, compare it against the official "Amazon API not connected" article. If there is no code, check the API connection and the cache.

RequestThrottled or TooManyRequests Error

Symptom: some blocks stop updating, request limit errors appear in the logs, and new products are pulled in inconsistently.

Possible cause: the site is making more requests than current access allows, or AAWP is being forced to refresh too many products at once. In some cases, this is tied to Amazon account requirements rather than the article itself.

Do not increase the load by adding more tables right away. Check whether stale-record cleanup has been disabled, whether dozens of test products are still stored, and whether a large amount of content is being refreshed at the same time. If the error is tied to Product Advertising API permissions, review the official explanations in AAWP documentation and choose the practical path forward: restore access, reduce load, or use a supported alternative data source if it fits your use case.

Styles or Buttons Look Broken

Symptom: the product box renders, but the button shifts out of place, images are too large, the table extends beyond the screen, or the theme overrides AAWP CSS.

Possible cause: a theme conflict, CSS optimizer conflict, minification, delayed style loading, or an article container that is too narrow.

Disable CSS combining and delayed CSS loading on a test page, clear the cache, and check the result. Then restore optimization one setting at a time. If the issue is only the table width, try reducing the number of products and rows, choosing a wider page template, or adding targeted CSS. Do not rewrite the AAWP template until you know standard settings and CSS cannot solve the problem.

Click Tracking Does Not Record Clicks

Symptom: a user clicks an Amazon link, the redirect works, but nothing appears in AAWP statistics.

Possible cause: click tracking is not enabled, the administrator role is excluded from tracking, the test is being run from a logged-in session, JavaScript on the page is failing, or a security plugin is blocking the WP JSON API. AAWP documentation describes a common case involving a 401 Unauthorized response for a request to /wp-json/aawp/v1/click/.

Check the click tracking setting, excluded roles, private window behavior, and the browser console. If you see REST API blocking, adjust the security or optimization plugin so the AAWP request can pass through. Then run another test click and confirm that the event appears in the stats.

Geotargeting Does Not Change the Link Country

Symptom: a visitor from another country still lands in the original store, or a VPN-based test shows the same old result.

Possible cause: there is no local Tracking ID for the target country, the visitor is logged in as an administrator, the browser has an old cookie stored, the selected geolocation service is inaccurate, or the product is not available under the same ASIN in another store.

Test in a private window after connecting the VPN before opening the page. Check the aawp-geotargeting cookie, local Tracking ID settings, and the selected redirect mode. If a specific product is frequently unavailable in another store, consider using search mode instead of trying to open the same ASIN.

AAWP FAQ

Can you use AAWP without access to the official Amazon Product Advertising API?

AAWP documentation describes a separate AAWP API that can retrieve Amazon data without access to the official Product Advertising API. But this is not just a simple "checkbox instead of API" option: it has its own access rules, quotas, and restrictions. Before choosing it, verify which output formats your site actually needs, because some list types are not supported through that source.

Why is the price or rating missing even though the product exists on Amazon?

A product being live on Amazon does not guarantee that all data is available through the affiliate data source. Check the ASIN, the product's affiliate eligibility, AAWP logs, API errors, and cache. If the data does not return consistently, do not promise an exact price inside the article text.

Which is better: the Gutenberg Block or shortcodes?

For editors, the Gutenberg Block is usually more convenient because it lets them choose the output type and some settings from the interface. For repeatable setups, older articles, widgets, and technical control, shortcodes are often easier. Within a team, it is better to agree on one primary method so the two approaches are not mixed without a reason.

Can you change the appearance of a product box?

Yes, but you should start with style settings and a small amount of CSS. Custom templates require an understanding of PHP, the template structure, and ongoing maintenance after updates. Do not edit files inside the AAWP plugin folder, because an update may overwrite your changes.

Does geotargeting change the product box itself for each country?

No. According to AAWP documentation, geotargeting changes the destination of the affiliate link, but the product box content still comes from the original store. If your audience is international, verify local Tracking IDs, the geotargeting cookie, and product availability in other stores.

Why doesn't click tracking count my test clicks?

There are several possible reasons: the feature is not enabled, your role is excluded from tracking, you are testing while logged in as an administrator, there is a JavaScript error on the page, or a security plugin is blocking the WP JSON API request. Run the test in a private window and check the browser console.

Is AAWP a good fit for a WooCommerce store?

AAWP is not a WooCommerce catalog and does not turn Amazon products into standard store products with a cart and order flow. Its main purpose is to display Amazon affiliate blocks inside WordPress content. If you need a full store with carts, order statuses, and payment processing, that is a different type of solution.

How many products should you include in a comparison table?

For most articles, 3 to 5 products are enough. If you add more, the table becomes wider, heavier, and less helpful for decision-making. One strong table with clear criteria is usually better than a long product showcase with no editorial point.

When AAWP Is the Right Choice

AAWP is a strong fit for a site that systematically works with Amazon-focused content and wants to keep product output under WordPress control: product boxes, lists, tables, standalone fields, editor blocks, Tracking IDs, geotargeting, and click tracking. It is especially useful where manual layout work is already making articles harder to maintain, and readers need more than just a link - they need a clear product selection block.

Before publishing your first large piece, verify the data source, one test ASIN, the base product box, mobile view, affiliate link, cache, and click recording. After that, you can move on to tables, lists, and customization. If you already understand which blocks the page needs and what limits your Amazon account has, you can download the WordPress version and test it on a draft or staging copy of the site.

The main benchmark is simple: after implementation, the reader should understand more quickly which product to choose, why it fits, and where the button leads. If AAWP blocks help with that, the plugin is serving the content well. If they merely fill the page with product cards, it is worth revisiting the article structure, reducing visual noise, and keeping only the elements that genuinely help the reader decide.

By OceanTheme.org Editorial Team

 

You are not logged in to post comments.