GuideForms
Login GuideForms PRO

AAWP integration

The AAWP integration connects Amazon product data from the AAWP plugin (Amazon Affiliate WordPress Plugin) as a filter source for your guides. Unlike the Webhook and FluentCRM integrations, AAWP is a data source — it doesn’t send leads anywhere. Instead, it makes Amazon product information available for filtering, so visitors can find products by price, rating, category, and more. The AAWP integration is a Pro feature.

Prerequisites

  • AAWP plugin — Must be installed, activated, and configured with your Amazon API credentials.
  • Products cached — AAWP must have products cached in its database. GuideForms reads from AAWP’s local product cache, not from the Amazon API directly.

How it works

When the AAWP integration is enabled, GuideForms registers a custom post type (gp_aawp_product) and syncs product data from AAWP’s database into WordPress posts. These posts are then indexed by GuideForms’ AAWP indexer adapter, making all product fields available as filter sources in your guides.

The sync process:

  1. Product sync — GuideForms reads products from AAWP’s database table and creates corresponding gp_aawp_product posts. Product data (title, price, rating, image, etc.) is stored as post meta.
  2. Taxonomy assignment — Product categories from Amazon are mapped to custom taxonomies, allowing category-based filtering.
  3. Index build — The AAWP indexer adapter reads the synced product data and writes it to the facet index, just like any other data source.

Available product fields

Once synced, these Amazon product fields are available as filter sources in the Guide Editor:

  • Price — Current product price (numeric, works with slider steps and range filters).
  • Rating — Average customer rating (numeric, 0–5).
  • Review count — Number of customer reviews.
  • Prime status — Whether the product is Prime-eligible (boolean).
  • Category — Amazon product category (taxonomy-based filtering).
  • Availability — Stock status.

These fields appear in the filter source dropdown when you configure a card or slider step, under the “AAWP” source group.

Setting up AAWP filtering

  1. Enable the integration — Go to GuideForms → Settings → Integrations and enable the AAWP integration.
  2. Sync products — GuideForms syncs products from AAWP’s cache. You can trigger a manual sync from the settings page.
  3. Rebuild the index — Go to GuideForms → Tools and rebuild the facet index so the AAWP product data is indexed.
  4. Configure your guide — In the Guide Editor’s Settings tab, set the target post type to gp_aawp_product. Then add steps with AAWP filter sources.

Product images

GuideForms includes an image proxy system for Amazon product images. Since Amazon doesn’t allow hotlinking in all contexts, product images are served through a local proxy that handles caching and delivery. This is automatic — no configuration needed.

Keeping data fresh

Product data is only as fresh as AAWP’s cache. AAWP periodically refreshes product data from Amazon based on its own cache settings. When AAWP updates a product, GuideForms picks up the changes on the next sync cycle. If you notice stale prices or ratings, check that AAWP’s cache refresh is running and then rebuild the GuideForms index.

Troubleshooting

No AAWP fields in the filter source dropdown

Verify that AAWP is installed and the integration is enabled in GuideForms settings. Then rebuild the facet index — AAWP fields only appear after the indexer has run.

Products not showing in results

Make sure the guide’s target post type is set to gp_aawp_product in the Settings tab. If it’s set to “Posts” or “Products” (WooCommerce), GuideForms won’t look at AAWP product posts.

Next steps