Everything you need to install, configure, and get the most out of WorkmanLinks.
.zip file from your account or the free download link.Amazon's new Creators API uses OAuth 2.0 authentication and is the recommended connection method. Amazon has deprecated PA-API 5.0 in favor of this new API.
2.1 — North America (US, CA, MX, BR)2.2 — Europe (UK, DE, FR, ES, IT, NL, SE, PL, BE, TR, AE, SA, EG)2.3 — Far East (JP, AU, SG, IN)PA-API 5.0 uses AWS Signature V4 authentication. WorkmanLinks supports this as a fallback for accounts that haven't transitioned to the Creators API yet.
Displays a product image with an affiliate link. Lazy-loaded, responsive, and cached.
[wml asin="B08N5WRWNW"]
| Parameter | Required | Description |
|---|---|---|
asin | Yes | Amazon product ASIN |
Full product card with image, title, feature bullets, price, and buy button. Supports light and dark themes.
[wml_box asin="B08N5WRWNW" template="light"]
| Parameter | Required | Default | Description |
|---|---|---|---|
asin | Yes | — | Amazon product ASIN |
template | No | light | Card theme: light or dark |
Display any product from the multi-network Product Manager. Supports products from Amazon, Avantlink, Impact, ShareASale, CJ, Rakuten, AWIN, Partnerize, and Refersion.
[wml_product slug="fishing-rod" style="box"]
| Parameter | Required | Default | Description |
|---|---|---|---|
slug | Yes | — | Product slug from the Product Manager |
style | No | box | Display style |
Auto-generate a responsive product grid filtered by category, network, or count.
[wml_products category="Fishing" count="4"]
| Parameter | Required | Default | Description |
|---|---|---|---|
category | No | All | Filter by product category |
count | No | 4 | Number of products to display |
network | No | All | Filter by affiliate network |
AI Auto Mode uses AI to analyze your post content, extract relevant keywords, and automatically insert matching affiliate product displays. Set it once and products appear in your content as you publish.
Go to Settings → WorkmanLinks → Auto Mode tab to configure:
Automatically converts keywords in your content into affiliate links. No need to manually add links — the Auto-Linker handles it based on your configured keyword-to-link mappings.
Go to Settings → WorkmanLinks → Keywords tab to manage your keyword mappings.
The Product Manager lets you store and manage affiliate products from any network — not just Amazon. Add products from Avantlink, Impact, ShareASale, CJ, Rakuten, AWIN, Partnerize, and Refersion, then display them using shortcodes.
[wml_product slug="your-slug"] to display it.Uses the Perplexity AI API to discover trending topics and news in your niche. Great for finding content ideas that pair well with affiliate products.
WML_PERPLEXITY_API_KEY in wp-config.php.
The validator uses AI to verify that auto-inserted products are actually relevant to your content. No more random kitchen gadgets showing up in your fishing article.
When enabled, the validator runs as a second pass after Auto Mode inserts products. Irrelevant products are removed before the page is served to visitors.
Switching from another affiliate plugin? WorkmanLinks can read common shortcode formats natively, so your existing content keeps working with zero downtime.
WorkmanLinks uses a two-tier caching system to minimize API calls and keep your site fast.
Go to Settings → WorkmanLinks → Cache tab to:
WorkmanLinks includes a full diagnostics system to help you troubleshoot issues and verify everything is working correctly.
Go to Settings → WorkmanLinks → Diagnostics tab to access:
WorkmanLinks logs API errors and important events to help with debugging:
| Issue | What to Check |
|---|---|
| Products not displaying | Run Connection Test. Check API credentials are entered correctly. |
| Stale product data | Clear the cache in the Cache tab, then reload the post. |
| OAuth token errors | Verify Credential ID and Secret. Check that your API Version matches your region. |
| Images not loading | Check that your wp-content/uploads/ directory is writable. |
| Auto Mode not inserting products | Verify OpenAI API key is set. Check the Auto Mode tab for configuration. |
WP_DEBUG and WP_DEBUG_LOG in wp-config.php. WorkmanLinks writes detailed error information to wp-content/debug.log.
You can hardcode API credentials in wp-config.php instead of storing them in the database. This is useful for version-controlled environments or when you want to keep credentials out of the WordPress admin.
// Amazon Creators API (recommended)
define('WML_CREATORS_CREDENTIAL_ID', 'your-credential-id');
define('WML_CREATORS_CREDENTIAL_SECRET', 'your-credential-secret');
define('WML_CREATORS_VERSION', '2.1'); // 2.1=NA, 2.2=EU, 2.3=FE
define('WML_AWS_PARTNER_TAG', 'yoursite-20');
// Amazon PA-API 5.0 (legacy fallback)
define('WML_PAAPI_ACCESS_KEY', 'your-access-key');
define('WML_PAAPI_SECRET_KEY', 'your-secret-key');
define('WML_PAAPI_PARTNER_TAG', 'yoursite-20');
// OpenAI — for AI Auto Mode & Keyword Extraction (Pro)
define('WML_OPENAI_API_KEY', 'sk-...');
// Perplexity — for Trending News Harvester (Pro)
define('WML_PERPLEXITY_API_KEY', 'pplx-...');
// Freemius Dev Mode — for testing license activation
define('WP_FS__DEV_MODE', true);
The Advanced tab (Settings → WorkmanLinks → Advanced) contains additional configuration options:
No. You only need one. We recommend the Creators API (OAuth 2.0) since it's Amazon's current standard. PA-API 5.0 is supported as a fallback for existing setups.
No. Pro-only shortcodes like [wml_product] will simply not render on the free plan — they won't cause errors or break your pages. If you upgrade again, they'll start working immediately.
Very few, thanks to the 24-hour smart cache. Each unique ASIN triggers one API call, then serves from cache for 24 hours. Returning visitors never trigger additional API calls.
Yes. WorkmanLinks shortcodes work anywhere WordPress shortcodes are supported — Gutenberg, Classic Editor, Elementor, Divi, Beaver Builder, and more.
Yes. WorkmanLinks follows Amazon's affiliate program operating agreement. Product data is cached appropriately, prices are displayed according to Amazon's guidelines, and affiliate disclosures can be configured.
Yes. The Agency plan supports unlimited sites, including WordPress multisite installations.
Need help? Here's how to reach us:
When contacting support, please include: