PaApi Product Search for Amazon

1. 

   Live Amazon product search on your page, so visitors browse without leaving for Amazon.com (Free feature)

2. 

   Let visitors compare Amazon products side by side in a scannable list view (Premium feature)

3. 

   Turn every Amazon search into guided discovery with autocomplete suggestions as visitors type

4. 

   Match any site palette with dark mode so your search feels native to your theme

5. 

   Earn on mobile traffic with a responsive layout that adapts to every screen

6. 

   Admin: Connect your Amazon Associates account in minutes so every click carries your tag

7. 

   Admin: Dial in base color, accent, card style, radius, dark mode, and font with live preview

8. 

   Admin: Control what visitors see with display options and product badge toggles

9. 

   Admin: Generate the shortcode you need without touching code

10. 

    Admin: Monitor cached searches and products at a glance and clear them anytime

How is this different from other Amazon affiliate plugins?

Most Amazon plugins (AAWP, AzonPress, AmaLinks Pro) display products you already know about – you pick ASINs, embed them, done. This plugin adds live search. Visitors find products themselves, browse, filter, and click through to buy. You earn commissions on products you never had to manually curate. Use it alongside your existing plugin or replace the ASIN-hunting workflow entirely.

Do I need Amazon API credentials to use this plugin?

No. Our Managed API (Beta) runs live Amazon product search with no Amazon API credentials needed yet and no AWS keys. You still need a free Amazon Associates account so commissions are tagged to you, and your Amazon Associate tag is always yours. If you already hold Creators API or PA-API v5 credentials, you can bring your own instead with one toggle in the plugin admin.

Do I need an Amazon Associates account?

Yes, a free Amazon Associates account is always required so commissions are tagged to you. For product data you can use our Managed API (Beta, no credentials needed) or your own Creators API (or legacy PA-API v5) credentials. Either way, your Associate Tag tags every product link with your affiliate ID.

How do I get Amazon API credentials?

1. Sign up for Amazon Associates
2. Apply for Creators API (recommended) or PA-API v5 access
3. Enter your credentials in the plugin settings and click Test Connection

Will this slow down my site?

No. The frontend uses build-time server-side rendering (SSR) – the initial HTML is pre-rendered, so the first paint is instant. Smart caching (30 min for searches, 1 hr for products) means repeat visits load in milliseconds. Your API quota stays healthy and your pages stay fast.

What’s included in the free version?

The free version is a real product, not a crippled trial. You get live Amazon search with autocomplete, 5 categories, 50 products, brand/price/condition filters (price and condition filters apply when you bring your own Amazon credentials), sorting, infinite scroll, caching, responsive grid layout, and a visual shortcode builder. Premium adds every category your Amazon store offers, 100 products, deal badges (with your own Amazon credentials), full appearance customization, list layout, and white-label mode.

Can visitors see products without searching first?

Yes. With no query and no category set, [psfa_search] shows the Top Products Grid: a rotating grid of popular Amazon products across categories instead of an empty search box, so any page becomes an instant Amazon storefront. This is the Top Products on Empty State setting, on by default. To force the grid on when that setting is off, use [psfa_search mode=”top”]. If you set a category, it shows popular products from that category instead. Either way, visitors can search or filter from there and every product link carries your Amazon Associate tag.

Can I customize how it looks on my site?

Yes. The plugin has a 6-axis appearance system. Free users get the Neutral base with orange accent. Premium users control all 6 axes: base color (5 options), accent color (17 options), card style (5 presets), border radius, dark mode, and font (15 Google Fonts + system default). The 6-axis system matches any WordPress theme.

Does it work with caching plugins?

Yes, but you may need to exclude pages with the [psfa_search] shortcode from full-page caching, since the search functionality requires dynamic content.

Can I use it on multiple sites?

Yes. Each site needs its own license and Amazon API credentials.

What happens if Amazon changes or retires the PA-API?

We recommend the Creators API (OAuth 2.0), Amazon’s current product API, or our Managed API (Beta), which needs no credentials at all. PA-API v5 (AWS Signature V4) is Amazon’s older method; if you still have working PA-API credentials the plugin continues to support them. You can switch between any of these in the plugin admin without rebuilding your pages, so your site keeps earning through Amazon’s API transitions.

Do I need to manually maintain product lists or hunt for ASINs?

No. That is the point of search. Visitors type what they want and see live Amazon results filtered by brand, price, and condition. You never need to pick ASINs or keep a product list updated. Every click still carries your Associate tag, so you earn on whatever they decide to buy.

Why don’t I see the Condition, Merchant, and In-Stock filters on the Managed API?

On the Managed API path, the managed search data does not include per-item condition (new/used/refurbished), seller/merchant, or stock-availability detail, so the Condition, Merchant, and In-Stock filters would have no effect. To avoid showing controls that do nothing, they are hidden automatically when you use the Managed API. These filters remain available when you connect your own Amazon credentials (Creators API or PA-API v5), where Amazon provides that data.

Why don’t I see the Newest Arrivals and Featured sort options on the Managed API?

On the Managed API path, the managed search data does not include per-item release dates, so Newest Arrivals has no signal to sort by, and Featured matches the default Relevance order. To avoid offering sorts that do nothing, both are hidden automatically on the Managed API. They remain available when you connect your own Amazon credentials (Creators API or PA-API v5). The Customer Reviews sort remains available on the Managed API and is applied by Amazon’s own search when results are fetched.

Hide FAQ

2.29.1

• Fixed: The plugin’s warnings about a problem on your site were hidden on the screen where you enter an add-on licence key. A Managed API problem, an unsupported marketplace, and a Premium licence that has dropped back to free are now shown on that screen as they are everywhere else.
• Fixed: The free version could still show the List layout on some pages. List is a Premium layout, and the free version now shows the grid instead. A saved List setting is left as you set it and applies again once Premium is active.
• Note: Product Boxes 1.5.1, Comparison Tables 1.5.1 and Analytics 1.0.5 go with this release. Each of them now explains on that same licence screen why it will not run.

2.29.0

• Fixed: A product that cannot be loaded no longer vanishes from the page. A product box shows a placeholder card in its place, and a comparison table keeps the row instead of quietly dropping it.
• Fixed: Search no longer asks a visitor to change their search when the products could not be loaded at all. That message was only ever right for a search that genuinely had no matches.
• Added: When you are signed in as an administrator and looking at your own page, you now see the real reason a product could not be loaded and what to do about it. Visitors see one short, neutral line instead.
• Changed: The Amber, Yellow and Lime accents now use white button text on the front end, matching what the Appearance preview shows and the rest of the accent colours.
• Fixed: A site that has reached its Managed API limit no longer keeps asking for products it cannot get. It could previously go on making refused requests in the background all day. It now holds off until the limit resets, and in any case tries again within the hour, so a raised limit or an upgrade takes effect on its own. Use Test Connection on the API Credentials screen to check straight away.
• Changed: The two Managed API usage emails, the one at 80% of your limit and the one when the limit is reached, are no longer sent by the plugin. They went out through your own site’s mail, so on a site with no mail set up they never arrived and nothing said so. The dashboard notices for both are unchanged. Emails about your connection and about service problems still come from the plugin as before.
• Changed: A product that is temporarily unavailable and one that no longer exists now say different things, so a passing problem is not mistaken for a listing you need to replace.
• Fixed: A product Amazon cannot resolve now shows as unavailable every time it is displayed. It could previously come back as a half-filled product with a working buy button, pointing at something that is not there.
• Note: After you fix or replace an ASIN that was showing as unavailable, the page can take up to about fifteen minutes to catch up. Use Clear Cache on the plugin’s Cache screen to see the change straight away.
• Note: Update Product Boxes to 1.5.0 and Comparison Tables to 1.5.0 alongside this release. Both require this version.

2.28.0

• Changed: Product categories now follow your Amazon store. Instead of one fixed list, the shortcode builder offers every department your Amazon store publishes.
• Added: Sweden (amazon.se) as a supported marketplace when using your own Amazon credentials.
• Fixed: Restored premium categories that were missing from the shortcode builder.
• Fixed: The category list now updates as soon as you change marketplace, without reloading the page.
• Fixed: The category dropdown now scrolls instead of running off the screen.
• Removed: A category that appeared twice in the picker.
• Changed: Public pages no longer carry unused category data.

2.27.1

• Security: Product Boxes and Comparison Tables no longer print raw Amazon product data into the page. A product title that arrives from Amazon can contain markup, and on a page loaded with a debug parameter by a logged-in administrator that markup could run in the administrator’s browser. The debug output is gone, and both add-ons now encode product data so it cannot break out of where it is placed. Update the add-ons alongside the plugin: Product Boxes 1.4.2 and Comparison Tables 1.4.2.
• Security: The Analytics add-on now writes every column of a CSV export as plain text. Text that reaches the tracker could otherwise land in an export in a form that spreadsheet software opens as a formula rather than as text. Ordinary data exports the same as before. Requires Analytics 1.0.2.
• Security: With OAuth debug logging switched on, your Amazon access token is now replaced with a placeholder before anything is written to the debug log. This covers both the Test Connection check and the normal token exchange. Debug logging stays off unless you switch it on.
• Removed: A debug URL parameter that cleared a stored display-settings value when a logged-in administrator loaded any page carrying it. The plugin no longer recognizes that parameter.
• Fixed: In Product Boxes and Comparison Tables, product data now reaches the page exactly as Amazon sends it. Titles containing escaped characters, and Amazon links carrying several parameters, are no longer altered on the way to the page. A product title on one of your pages may read differently after you update the add-ons, and this is why.

2.27.0

• Fixed: Sites without an active Premium license were still rendering Premium appearance settings instead of the free preset. After updating, those sites show the free appearance preset. Your saved settings are not deleted, and they apply automatically once Premium is active.
• Fixed: Saving on the Appearance screen could overwrite a stored custom button text or Amazon icon setting on a site without an active Premium license.
• Fixed: The Appearance screen’s live preview showed stored values rather than what the site actually renders.
• New: The admin now tells you which appearance settings need an active Premium license, in a notice and on the Appearance screen itself.

2.26.2

• Compatibility: Confirmed compatible with WordPress 7.1. The plugin and its add-ons were checked against the WordPress 7.1 release candidate: activation, every admin screen, the [psfa_search] shortcode on the front end, the block editor, and pages built with a page builder all behave as expected. “Tested up to” now reads 7.1.
• Fixed: The plugin download no longer contains stray .DS_Store files. Those are hidden metadata files macOS creates on its own, and they were ending up inside the ZIP. They had no effect on the plugin. They simply should not have been in the download.
• This release is a compatibility and packaging update. Nothing about how the plugin behaves has changed.

2.26.1

• Docs: Added premium installation instructions. Premium is a separate ZIP that replaces the free plugin rather than sitting alongside it, so the documented steps are now to deactivate and delete the free version first, then install the premium ZIP and activate your license.
• Docs: Documented the duplicate-copy conflict. Leaving a second copy of the plugin in a differently named folder, for example after unzipping the premium build by hand or uploading it over FTP, makes activation fail with “Plugin could not be activated because it triggered a fatal error.” The installation steps now explain how to avoid it and how to recover.
• Docs: Corrected the documented admin menu location. The plugin’s screens live under the top-level PaapiPlugin PSFA menu in the WordPress admin sidebar, not under Settings.
• This release changes documentation only. Nothing about how the plugin behaves has changed.

2.26.0

• Fixed: Some saved non-US marketplaces were ignored and searches were served from the US store instead. If your marketplace was stored as, for example, “amazon.de” rather than “www.amazon.de”, you got US products, US prices, US availability and US links, with nothing on screen to tell you. Both product search and the autocomplete suggestions were affected.
• Fixed: Your marketplace is now checked when you save it and stored in the form the plugin expects. A marketplace the plugin does not recognize is refused at save time instead of quietly falling back to the US store.
• New: A warning when your saved marketplace is one the plugin does not support, telling you that your site is being served US data and how to correct it.
• Changed: If your saved marketplace is one the plugin does not support, saving your credentials is now refused until you choose a supported one. This includes the case where the only thing you meant to change was your Associate Tag.
• Fixed: Changing your Associate Tag now clears the cached product data and the top-products grid. Previously that grid could keep sending visitors to Amazon under your previous tag for up to six hours.
• Fixed: Signing up for the Managed API on a site that already had its own Amazon credentials looked like it worked but left the old credentials serving your searches, with nothing to indicate it. You now get a confirmation of which one is serving searches and a “Switch to Managed now” button. This applies to both the Credentials screen and the setup wizard.
• Fixed: Smaller admin fixes: clearer entry labels on the Cache screen, corrected alert icon alignment, and the page now scrolls back to the top after you save your credentials so you can see the result.

2.25.0

• Fixed: Non-US marketplaces now return products from the correct Amazon store. Search results, product links, autocomplete suggestions, and the links in Product Boxes and Comparison Tables all follow the marketplace you have configured.
• Fixed: Category filters that Amazon rejected now work. Home & Garden, Grocery, Movies & TV, Sports & Outdoors, Tools & Home Improvement and Home Improvement were sent under names Amazon does not recognize, which returned a “Request validation failed” error instead of results.
• Fixed: Changing your marketplace no longer serves cached results from the previous store.
• Fixed: The “quota exhausted” notice now clears once your quota resets, instead of staying on screen for up to a week.
• Fixed: The Managed API connection notice now clears once the problem is fixed, and it appears on the Credentials screen where you would fix it.
• New: A warning when your Associate Tag does not match your selected marketplace. Amazon rejects that combination with a message that never mentions the tag.
• Fixed: The Shortcode Builder produced category values the plugin did not accept for Home & Garden, Movies & TV, Sports & Outdoors and Tools & Home Improvement, so those widgets showed an “unrecognized category” error. Shortcodes you already saved with those values now work too, without editing your pages.
• Changed: On the Managed API, Product Boxes and Comparison Tables no longer show price or discount. This matches the search widget, which already worked that way on that path. Nothing changes if you use your own Amazon credentials.

2.24.0

• Fixed: multiple [psfa_search] shortcodes on the same page could all display the first widget’s results due to shared page-URL query state. Each widget now renders its own query independently.

2.23.0

• Fix: The Shortcode Builder no longer adds an internal “default” placeholder to the Category and Sort attributes when the default option is selected.
• Fix: The [psfa_search] search now loads and displays products when the shortcode is placed with a page builder (Elementor, Divi, Bricks, WPBakery), not just the native WordPress editor.
• Fix: The search widget is now more resilient to theme style conflicts. Buy-button links no longer appear underlined, filter and sort controls keep their intended styling, and product text stays readable (no more inherited theme colors) when the widget is used with page-builder or heavily-styled themes. Your own Customize > Additional CSS still takes priority.

2.22.2

• Maintenance: Added plugin homepage links (paapiplugin.com) for docs, live demos, and support.

2.22.1

• Maintenance: Updated the bundled Freemius SDK (licensing and plugin-update framework).

2.22.0

• New: Guided setup wizard walks you through connecting your Amazon credentials and running your first product search.
• Maintenance: Internal updates and minor fixes.

2.21.4

• Maintenance: Internal updates and minor fixes.

2.21.3

• Improvement: Added a full setup walkthrough video to the Features tab.
• Improvement: Updated the Creators API credential setup guide video.

2.21.2

• Maintenance: Updated the bundled Freemius SDK (licensing and plugin-update framework).

2.21.1

• Fix: The Manage Credentials admin tab now opens to the currently-activated API path.

2.21.0

• New: Before activating the Managed API (Beta), you now review a short acknowledgement of how the Managed path sources Amazon data and confirm it with a required checkbox. Your acknowledgement is recorded with the signup.
• Improvement: The Managed API (Beta) signup panel was reorganized into a single, clearer setup card, grouping the acknowledgement, email field, and email opt-in together.

2.20.0

• Compliance: On the Managed API path, product price and availability are no longer displayed. The buy button is now a fixed “Check price on Amazon” call-to-action that sends visitors to Amazon for the current price, keeping this path aligned with Amazon’s Associates program requirements. Bring-your-own-credentials paths (Creators API and PA-API) are unchanged and still show price.
• Compliance: On the Managed API path, the price range filter and price sorting options are hidden, since price is not shown on that path.
• Admin: When the Managed API is active, the button text setting is locked to the compliant call-to-action with an explanatory notice.
• Fix: Switching the active API path (for example from your own credentials to the Managed API) now clears the search and product cache, so previously cached prices can no longer appear on the Managed API path.

2.19.1

• Improvement: The Managed API 80% usage warning can now also reach you by email through our newsletter (for sites opted in to email updates), in addition to the in-dashboard notice.

2.19.0

• New: Managed API usage warning. When you reach 80% of your monthly Managed API searches, the plugin shows an admin notice and sends one heads-up email. Free sites get an upgrade prompt; Premium sites get a reminder that switching to your own Amazon credentials removes the monthly cap.
• Improvement: The plugin now sends your site URL to the Managed API at signup so usage can be attributed to your site. No end-visitor data is sent.

2.18.0

• Improvement: Premium users browsing the Top Products Grid with their own Amazon credentials (Creators API or PA-API) now load more pages of results instead of stopping after the first set. The grid fetches additional products as you browse, up to Amazon’s page limit. The Managed API and free tier are unchanged.

2.17.1

• New: The in-plugin Features admin page now lists the Top Products Grid and Managed API (Beta) free features, and the storefront filter list now includes availability.
• Improvement: Documentation and listing copy updates for the Managed API and Top Products Grid.

2.17.0

• New: Managed API option in Credentials settings. Real-time Amazon product search without setting up your own Amazon API credentials. Get started in 30 seconds, 20 searches/day free on the free tier, your Amazon Associate tag stays yours.
• New: 3-tab Credentials UI (Managed API, Creators API, PA-API v5). Existing customers land on their configured tab with zero churn.
• New: Encrypted at-rest storage for managed API keys (AES-256-GCM). The raw key never reaches the browser.
• New: Per-month usage panel for managed-API users (current month, last 7 days, recent errors).
• New: Automatic failover to bring-your-own-credentials when the managed API has an outage, if both are configured.
• New: Optional product-update email opt-in in Credentials settings. When you request a Managed API key, an unchecked-by-default checkbox lets you subscribe to product tips and updates. Leaving it unchecked subscribes you to nothing. Your Amazon Associate tag is never affected either way.
• Improvement: Admin banner and email notifications when the managed API hits a quota, auth, or outage state. Visitor-facing search returns empty per WordPress.org compliance.
• Improvement: The Managed API is now labelled “Beta” in the Credentials UI so its status is clear while we expand capacity.
• Improvement: WordPress.org Plugin Check compliance fixes for a cleaner, standards-aligned codebase.

2.16.0

• Premium: discount filters available as shortcode attributes (min_saving_percent, has_deal)

2.15.3

• Fix: Lowercase category names in [psfa_search] shortcode (e.g. category=electronics) now resolve identically to canonical-cased names. Previously triggered a premium-category gate after clicking the search reset button.
• Fix: Premium-category upgrade prompt now renders as a styled card instead of escaped HTML markup. Backend ships structured data; frontend renders via shadcn Alert.
• Improvement: pagination and sort shortcode attributes now accept any case (Load_More, LOAD_MORE, load_more all work). Search query and brand attributes remain case-sensitive (Amazon search semantics).

2.15.2

• Improved: Test Connection now surfaces full diagnostic details (HTTP status, Amazon error code, request ID, environment versions) when authentication fails. Failures include a Copy diagnostic button to streamline support cases. The plugin secret is never included in the diagnostic block.

2.15.1

• Fixed: Test Connection for Creators API v3.x credentials. The “Test Connection” admin button was using the legacy v2.x Cognito endpoint regardless of credential version, causing a misleading invalid_client error for valid v3.1/3.2/3.3 credentials. Test Connection now routes by credential version and matches the runtime OAuth path.

2.15.0

• Fixed: Creators API “invalid_client” token error when using v3.x credentials. Plugin now supports v2.x and v3.x credentials side-by-side, routing the OAuth token request by major credential version.

2.14.1

• Improved: WordPress.org listing – rewritten tags, description, features, and FAQ for clarity and discoverability

2.14.0

• Added Mailchimp email drip integration for new user onboarding
• Server-side subscribe proxy for secure Mailchimp API communication
• Freemius opt-in hook sends new user emails to onboarding sequence

2.13.2

• New: Leave a review hook when credentials configured

2.13.1

• Improved: WordPress.org listing – rewritten tags, description, features, and FAQ for clarity and discoverability

2.13.0

• New: Analytics addon support – track searches, clicks, impressions, and filter usage with admin dashboard

2.12.3

• Improved: Frontend search and pagination stability
• Fixed: Potential race condition when changing search queries rapidly

2.12.2

• New: Analytics add-on support – track searches, clicks, impressions, and filter usage with an admin dashboard
• Fixed: Admin menu now appears as a top-level menu item in the WordPress sidebar

2.12.1

• Fixed: Sort filter (NewestArrivals/AvgCustomerReviews/Featured) not updating results when query + brand filter are both active
• Fixed: Frontend showing stale results briefly when search query changes
• Fixed: Cache page time formatting showing raw hours instead of days/weeks/months

2.12.0

• Improved: Price range filter now uses a dual-thumb slider in a popover, consistent with other filter controls

2.11.0

• New: API response caching – search results cached 30 minutes, product data cached 1 hour (WordPress transients)
• New: Unified product cache across all addons (single cache per ASIN)
• New: Dedicated Cache management page with cached items table, sorting, filtering, and creation timestamps
• New: Auto-invalidation when marketplace or associate tag changes
• Improved: Addon AJAX uses get_items() instead of search_items() for known-ASIN lookups
• Improved: Addon premium enforcement (admin notice + shortcode gate + AJAX gate + no frontend assets)

2.10.0

• Major: Complete UI modernization with React 19, shadcn/ui components, and Tailwind CSS v4
• Major: Entire frontend rebuilt in React with build-time server-side rendering (SSR) for instant loading
• Major: New 6-axis appearance system replacing the old fixed theme + color picker model
• New: 5 base color palettes (Neutral free, Stone, Slate, Zinc, Gray premium)
• New: 17 accent colors from Tailwind’s chromatic palette
• New: 5 card styles (Vega, Nova, Maia, Lyra, Mira)
• New: 5 border radius levels (None, Small, Medium, Large, Full)
• New: Dark mode toggle for any base color
• New: 15 Google Fonts plus system default for typography customization
• New: Hide Amazon Icon toggle for product cards
• New: Unified Appearance page replacing separate Themes and Customization pages
• New: Product Boxes add-on fully rendered with React (was vanilla JS)
• New: Comparison Tables add-on fully rendered with React (was vanilla JS)
• New: shadcn/ui admin components (Dialog, AlertDialog, Switch, Slider, Sonner toasts)
• Improved: Admin UI with react-router-dom v7 navigation
• Improved: 188 tests passing (Vitest + React Testing Library)
• Improved: All styling via Tailwind CSS v4 utility classes (754-line style.css removed)
• Removed: css-generator.php (replaced by static theme CSS files)
• Removed: Old fixed themes (Ocean Blue, Modern, Minimal, Amazon Inspired) replaced by 6-axis system
• Removed: Per-theme color picker customization (replaced by accent color axis)
• Removed: Card Layout feature
• Removed: Vanilla TypeScript frontend widgets (replaced by React components)
• Removed: PHP frontend fallback (React-only rendering)

2.9.2

• New: count shortcode attribute to control product display count (2-20)
• New: Product count slider in Shortcode Builder (shows when pagination=”none”)
• New: “Flexible Product Count” added to Features list

2.9.1

• Refactor: HTML structure consolidation – single source of truth for product cards
• New: psfa_render_product_card() function for consistent product card rendering
• Improved: AJAX now returns pre-rendered HTML + JSON (progressive enhancement)
• Improved: Frontend bundle size reduced from ~13KB to ~10KB
• Improved: Addon hooks now work automatically for AJAX-loaded products
• New: Design token system with CSS custom properties
• Improved: Tailwind CSS v4 migration complete
• New: Visual regression testing with 26 Playwright tests

2.9.0

• Major: Full React+TypeScript migration complete
• New: React admin UI with react-router navigation (9 pages)
• New: TypeScript frontend widgets (Autocomplete, InfiniteScroll, Countdown, FiltersToggle, ClearButton)
• New: Unified /src project structure
• New: Shared utility library
• Improved: 85 tests passing (Vitest + React Testing Library)
• Improved: Type safety across entire codebase

2.8.3

• Improved: Welcome video ID now filterable via psfa_welcome_video_id hook

2.8.2

• Improved: Disabled browser autocomplete on API credentials inputs

2.8.1

• New: Welcome section with setup video for new users on API Credentials page
• Improved: Video player with custom thumbnail and auto-reset on finish

2.8.0

• New: White-label mode – Premium users can remove “Powered by PSFA” branding
• New: “Powered by PSFA” branding link on frontend search results
• New: White-label toggle in Layout → Display Options (Premium)

2.7.0

• New: Comparison Tables add-on support – create product comparison tables with winner badges
• New: Winner Highlighting badges (Best Value, Editor’s Choice, Best Rated, Budget Pick, Premium Pick)
• New: Responsive table options – stack (cards) or scroll on mobile devices
• New: Custom button text support for comparison tables
• Improved: Documentation updates for add-on shortcode attributes

2.6.0

• New: Add-on support infrastructure – hooks and filters for extending plugin functionality
• New: Product Boxes add-on compatibility – display individual Amazon products with shortcodes
• New: Admin navigation system for add-on sections
• Improved: Plugin architecture to support modular add-ons

2.5.0

• Improved: CSS architecture refactored – base styles in style.css, themes contain only color overrides
• Improved: Product card alignment – titles now use line-clamp for consistent card heights
• Improved: Title hover tooltip shows full product name when truncated
• New: Countdown badge shimmer animation effect for time-limited deals
• New: Theme-specific badge colors for all themes (Ocean Blue, Modern, Minimal, Dark, Amazon Inspired)
• Fixed: Badge color overrides now properly apply in all themes

2.4.0

• New: Display Options settings – Hide Search Bar, Hide Filters, Hide Category Banner toggles in admin
• New: Shortcode overrides – Display options can be overridden per-page using shortcode attributes
• New: Shortcode builder – Added Hide Category Banner toggle to Display Options card
• Improved: Settings priority system – URL params > shortcode attributes > admin settings
• Fixed: Admin settings now properly apply when no shortcode attributes are provided

2.3.1

• Fixed: Price filter consistency – Initial page load now sends minPrice/maxPrice to Creators API
• Fixed: Creators API 404 handling – No results now gracefully shows empty state instead of error

2.3.0

• New: OffersV2 API Migration – Full migration from OffersV1 to OffersV2 for enhanced deal data
• New: OAuth 2.0 / Creators API authentication support with admin UI selector
• New: Test Connection button in credentials settings to validate API credentials
• New: Auth type selector – Choose between OAuth 2.0 (Creators API) or AWS Sig V4 (legacy PA-API)
• New: Has Deal filter – Filter products to show only items with active deals
• Improved: Badge & Deal Settings moved to Layout section with consistent UI
• Improved: Badge toggles now match Filter Visibility design (2-column grid, clickable rows)

2.2.1

• Added: Info tooltips throughout admin settings for better guidance
• Improved: Admin interface polish and styling refinements

2.2.0

• Added: New Tailwind CSS admin interface with modern styling
• Added: Comprehensive test suite (256 tests, 64% coverage)
• Fixed: Demo panel styling and layout issues
• Fixed: Card selection border states in admin
• Improved: WordPress.org compliance – removed CDN dependencies
• Improved: Code quality and maintainability

2.1.3

• Added: Stock status filter (In Stock Only, All Items, Out of Stock Only)
• Added: Filter visibility settings – choose which filters to show/hide in the search interface
• Fixed: Filter parameters now correctly propagate to URL on form submission

2.1.2

• Fixed: Price sorting now correctly handles products with sale/original prices
• Fixed: Sorting accuracy when brand filter is applied
• Changed: Renamed “Pro” to “Premium” in upgrade notices

2.1.1

• Changed: Shortcode renamed from [product_search_for_amazon] to [psfa_search] for WordPress.org compliance
• Updated: All documentation and shortcode builder to use new shortcode name

2.1.0

• Added: Product Badges premium feature card in Features tab
• Added: Shortcode Builder admin tab with visual shortcode generator
• Added: Info tooltips to Customization and Shortcode tabs for better UX
• Fixed: WordPress coding standards compliance
• Improved: Plugin zip file structure

2.0.6

• Restructured: Plugin folder organization (includes → core) for better maintainability and add-on support
• Improved: Filters now always visible when hide_search=”true” shortcode attribute is used
• Fixed: Asset paths after folder restructure

2.0.5

• Fixed: White page issue on production sites when applying filters
• Fixed: JavaScript error with lightbox initialization before DOM ready
• Improved: POST form redirect now runs early via template_redirect hook for faster response

2.0.3

• Fixed: All CSS class prefixes updated to psfa- (WordPress.org compliance)
• Fixed: All option names updated to psfa_ prefix
• Fixed: All AJAX action hooks updated to psfa_ prefix
• Fixed: JavaScript localization variable renamed to psfaAjax
• Improved: Complete prefix standardization across all plugin files

2.0.2

• Fixed: Inline scripts and styles now use proper WordPress enqueue functions
• Fixed: Nonce verification now uses proper sanitization
• Fixed: All function prefixes updated to PSFA_ (4+ characters)
• Improved: WordPress.org compliance for plugin guidelines
• Updated: External services documentation
• Updated: Source code documentation for minified JS

2.0.1

• Fixed: Category limits enforced correctly in free version (5 categories)
• Fixed: Pagination limits enforced correctly in free version (5 pages)
• Fixed: Upgrade notice displays properly for premium categories
• Improved: Build system for free/premium version separation

2.0.0

• Added premium theme system with 4 additional themes (Ocean Blue, Modern, Minimal, Dark)
• Added list display mode for premium users
• Added comprehensive customization options: custom colors, button customization, card layouts, font customization
• Added all 26 Amazon categories for premium users
• Added unlimited pagination for premium users (up to Amazon’s 10-page limit)
• Added hide category banner option
• Improved admin interface with tabbed navigation
• Enhanced CSS generation system for dynamic customizations
• Refined PA‑API filtering support for brand, condition, and merchant
• Stabilized the interaction between price range filters and all sort options
• Improved infinite scroll behaviour with better pagination handling
• Polished the responsive UI (mobile and desktop)
• Added comprehensive PHPUnit test suite
• Updated architecture to follow DRY/SOLID principles

1.5.0

• Introduced advanced sorting options (Relevance, Price Low → High / High → Low, Newest Arrivals, Average Customer Reviews, Featured).
• Added client‑side sorting fallbacks when PA‑API sorting is not available for a given filter combination.
• Improved integration between brand filtering and sorting so that the overall product list remains globally sorted across AJAX pages.

1.4.0

• Added support for condition and merchant filters mapped to PA‑API parameters where available.
• Improved “no products found” messaging to distinguish between genuine empty results and API errors.
• Hardened error handling for PA‑API HTTP failures and invalid parameter responses.

1.3.0

• Reworked infinite scroll to better respect Amazon’s 10‑page ItemPage limit and to avoid repeated empty page requests.
• Added an explicit upgrade notice when the free plan’s page limit is reached, with a link to upgrade to the premium version.
• Improved pagination logic to ensure filters and sorts are preserved across AJAX requests.

1.2.0

• Enhanced the price range filter with more robust parsing and inclusive min/max boundaries.
• Ensured price filtering works consistently between the initial page load and subsequent AJAX loads.
• Fixed several edge cases where items without prices or with unusual formats could slip through filters.

1.1.0

• Introduced the brand dropdown filter with dynamic options based …