← Back to Docs

Troubleshooting

Solutions for the most common issues you might encounter while using AmzLinkr.

"No products found" When Searching

If the product search modal returns no results, check the following:

  • API keys are correct — Go to AmzLinkr → Settings → API and verify your Access Key, Secret Key, and Associate Tag. A typo in any of these fields will prevent searches from working.
  • API access is active — Log in to your Amazon Associates account and check the PA API section under Tools. Your API access may have been revoked if your Associates account was not approved or if you violated Amazon's terms.
  • Rate limiting — New Amazon Associates accounts have a very low API rate limit (as low as 1 request per second). If you have been making many searches in quick succession, wait a minute and try again.
  • Correct locale — Make sure the Amazon locale selected in Settings matches your Associate Tag. A US tag will not work with the Amazon.de endpoint.
  • Product availability — Some products are not available through the PA API, or the search terms may not match any products. Try searching by ASIN instead of keywords.

Prices Not Updating

If product prices appear stale or outdated, investigate the following:

  • Price sync is a Pro feature — The free version of AmzLinkr does not include automatic price sync. Prices are captured at the time of product import and are not updated automatically. Upgrade to Pro to enable daily price sync.
  • WP-Cron is working — AmzLinkr Pro uses WordPress cron (WP-Cron) to schedule daily price updates. If your site has low traffic, WP-Cron may not fire frequently enough. Consider setting up a real cron job on your server. Add this to your server's crontab: */15 * * * * wget -q -O /dev/null https://yoursite.com/wp-cron.php And add this to your wp-config.php: define('DISABLE_WP_CRON', true);
  • PA API rate limits — If you have many products, the daily sync may hit your API rate limit. AmzLinkr spreads requests across the sync window, but accounts with very low rate limits may not be able to sync all products in a single run. Generating more sales through the Associates program will increase your rate limit.
  • Product unavailable — Amazon sometimes removes products from the PA API. If a specific product's price shows as empty, the product may have been discontinued or delisted. Search for it again to see if it is still available.

Blocks Not Appearing in the Editor

If AmzLinkr blocks do not show up when you search for them in the Gutenberg block inserter:

  • Gutenberg is required — AmzLinkr blocks only work with the WordPress block editor (Gutenberg). If you are using the Classic Editor plugin, AmzLinkr blocks will not be available. Disable the Classic Editor to use AmzLinkr, or use the Classic Editor only for specific post types while keeping Gutenberg for posts where you need product blocks.
  • Plugin is activated — Verify that AmzLinkr is activated in Plugins → Installed Plugins. If the plugin was recently updated, deactivate and reactivate it to ensure all block registrations are refreshed.
  • Plugin conflicts — In rare cases, another plugin may conflict with AmzLinkr's block registration. To test, temporarily deactivate all other plugins and switch to a default WordPress theme (like Twenty Twenty-Four). If the blocks appear, reactivate your plugins one by one to identify the conflict.
  • WordPress version — AmzLinkr requires WordPress 6.0 or higher. Check your WordPress version in Dashboard → Updates and update if necessary.
  • PHP version — AmzLinkr requires PHP 8.0 or higher. Check your PHP version in Tools → Site Health → Info → Server. Contact your hosting provider to upgrade PHP if needed.

License Activation Issues

If you are having trouble activating your Pro license key:

  • Check the license key format — License keys are 32-character hexadecimal strings (letters a-f and numbers 0-9). Make sure you copied the entire key without extra spaces or characters.
  • URL normalization — AmzLinkr normalizes your site URL for activation. https://www.example.com and https://example.com are treated as the same site. However, http:// and https:// are also treated as equivalent. Subdomains are treated as separate sites.
  • Site limit reached — If you see "Maximum activations reached", you have used all the site slots in your license. Go to your account dashboard to deactivate a site before activating a new one, or upgrade to a higher-tier plan.
  • License expired — Pro licenses are annual subscriptions. If your subscription has expired, you need to renew it before you can activate or use Pro features. Check your subscription status in your account dashboard.
  • Server connectivity — License activation requires your WordPress server to communicate with the AmzLinkr license server (api.amzlinkr.com). If your server's firewall blocks outbound HTTPS requests, activation will fail. Contact your hosting provider to ensure outbound HTTPS traffic is allowed.

Product Display Looks Broken

If product blocks render with incorrect styling or layout issues:

  • Theme CSS conflicts — Some themes apply aggressive global styles that may override AmzLinkr's block styles. Try switching to a default WordPress theme to confirm. If the issue is theme-specific, you may need to add a small CSS override in your theme's customizer.
  • Caching — If you recently updated AmzLinkr, your browser or server cache may be serving old CSS files. Clear your browser cache, your WordPress cache plugin (if any), and any CDN/server-level cache.
  • CSS optimization plugins — Plugins that minify, combine, or defer CSS may interfere with block styles. Try excluding AmzLinkr's CSS from optimization, or temporarily disable the optimization plugin to test.

Still Need Help?

If your issue is not covered here, contact our support team at support@amzlinkr.com. Please include your WordPress version, PHP version, the error message you see, and any steps you have already tried. Pro subscribers receive priority support with faster response times.