Getting Started with AmzLinkr

1. System Requirements

Before installing AmzLinkr, make sure your WordPress environment meets the following requirements:

• WordPress 6.0 or higher — AmzLinkr uses the Block API v3, which requires WordPress 6.0+. We recommend running the latest version of WordPress for the best experience and security.
• PHP 8.0 or higher — The plugin uses modern PHP features including typed properties, named arguments, and match expressions. PHP 8.1 or 8.2 are recommended for optimal performance.
• An Amazon Associates account — You need an active Amazon Associates account to generate affiliate links. If you don't have one yet, you can sign up at affiliate-program.amazon.com.
• Amazon PA API access — To use the product search and automatic price sync features, you need access to the Amazon Product Advertising API 5.0. This requires a separate application after creating your Associates account.

AmzLinkr is compatible with all well-coded WordPress themes, including popular options like Astra, GeneratePress, Kadence, OceanWP, and all default WordPress themes. It works alongside page builders such as Elementor, Beaver Builder, and Spectra, though the blocks themselves are Gutenberg-only.

2. Installation

Option A: Install from the WordPress Plugin Directory

1. In your WordPress admin, go to Plugins → Add New.
2. Search for "AmzLinkr" in the search bar.
3. Click Install Now next to the AmzLinkr plugin.
4. Once installed, click Activate.

Option B: Manual Upload

1. Download the AmzLinkr plugin ZIP file from your account dashboard or the WordPress plugin directory.
2. In your WordPress admin, go to Plugins → Add New → Upload Plugin.
3. Choose the ZIP file and click Install Now.
4. Once installed, click Activate.

After activation, you will see a new "AmzLinkr" menu item in your WordPress admin sidebar. This is where you will configure the plugin and manage your products.

3. Initial Configuration

Navigate to AmzLinkr → Settings in your WordPress admin. The settings page has several tabs, but the most important one for initial setup is the API tab.

Entering Your API Keys

You need three pieces of information from your Amazon Associates account:

1. Access Key — Your PA API access key ID. This is a 20-character alphanumeric string.
2. Secret Key — Your PA API secret access key. This is a 40-character string. Keep it confidential.
3. Associate Tag — Your Amazon Associates tracking ID, typically in the format "yoursite-20".

Enter these values in the corresponding fields on the API tab and click Save. AmzLinkr will validate the credentials by making a test request to the Amazon API. If the credentials are valid, you will see a success message. If not, check the API Configuration guide for troubleshooting tips.

Selecting Your Amazon Locale

Choose the primary Amazon marketplace you want to pull products from. This determines which Amazon store is used for product searches and affiliate links. Available locales include Amazon.com, Amazon.co.uk, Amazon.de, Amazon.fr, Amazon.es, Amazon.it, Amazon.co.jp, Amazon.ca, Amazon.com.au, Amazon.in, Amazon.com.br, Amazon.com.mx, Amazon.nl, Amazon.sg, Amazon.sa, Amazon.ae, and Amazon.pl.

If you have AmzLinkr Pro with geotargeting enabled, the plugin will automatically redirect visitors to their local Amazon store regardless of this setting. The primary locale is used as the default for product imports and for visitors whose locale cannot be determined.

4. Creating Your First Product Display

With the API configured, you are ready to add your first product block to a post or page.

1. Create or edit a post/page in the WordPress block editor (Gutenberg).
2. Add a new block by clicking the + button or typing / in the editor. Search for "AmzLinkr" or "Product Box".
3. Insert the Product Box block. A search modal will appear, allowing you to search for Amazon products by keyword or ASIN.
4. Search for a product. Type a product name or paste an ASIN. AmzLinkr will query the Amazon PA API and display matching results with images, titles, and prices.
5. Select a product. Click on the product you want to display. AmzLinkr will import the product data (title, image, price, features, Prime status) and populate the block.
6. Publish or preview your post. The product box renders server-side, so the preview shows exactly what your visitors will see.

The Product Box displays the product image, title, current price, key features, a Prime badge (if applicable), and a customizable call-to-action button that links to the Amazon product page with your affiliate tag.

5. Configuring Global Settings

AmzLinkr provides global settings that apply to all blocks across your site. Navigate to AmzLinkr → Settings → Display to configure:

• Heading level — Choose between H2 to H6 for product titles. Defaults to H3.
• Default button text — The call-to-action text displayed on product buttons. You can customize this per block as well.
• Open links in new tab — Whether affiliate links open in a new browser tab. Recommended for user experience.
• Show prices — Toggle product prices on or off globally. Useful if you prefer to let Amazon display the price on their page.
• Show Prime badge — Display the Prime delivery badge on eligible products.
• Show features — Display the product feature bullet points in Product Box blocks.

These settings provide sensible defaults that you can override on individual blocks when needed. This makes it easy to maintain a consistent look across your site while still allowing per-block customization.

6. Upgrading to Pro

The free version of AmzLinkr includes the Product Box, Text Link, and Image blocks with basic click tracking. Upgrading to Pro unlocks:

• Comparison Table block — Create side-by-side product comparisons.
• Bestseller List block — Automatically display bestselling products by category.
• Automatic daily price sync — Prices and availability update automatically via WP-Cron.
• Geotargeting — Redirect visitors to their local Amazon store.
• Advanced analytics — Detailed click reports with per-product breakdown.
• Priority support — Faster response times from our support team.

To upgrade, visit the pricing page, choose your plan, and complete the checkout. You will receive a license key by email. Enter the license key in AmzLinkr → Settings → License to activate Pro features.