# Content Egg WP Plugin
All-in-one WordPress plugin for affiliate marketing, price comparison, and product content β with 30+ networks, product blocks, and automatic price updates.
[**Content Egg**](https://www.keywordrush.com/contentegg) is an all-in-one WordPress plugin for **affiliate marketing, price comparison, and product content**. It connects to 30+ affiliate networks and marketplaces, pulls live product data β prices, offers, ratings, images, and coupons β and keeps it up to date automatically. You display it with product blocks, comparison tables, price-history charts, and Egg Blocks built for how Google ranks and AI search cites.
{% hint style="info" %}
π **Get the plugin** β [**keywordrush.com/contentegg**](https://www.keywordrush.com/contentegg)
**New here?** Start with [Installation & Licensing](/getting-started/installation), then learn [how to add products](/set-up-products/how-to-add-products).
{% endhint %}
## Start here
**You should now see** the module active on the Modules screen, ready to search.
π Learn more: [**Modules**](/modules/general-information) Β· [**Feed modules**](/modules/feed-modules)
***
## Step 2 Β· Add products to a post
*Stage: **Publish** β attach real products to your content.*
Open a post (or create a new one) and find the **Content Egg** panel (the egg icon, top-right). Click **Search & add productsβ¦**, type a keyword, and click a result to attach it. Content Egg pulls in the title, image, price, and link for each product.
Search for products and attach them to your post
**You should now see** your chosen products saved to the post, with live prices and affiliate links.
π Learn more: [**How to add products**](/set-up-products/how-to-add-products) Β· [**Search & Import**](/set-up-products/import-tools/search-and-import)
***
## Step 3 Β· Display them
*Stage: **Publish** β turn the products into something readers act on.*
Choose how the products appear on the page:
* **CE Products block** β insert it, pick a template, and it shows your products (list, grid, comparison table, and more). Prices stay current on their own. Best when you're writing the article yourself and just want to show products.
* **Egg Blocks** β build a full review or roundup from editorial blocks (intro, comparison table, pros & cons, verdict, FAQ). Best for structured articles, and the format an AI assistant generates for you.
Display products with the Products block or Egg Blocks
**You should now see** your products rendered on the front end β publish the post and you have a working, monetized page.
π Learn more: [**Gutenberg product blocks**](/frontend/gutenberg-blocks) Β· [**Egg Blocks**](/egg-blocks/introduction)
***
## Step 4 Β· Scale it (when you're ready)
*Stage: **Scale** β do it in volume, or hands-off.*
Once your first page works, you can go faster:
* **Import tools** β create many product pages at once from keyword lists or feeds, and keep prices updated automatically.
* **Agent Access** β connect ChatGPT, Claude, or any AI assistant and ask it, in plain language, to find products and build whole pages for you. It saves drafts by default, so nothing goes live until you approve it.
Let an AI assistant find products and build pages for you
π Learn more: [**Import tools**](/set-up-products/import-tools) Β· [**Agent Access**](/ai-agents/ai-agents)
***
That's the whole workflow. From here, follow the linked guides for anything you want to go deeper on β or head straight to [**Agent Access**](/ai-agents/ai-agents) and let an assistant do the heavy lifting.
# Automatic updates
* Keep your **updates active** to avoid expiration and ensure seamless access to new features.
* You can renew your updates anytime via your [User Panel](https://www.keywordrush.com/panel).
* The default update period is **1 year**, with a **lifetime updates** option available if you prefer.
When a new update is released, youβll receive a notification directly in your **WordPress Admin Panel**.\
Update the plugin with a single click, just like any other WordPress plugin.
Always use the **latest version** to guarantee compatibility, security, and access to new features.
### Changelog
View detailed **release notes** and version history here:\
π Content Egg Pro β [**Changelog**](https://www.keywordrush.com/changelog/content-egg/readme.txt)
# General information
After installing the plugin, you'll need to activate the affiliate network or content source modules you'd like to work with. There are four module types:
1. Product modules
2. Feed modules
3. Media modules (images and videos)
4. Coupon modules
Go to `Content Egg > Modules` to activate the required modules.
Content Egg β Modules
To activate a module, fill in all the required fields (marked with an asterisk) and tick `Enable module`. See each module's documentation for help with its specific fields.
# Affiliate modules
# Aliexpress module
### How to get App Key and App Secret
Please follow [this guide](https://open.aliexpress.com/doc/doc.htm?nodeId=27493\&docId=118729#/?docId=1234) to register your **affiliate application** and generate your API credentials.
### How to get your Tracking ID
You need to set your Tracking ID if you want to send traffic through the Aliexpress portal.
1. Log in to your account at
2. Follow `Settings β Tracking ID`
### How to set Deeplink
You can also send traffic through any affiliate network with Aliexpress support (for example, [epn.bz](http://keywordrush.com/go/epnbz)).
{% content-ref url="/pages/-MTUXEKm5VcN0CRKILEW" %}
[Deeplink settings](/modules/deeplink-settings)
{% endcontent-ref %}
# Amazon module
The Amazon module lets you search and import products from Amazon Associates into Content Egg, keep product data up to date, and display them with Product Blocks and shortcodes.
### Important notes before you start
#### API access required
This module requires **active Amazon API access** (Creators API). If you donβt have API access yet, see [Alternatives to Amazon API](#alternatives-to-amazon-api-no-api-access-required) below.
***
### What you need
To use the Amazon module, you need:
1. **Associate Tag (Partner Tag)**
2. **Creators API credentials**: **Credential ID** + **Credential Secret**
{% hint style="info" %}
If you just created your API access, Amazon may take **24β48 hours** to fully activate it.
{% endhint %}
***
### How to get your Associate Tag
To obtain an Associate Tag, follow [Amazonβs guide](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/onboarding/sign-up-as-an-amazon-associate).
***
### How to get Credential ID and Credential Secret (Creators API)
Follow Amazonβs β[Register for Creators API](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/onboarding/register-for-creators-api)β guide.
After you create credentials:
* Credential Secret is shown only once (store it safely).
* Use the credentials in Content Egg β Modules β Amazon.
***
### Alternatives to Amazon API (no API access required)
If you donβt have API access, Content Egg still offers ways to add Amazon products:
1. **NoAPI Amazon module**\
Start with the [NoAPI module](/modules/affiliate/amazon-no-api-module) to publish links quickly and generate initial sales. Once you get API access, you can migrate to the Amazon API module.
2. **Affiliate Egg integration**\
Use the [Affiliate Egg plugin](https://www.keywordrush.com/affiliateegg) (direct parsing without Amazon API) and [connect it](/modules/affiliate-egg-integration#how-to-connect-ae-modules) with Content Egg.
3. **Offer module**\
[Add any product manually](/modules/affiliate/offermodule) (works for any store, including Amazon).
***
### Searching for products
Content Eggβs Amazon module supports several search methods. You can use whichever is most convenient for your workflow:
* **Keywords**\
Search by product name, brand, model, or any query (for example: `wireless earbuds`, `Ryzen 7 laptop`, `LEGO Technic`).
* **ASINs**\
Search by one ASIN or multiple ASINs separated by commas (useful when you already know exact product IDs).
* **EANs**\
Search by one or multiple EAN/GTIN codes. Multiple EANs should be separated by commas.
* **Direct product URLs**\
Paste an Amazon product URL (Content Egg will extract the ASIN automatically and fetch the product).
* **Category (node) URLs**\
Paste a URL that contains a **browse node** parameter in the format: `node=XXX`\
Example: a category link where the URL includes `?node=123456789`
***
### Amazon multi-locale setup (best practices)
Amazon has multiple marketplaces (US, UK, DE, etc.). There are three common ways to handle this.
Before choosing one, it helps to know that API credentials cover a whole **region**, not a single marketplace β see [API credentials are per region](#api-credentials-are-per-region-na-eu-fe) at the end of this section.
#### 1) Amazon OneLink (recommended)
Amazon OneLink allows you to link multiple Amazon Associate accounts. Visitors are redirected to their local (or nearest) Amazon store automatically.
* Easiest setup
* No extra scripts required (you simply link accounts)
* Great for international traffic
Configure OneLink here:\
{% hint style="info" %}
**US Associates already have this.** In August 2026 Amazon enabled **Global Earning** for all US creators automatically. US links now redirect international shoppers to their local store in nine additional countries, with no OneLink setup at all.
If that is not what you want, see [Global Earning (international redirects)](#global-earning-international-redirects) below.
{% endhint %}
#### 2) Module cloning (one module per locale)
Use Content Egg [**Module cloning**](/modules/cloning) to create a separate Amazon module per marketplace. This lets you:
* Import products from multiple locales
* Let visitors choose which marketplace to buy from
**Video guide** (OneLink vs module cloning):\
#### 3) Locale parameter + (optional) GeoIP plugins
Use one Amazon module and set **Associate Tags for multiple locales** in settings.
When searching in the post editor, choose the marketplace/locale for the search. Then display marketplace-specific products with a shortcode locale filter:
```
[content-egg module=Amazon locale=US]
```
**Note:** Content Egg does not include built-in GeoIP detection. You can combine it with a third-party plugin that supports shortcodes, for example **GeoIP Detection**.
Example (show US products only to US visitors):
```
[geoip_detect2_show_if country="US"]
[content-egg module=Amazon locale=US]
[/geoip_detect2_show_if]
```
Video guide (GeoIP + locale filtering):\
#### API credentials are per region (NA / EU / FE)
Creators API credentials are tied to a **region**, not to an individual marketplace. One credential pair works for every marketplace inside its region.
| Region | Marketplaces |
| ------ | ---------------------------------------------------------- |
| **NA** | US, CA, MX, BR |
| **EU** | UK, DE, FR, IT, ES, NL, BE, IE, PL, SE, EG, IN, SA, TR, AE |
| **FE** | JP, SG, AU |
**What this means in practice.** Qualifying sales unlock API access for the whole region. If you reach the required sales in the US, the same credentials should also give you API access to the other NA marketplaces, without reaching that number in each one separately.
**In the module settings.** Fill in the **Primary** Credential ID and Secret first. If your products span more than one region, add the extra pairs:
* Credential ID / Secret β NA region
* Credential ID / Secret β EU region
* Credential ID / Secret β FE region
Each locale automatically uses the credentials of its own region. If a region pair is empty β or only half filled in β Content Egg falls back to the Primary credentials. So a single-region catalog needs nothing beyond the Primary pair.
{% hint style="info" %}
This region behaviour is not described in Amazon's documentation. It is based on our own testing and on feedback from users, so treat it as a practical observation rather than an official rule.
{% endhint %}
If you see an eligibility error instead, see [βAssociateNotEligibleβ error (403)](#associatenoteligible-error-403).
***
### Global Earning (international redirects)
In August 2026 Amazon enabled **Global Earning** for all US creators. Existing Amazon.com affiliate links now send international shoppers to their local Amazon store β Canada, United Kingdom, Germany, Italy, Spain, Netherlands, Poland, Sweden and France. Nothing has to be configured, and there is no opt-out in the Associates dashboard.
When the exact product is not sold in the shopper's country, Amazon may send them to a **similar product instead**, which can be a different model or a different brand than the one your article reviews.
Content Egg adds a **Global Earning** setting to the Amazon and [Amazon No API](/modules/affiliate/amazon-no-api-module) modules so you can control this.
| Value | What happens |
| ----------------------------- | --------------------------------------------------------------------------------------- |
| **Similar product** (default) | Amazon's own behaviour. A substitute product may be shown when there is no exact match. |
| **Search results** | The shopper lands on local search results instead of a substitute product. |
| **No redirect** | The redirect is switched off. Shoppers stay in the store the module uses. |
The setting applies to links as they are displayed, so it takes effect on products you have already imported β no re-update is needed. Switching back removes it again.
#### Which value to choose
* **Similar product** β roundups, gift guides and general recommendations, where any comparable product is an acceptable outcome and international commissions are worth having.
* **Search results** β detailed reviews and comparisons, where sending a shopper to a different brand is worse than sending them to a search page.
* **No redirect** β sites that deliberately promote one country's catalog to readers elsewhere, for example a European site listing products only sold on Amazon.com. Note that this gives up international commissions entirely.
#### Cloned modules
The setting is stored per module, including [cloned modules](/modules/cloning). A German Amazon module and a US clone can use different values on the same site β for example the German module on **Similar product** and the US clone on **No redirect**.
{% hint style="warning" %}
**Experimental.** Amazon does not publicly document the link parameters behind **Search results** and **No redirect**, so this behaviour may change without notice.
{% endhint %}
Background and testing details:\
***
### Checkout on Amazon feature
The [**Checkout on Amazon**](/faq/checkout-on-amazon-feature) feature allows visitors to add Amazon products to a local WooCommerce cart and complete the purchase directly on Amazon.
***
### Troubleshooting
#### βAssociateNotEligibleβ error (403)
Error message:\
`AssociateNotEligible (403) β Your account does not currently meet the eligibility requirements to access the Product Advertising API.`
Amazon requires **10 qualified sales in the last 30 days** to gain/keep PA-API access.
More details:\
#### Amazon Associates support
For Amazon Associates account issues:
* Go to Amazon Associates β **Help** β **Contact Us**
* Choose **Creators API** in the Subject dropdown
# Amazon No API module
A quick guide to using the Amazon NoAPI module in Content Egg to add Amazon products without API access.
### Why this module?
Content Egg already includes an [Amazon API module](/modules/affiliate/amazon). However, Amazonβs requirements can be challenging for beginners:
* You must refer **3 qualified sales within 180 days** of opening your Associates account to receive initial API access.
* After that, you must generate [**10 sales in the last 30 days**](https://www.keywordrush.com/blog/amazon-pa-api-associatenoteligible-error-is-there-a-new-10-sales-rule/) to keep API access active.
Because these rules often prevent new users from working with the API, we created the **Amazon NoAPI** module. It allows beginners to start building their sites and adding Amazon products right awayβwithout waiting for API approval.
### How it works
The Amazon NoAPI module operates as a web scraper. Since Amazon may temporarily block server IPs when it detects too many requests, we recommend using the built-in integrations with third-party scraping services:
* [ScrapingDog](https://www.keywordrush.com/go/scrapingdog)
* ScrapeOwl
* [ScraperAPI](https://keywordrush.com/go/scraperapi)
* Crawlbase
{% hint style="warning" %}
These services are paid, but each provides **free monthly quotas** (typically around 1,000 requests per month), which is enough for most small and medium sites.
{% endhint %}
{% hint style="success" %}
**Tip:** You can add multiple scraping service API keys in the module settings. Content Egg will then randomly rotate between them, helping you stay within each serviceβs free limits and reducing the risk of throttling.
{% endhint %}
{% hint style="info" %}
This module is intended for beginners, allowing them to start working on their website. After achieving three sales and receiving an API key, it's recommended to switch to the [Amazon module](/modules/affiliate/amazon) via the official API.
{% endhint %}
### Price updates
For sites displaying product prices, Amazon mandates daily price updates. However, due to the challenges of web scraping, **price display and updates are disabled by default** in the NoAPI module. You can enable them in the module settings if needed.
{% hint style="success" %}
Once you have API access and have configured the Amazon API module, you can delegate the task of updating prices to the Amazon module via the Product Advertising API.
{% endhint %}
### How to get Associate Tag
To obtain an Associate Tag, refer to [Becoming an Associate](https://webservices.amazon.com/paapi5/documentation/troubleshooting/sign-up-as-an-associate.html).
### Search by ASIN or URL
To find the right product, you can search using product URLs or ASINs. This method requires far fewer queries to the source site compared to a keyword search.
### Multiple locales
Read more:
### Global Earning (international redirects)
This module has the same **Global Earning** setting as the Amazon module: choose whether Amazon may substitute a similar product for international shoppers, send them to local search results, or skip the redirect entirely.
Read more: [Global Earning (international redirects)](/modules/affiliate/amazon#global-earning-international-redirects)
### Troubleshooting
#### Prices in the plugin do not match the prices on the Amazon site.
Amazon may display different prices based on the visitor's location. If you're using a scraping service, the bot may be assigned a random country, leading to price discrepancies.
To resolve this, you can add a specific parameter to your request to filter by country. For example, to use DE-based IPs, add the following code to your theme's `functions.php` file:
```php
// For ScraperAPI
add_filter('cegg_amazon_client_url', 'my_cegg_amazon_client_url', 10, 1);
function my_cegg_amazon_client_url($url) {
return add_query_arg('country_code', 'de', $url);
}
// For ScrapingDog
add_filter('cegg_amazon_client_url', 'my_cegg_amazon_client_url', 10, 1);
function my_cegg_amazon_client_url($url) {
return add_query_arg('country', 'de', $url);
}
```
# Avantlink Products module
### How to get Affiliate ID
Log in to your account, go to `Account` β `API Authorization Key` and find your `Affiliate ID`.
### How to get Website ID
Log in to your account, go to `Account` β `Edit Websites` and find your `Website ID`.
### Merchant domains
The Avantlink API doesn't always provide direct product links or merchant domains. To address this, you need to manually add merchant-to-domain matching pairs. You can do this by adding the following code to your `functions.php` file:
```php
function my_avantlink_merchant2domain($m2d) {
$m2d['Amazon'] = 'amazon.com';
$m2d['GritrSports'] = 'gritrsports.com';
return $m2d;
}
add_filter('cegg_avantlink_merchant2domain', 'my_avantlink_merchant2domain', 10, 1);
```
# Awin module
### How to Get Your Datafeed Download URL
1. If you donβt have an account on the **AWIN affiliate network**, [create one here](https://www.keywordrush.com/go/awin).
2. Navigate to **Toolbox β Create-a-Feed**.
3. Select your desired **language**, **categories**, **advertisers**, and other options, then click **Next**.
4. Copy the **generated feed URL** displayed at the bottom of the page.
### What Happens After Import
* All products from the datafeed will be imported into your site's **local database**.
* Once imported, you can **search and filter products** by keywords directly from your local database.
* Feed loading starts **in the background** automatically when you **activate** the module or **re-save its settings**.
* Please allow a few minutes for the feed to finish loading before using search features.
{% hint style="info" %}
The feed will automatically re-sync each time you change the module settings.
{% endhint %}
#### Check for Feed Loading Errors
To ensure everything is working correctly, verify that **no errors occurred** during the feed import process.
#### Important: Data Feed Size Warning
Large feeds can put significant strain on your server. For best performance:
* **Avoid importing extremely large feeds** (over 100,000 products).
* **Split feeds** by categories or advertisers when possible.
* Use multiple instances of the [**Feed Module**](/modules/feed-modules) to manage separate datafeeds.
### Search Options
You can search imported products:
* By **keyword**
* Or by **direct link**
### FAQ
#### I can download an advertiser's datafeed, but I'm not joined to them. How is that possible?
Awin has a **"soft membership"** policy.\
This applies to advertisers who:
* Have **auto-join** enabled for affiliate approvals, and
* Provide a valid datafeed.
You can access their feed even if you're not explicitly joined.\
If a sale is made using this feed, **you will still be credited** for the commission.
#### How can I manually update the local database without waiting for the automatic sync?
You can force a manual refresh:
1. Go to **Content Egg β Settings β Awin**.
2. Simply **resave the settings**.
This will clear the local database.\
The datafeed will be **automatically re-downloaded** the next time you perform a product search.
#### What happens if a product no longer exists after the feed update?
If a product is missing from the latest feed:
* Its **stock status** will be set to **"Out of Stock"** in the local database.
#### Why is the domain name or merchant logo missing or incorrect?
Some advertisers **donβt include original product URLs** in their feed.\
As a result, Content Egg canβt detect the correct domain or logo.
You can fix this using a custom mapping in your `functions.php` file:
```php
function my_awin_mapping( $pairs ) {
$pairs['Cdiscount FR'] = 'cdiscount.com';
$pairs['Darty FR'] = 'darty.com';
return $pairs;
}
add_filter( 'cegg_awin_merchant_mapping', 'my_awin_mapping', 1 );
```
# Bestbuy module
### How to get your API Key
Before you can start using Best Buy APIs, you need an API key. Visit [GET API Key](https://developer.bestbuy.com/login) and sign up with your email address (free/edu email providers may not be accepted). Best Buy will send you an email with instructions on how to activate your new key.
### How to get your Impact Partner ID
You can sign up for the Best Buy Affiliate Program through [Impact Radius network](https://app.impact.com/login.user).
The number under your account name is your Impact Partner ID:
**Notify Best Buy of your Impact Partner ID**
Submit the [contact form](https://developer.bestbuy.com/contact-us?topic=affiliate-api) with the following information from your application to complete the registration process.
```
Your Impact Partner ID
Company Name
Contact Name
Contact Email
```
Please read more here:
# Billigerde module
Use the Billiger.de WordPress plugin for price comparison websites to access over 100 million product records from more than 2,000 stores. Integrate Billiger.de shop data into your website and create
#### Introduction
The Content Egg **Billiger.de module** lets you integrate product offers from Billiger.de into your website.
Billiger.de is structured around three entity types:
**Base products β Products β Offers**
When you search by keyword, Billiger.de may return either **base products** or **products**, depending on the selected search settings. Content Egg then resolves these results into actual **shop offers**, so the saved entries always include offer-specific information such as price, merchant, and availability.
#### How to Join the Affiliate Program
To register for the affiliate program, submit the application form at:
`https://www.solutions.billiger.de/en/partner-program/`
#### API Credentials
To access the Billiger.de API, enter your **User** and **Password** in the module settings.
#### Search Result Type Setting
In the module settings, you can choose the default **Search result type**.
This setting determines which Billiger.de entity type is searched first when using keyword-based search. Regardless of whether the initial match is a base product or a product, Content Egg always converts the result into a concrete shop offer before saving it.
#### Best Practice
We recommend searching by direct **base product** or **product** URL whenever possible, as this usually provides the most accurate match.
Supported URL formats include URLs containing **`baseproducts`** or **`products`**, for example:
* `https://www.billiger.de/`**`baseproducts`**`/110057-apple-macbook-air-m4-2025`
* `https://www.billiger.de/`**`products`**`/5442274125-sony-playstation-5-slim-digital-edition-fortnite-flowering-chaos`
#### EAN Search
The module also supports search by **EAN**.
# Bolcom module
How-to Add Bol.com Affiliate Products in WordPress
Bol.comβs affiliate program (also called the Bol Partner Platform) lets publishers promote products from Bolβs large catalog and earn commissions on sales generated via their affiliate links. Bol.com is a major online retailer in the Netherlands and Belgium, offering many product categories, which makes it a good opportunity for affiliate marketers targeting those markets.
{% hint style="success" %}
**Recommended Reading**\
Want a complete step-by-step guide? Check out our in-depth article: [How to Build a Bol.com Affiliate Website in One Day](https://www.keywordrush.com/blog/how-to-build-a-bol-com-affiliate-website-in-one-day/).
{% endhint %}
### Step 1: Register for the Bol.com Partner Program
To begin using the Bolcom module, you must first register for the Bol.com Partner Program:
π [Register here](https://partner.bol.com/account/registratie/start)
{% hint style="info" %}
**Note:** If you already have a Bol.com account (used for shopping), you can log in with it. However, it's recommended to create a separate account specifically for affiliate purposes to keep things organized.
{% endhint %}
### Step 2: Obtain Your Client ID and Client Secret
1. Log in to your affiliate dashboard.
2. Click **"**[**Account**](https://partner.bol.com/account/affiliate/myAccount)**"** in the top menu.
3. Scroll down to the **"API toegang"** (API Access) section.
4. Create new API credentials for **"Marketing API"**.
5. Copy the **Client ID** and **Client Secret**.
6. Paste these credentials into the Bolcom module settings.
### Step 3: Get Your Website Code
1. Log in to your Bol.com affiliate account.
2. Click **"**[**Account**](https://partner.bol.com/account/affiliate/myAccount)**"** in the top menu.
3. Navigate to the **"Website"** section.
4. Copy your **Website Code**.
5. Enter this code in the module settings.
### Search Tips
The Bolcom module supports multiple methods for finding products. You can search using:
* **Keywords** β Enter product names or general terms to browse matching results.
* **EANs** β Use EAN/GTIN for precise product searches.
* **Direct Product URLs** β Paste a product URL to retrieve that specific item.
* **Category URLs** β Use category links to explore top-selling products in that section.
### Watch the Video Guide
Prefer to follow along visually? Check out our step-by-step tutorial on YouTube.
{% embed url="" %}
# CityAds Products module
### Getting Remote\_auth
1. If you do not have an account in the Cityads affiliate program, create one.
2. Follow `Office` β `Private office` β `API` and get your `Remote_auth` Key.
# Coupang module
Coupang WordPress Plugin Guide β How to Use the API for Affiliate Products and Monetization
Coupang is a leading South Korean e-commerce platform, often called the "Amazon of Korea." It sells everything from electronics to groceries and is famous for its Rocket Delivery service, offering same-day or next-day shipping.
It also runs **Coupang Partners**, an affiliate program where publishers can earn commissions by promoting Coupang products.
### How to get your Access Key & Secret Key
1. **Confirm eligibility**
* Coupang Partners API access is available only to **fully approved** Coupang Partners accounts.
* If you need API access **before final approval**, email the Partners team with your **AF ID**, plus details on **where** and **how** you will place ads; they will review and advise.
2. **Sign in to Coupang Partners**
* Log in to your Coupang Partners account.
3. **Open the API page**
* From the **top menu**, go to **Tools β ννΈλμ€ API (Partners API)**.
4. **Generate keys**
* Click the **Create/Generate** button.
* Your **Access Key** and **Secret Key** will be issued **immediately** to approved accounts.
5. **Add to Content Egg**
* In WordPress β **Content Egg β Modules β Coupang**, paste:
* **Access Key** β βAccess Keyβ
* **Secret Key** β βSecret Keyβ
* Save settings and test a search on the post edit page.
### API Limitations
The Coupang API provides only **basic product data** such as product title, image, and price. It does **not** return extended details like product descriptions, attributes, or specifications.
π **Important:**
* You can search for products **by keywords only**. Searching directly by **product URLs** is not supported.
* Each request can return a **maximum of 10 products**.
* The API server may be restricted from many **geo IPs**, so itβs recommended to use **local hosting servers** for reliable access.
Even with these restrictions, the API is still a powerful way to add Coupang affiliate product blocks to your site and monetize traffic. You can also enhance listings by using the pluginβs built-in [AI features](/ai/content-generation-with-product-import) to generate additional content.
### Price Update Limitations
The Coupang API does not offer a direct method to check or update **prices** and **stock status** of products by product ID.
To keep product information current, the plugin uses the following fallback approach:
1. Re-search and try to match the product using the **original keyword**.
2. If no match is found, attempt to match by the **product title**.
This process usually finds the correct product and updates the price, but it is not 100% reliable. If a product cannot be matched, two outcomes are possible:
* Mark the product as **out of stock**, or
* Keep the **last known price** and mark stock status as **unknown**.
You can choose your preferred behavior in the module settings under the **βStock Statusβ** option.
You can also set a [**keyword for auto-update**](/updating-products/updating-the-product-list) to refresh product listings and keep them up to date.
# CJ Products module
### Getting Personal Access Token
A Personal Access Token is a unique identification string for your account. Personal Access Tokens allow for secure authentication when accessing the CJ APIs.
You can manage your personal access tokens from the [personal access tokens](https://developers.cj.com/account/personal-access-tokens) page.
### Getting Company ID
CID or Company ID is your account number. This number is located on the top right side of your screen next to your name.
### Getting Website ID
1. Log in to your CJ account.
2. Follow `Account β Websites` and find the ID of your site:
# Daisycon module
β οΈ Deprecated
The **Daisycon module is deprecated** and no longer actively maintained.
Please use the more flexible **Feed module** instead, which fully supports Daisycon feeds and is compatible with **any standard CSV feed**.
π Learn more: [Feed modules](/modules/feed-modules)
# Ebay module
### How to get App ID and Cert ID
1. [Register](http://developer.ebay.com/join/) for the eBay Developer Program.
2. Log in to your account and [generate](https://developer.ebay.com/my/keys) your App ID/Cert ID (**Production Key Set**).
{% hint style="warning" %}
Make sure OAuth is enabled for your keys; enable it if it isn't.
{% endhint %}
### Deletion/Closure Notifications
The Content Egg plugin does not store any personal data of eBay's users. Because of this, the developer may apply for exemption from receiving eBay marketplace account deletion/closure notifications. For more information, see the [Opting Out of eBay Marketplace Account Deletion/Closure Notifications](https://developer.ebay.com/marketplace-account-deletion#optingOut).
### Campaign ID
1. If you don't have an account in ePN, [register](https://partnernetwork.ebay.com/).
2. `Campaign ID` is visible in the `Campaigns` list in your ePN account.
### Deeplink
Set this parameter only if you want to send traffic through third party affiliate networks with eBay support. Read more: [How to find your deeplink](/modules/deeplink-settings).
### Multiple locales and Geolocation IP detection
You can work with multiple eBay locales and geolocation IP detection, similar to [how it works in the Amazon module](https://ce-docs.keywordrush.com/modules/affiliate/amazon#2-geolocation-ip-detection).
# Envato module
### Getting Token
1. [Register an account](https://themeforest.net/sign_up_sso?ref=keywordrush) on Envato.
2. Open [this page](https://build.envato.com/create-token/?ref=keywordrush) and create your token.
{% hint style="success" %}
Don't forget to set your Deeplink in the module settings to get affiliate commissions.
{% endhint %}
# Flipkart module
### How to get Affiliate Tracking ID and Token
1. [Register an account](https://affiliate.flipkart.com/registerme) or use an existing one.
2. Go to `API` β `TOKEN` and find `Affiliate Tracking ID` and `Token`.
# GdeSlon module
### Getting API Key
1. If you donβt have an account in the GdeSlon affiliate program, [create one](http://www.keywordrush.com/go/gdeslon).
2. Log in to your GdeSlon account, follow `Settings` β `XML API` and find your API Key.
# Geizhalsde module
Integrate Geizhals.de product data into your WordPress website with the Content Egg Geizhals.de module. Search products by keyword, direct product URL, or EAN.
The **Geizhals.de module** allows you to import product offers and price comparison data from Geizhals into your website.
#### Joining the Affiliate Program
To join the Geizhals affiliate program, submit a partnership request on the Geizhals Publisher page. Include your name, email address, website, and a short description of your project. Once your application is approved, the Geizhals team will send you the required access credentials and integration details.
`https://unternehmen.geizhals.at/publisher/`
#### API Credentials
To use the Geizhals.de Product API, enter your **User Name** and **Secret Key** in the module settings. These credentials are provided by the Geizhals team.
#### Search Methods
The module supports the following search methods:
* **Keyword search**
* **Direct product URL search**
* **EAN search**
Each successful search returns the full Geizhals price comparison list for the matched product.
#### Keeping Prices and Offers Updated
To keep offer data current, configure the **Price Update interval** in the module settings.
For better automatic updates, you can set **Auto-update keywords** to either a direct **product URL** or an **EAN**. This allows Content Egg to re-check the same product page during updates. If new offers become available on the Geizhals page, they can be added automatically to your WordPress post as well.
# ImpactRadius module
#### How to Get Your Account SID and Auth Token
The **impact.com Web Services API** uses two credentials for authentication:
* Account SID
* Auth Token
You must generate these credentials in your impact.com account before using the ImpactRadius module.
#### Step-by-Step Guide
**1. Open the API Access page**
Navigate to the API credentials section:
**2. Click βCreate Access Tokenβ**
This begins the process of generating a new API key pair.
**3. Enter a Token Name**
Choose any descriptive name (e.g., *Content Egg Integration*), then click **Next**.
**4. Contact Information**
Click **Next** to continue.
**5. Configure API Scopes**
On the **Configure API Scopes** screen:
* Enable **Catalogs**
* Select **all API paths** related to catalog access
**6. Finish and open your new credential**
After creation, go to the page for your new access token.
**7. Copy your credentials**
Open the **API Credentials** tab.
There you will find:
* **Account SID**
* **Auth Token**
Copy both values and paste them into the ImpactRadius module settings in Content Egg.
# Kelkoo module
### Getting Token
1. If you donβt have an account in the Kelkoo affiliate program, [create one](https://www.kelkoogroup.com/products/become-a-publisher/).
2. Log in to your Kelkoo account, go to `Admin β API credentials β Shopping API` and issue a new *Token*.
{% hint style="warning" %}
A token must be linked to an Application. An application is set up by an account manager. If an application is not yet activated for you, please ask Kelkoo support to activate it.
{% endhint %}
# Kieskeurignl module
### How to get your Token and Affiliate ID
Kieskeurig.nl does not have a public affiliate program. Please contact the Kieskeurig team directly to gain access to their affiliate program and your API credentials.
### How to update product lists
It's recommended to use the [auto-update of product listings](/updating-products/updating-the-product-list) feature for this module.
To search for products you can use:
* EAN
* Kieskeurig product ID
* Kieskeurig product URL
* Product title (keyword search)
### Merchant domains
The Kieskeurig API does not return direct product links or merchant domains. For this reason, you need to add `merchant -> domain` matching pairs manually. Add code like this to your functions.php file:
```php
function my_kieskeurignl_merchant2domain($m2d)
{
$m2d['Amazon'] = 'amazon.nl';
$m2d['JBlokker connect'] = 'blokker.nl';
$m2d['Bemmel en Kroon'] = 'bemmelenkroon.nl';
return $m2d;
}
add_filter('cegg_kieskeurignl_merchant2domain', 'my_kieskeurignl_merchant2domain', 10, 1);
```
# Rakuten Linkshare module
This guide will help you configure the Rakuten LinkShare module in the Content Egg plugin.
{% hint style="info" %}
You can also use the [Feed module](/modules/feed-modules) to import Rakuten product feeds, as an alternative to the Rakuten API module.
{% endhint %}
### Getting Your SID
1. **Register or Log In**:\
Go to [rakutenadvertising.com](https://rakutenadvertising.com/) and sign up, or log in with your existing **publisher account**.
2. **Find Your SID**:\
After logging in, navigate to your Rakuten Publisher Dashboard. Your SID is a **numerical value** listed as your account ID.
### Getting Your Client ID and Client Secret
1. **Go to the Developer Portal**:\
Visit [developers.rakutenadvertising.com](https://developers.rakutenadvertising.com/) and log in using your Rakuten credentials.
2. **Create a New Application**:
* Click on the **βAdd Applicationβ** button.
* Enter a name for your app (you can use any name).
* Complete the form and submit it to create the application.
3. **Copy Your Credentials**:\
Once your app is created, youβll be shown a **Client ID** and **Client Secret**.\
Copy both and paste them into the Rakuten LinkShare module settings in Content Egg.
{% hint style="warning" %}
#### Important Notes
The Rakuten API will **only return product results** if your **advertisers have product feeds uploaded** into the Rakuten database.\
Make sure the advertisers you are approved for have active product feeds.
{% endhint %}
# Linkwise module
### How to get API Username and API password
Please ask Linkwi.se support for your API credentials.
# Lomadee Products module
Lomadee module setup
### How to get your API Token
1. Log in to your Lomadee account.
2. In the **bottom-left** of the page, click your **username** (profile menu).
3. Click **βCredenciais de APIβ**.
4. Copy your **Token** and paste it into the Content Egg β Modules β Lomadee Products module settings.
### Lomadee API limits and important notes
#### 1) Rate limit (very low)
Lomadeeβs API limit is **10 requests per minute**.
Keep in mind:
* **Each product search** = **1 request**
* **Each affiliate link generation** = **1 request**
This can be reached quickly, especially on pages with many products.
#### 2) Search can include advertisers youβre not approved for
The Lomadee product search API can return products from the **full catalog**, including advertisers:
* you are **not approved** for yet, or
* that are **not allowed** for affiliate links in your account.
Because of this, itβs recommended to set:
**Advertiser (Organization) IDs**\
Add a comma-separated list of advertiser Organization IDs (UUIDs) to **limit results** to advertisers you actually want to use (and ideally are approved for).
If you leave it empty, searches may return products from any advertiser, and some affiliate links may not be possible to generate.
#### 3) Affiliate links are generated later (not during search)
When you search products, Content Egg saves the product data first.
Affiliate (short) links are generated **later**, in a **small batch**, when products are **displayed on the frontend for the first time**.
What you may notice:
* The first page load with Lomadee products can be **slower**, because link generation happens during display.
* If the API limit is hit, the plugin will skip link generation for now and try again later.
#### 4) Approval required (admin notice + auto retry)
If you add a product from an advertiser that requires approval, Lomadee may refuse to generate the affiliate link and return a message like:
**βOrganization approval is required to generate links.β**
In this case:
* The product can still appear, but it will use the **direct (non-affiliate) URL** until approval is granted.
* Youβll see a **warning notice** in the WordPress admin dashboard.
* The plugin will automatically retry generating the affiliate link **every 24 hours**.
#### 5) No direct prices/stock updates
The Lomadee API does **not** provide a reliable way to refresh existing items by product ID (to update **price** and **availability** for already saved products).
Recommended workaround:
* Use Content Eggβs [**update by keyword**](/updating-products/updating-the-product-list) feature to periodically re-run the search and refresh the product list.
# Offer module
The Offer module lets you add products to a post **manually** β useful for any merchant that isn't covered by a dedicated module.
### Add a custom product
On the **Added** tab of the product manager, click **+ Add product**. The edit drawer opens in **Add product** mode β fill in the product's details (**Title** and **Product URL** are required) and click **Add product**.
+ Add product opens the edit drawer in Add product mode
{% hint style="info" %}
You don't need to activate the Offer module first β Content Egg activates it automatically the first time you save a manually added product.
{% endhint %}
{% hint style="info" %}
Use the **direct link** from the product page in the "Product URL" field (without any affiliate-network parameters, which usually come after the "?" symbol). Use the deeplink in a separate field. Read about the deeplink [here](/modules/deeplink-settings).
{% endhint %}
### Global/custom settings
In the example above, we used the deeplink directly in the field. But you can create global deeplinks and XPath for each domain. So if your offer doesn't have a deeplink field, the plugin will use the global settings.
You can also overwrite custom settings by global fields (global settings will have priority)
### Price update for Offer module
{% hint style="warning" %}
This is only for advanced users. You must have some basic knowledge about XPath.
{% endhint %}
{% hint style="info" %}
Please note that we don't provide help setting up XPath for your sites, but you can hire us to create custom parsers for Affiliate Egg.
{% endhint %}
Offer module can automatically update prices if you set global/custom [XPath query](https://en.wikipedia.org/wiki/XPath).
### How to get XPath for an Amazon product (example)
1\. The plugin can't detect JavaScript fields, so deactivate it in your browser.
We recommend [Quick Javascript Switcher](https://chrome.google.com/webstore/detail/quick-javascript-switcher/geddoclleiomckbhadiaipdggiiccfje) for Chrome as fast way to enable/disable JavaScript.
2\. You can install the [ChroPath](https://chrome.google.com/webstore/detail/chropath/ljngjbnaijcbncmcnjfhigebomdlkcjo) add-on for Chrome to quickly check XPath.
**How to use ChroPath:**
* Right-click on the web page, and then click Inspect (Ctrl + Shift + I).
* In the right side of Elements tab, click on ChroPath tab.
* To generate XPath selectors, inspect element or click on price node, it will generate the unique relative/absolute XPath selector. Usually, you should use relative selector.
3\. Sometimes, some sites can have different pages with different designs for product pages.
For example, XPath for deal products will be:
```php
//span[@id='priceblock_dealprice']
```
But XPath for book product pages:
```php
//span[@class='a-size-base a-color-price a-color-price']
```
So, you must merge all xpath into one line with %DELIMITER%. Plugin will try to use each of xpath rules until some rule will work.
**Example for Amazon:**
```php
//span[@id='priceblock_ourprice']%DELIMITER%//span[@id='priceblock_dealprice']%DELIMITER%//span[@class='a-size-base a-color-price a-color-price']
```
### Sites with Microdata markup
{% hint style="success" %}
TIP: Many sites use schema markup and you can try universal XPath query for Microdata:
{% endhint %}
```php
.//*[@itemprop='price']/@content
```
or
```php
.//*[@itemprop='price']
```
### How to check price update?
XPath is used only for price update. It's not in use for parsing initial price, you must add it manually to field.
So, for checking XPath:
* Add some wrong price in Offer price field
* Click on the "Update prices" button to trigger the price update:
* Check your price now and possible error:
# Optimisemedia module
{% hint style="danger" %}
WARNING: This module is deprecated ([what does this mean](https://ce-docs.keywordrush.com/modules/deprecatedmodules)).
{% endhint %}
### How to get API Key
1. Create account:
2. Log in to your Optimise Network account, follow `My Details` β `Account Details` β `API Key` and find your `API Key` and `Private Key`.
### How to get Affiliate ID
Go to `Content` β `Get Banners`. Search for any banner and check its tracking link. It will look something like this:
```
```
In this link, you need to copy the `AID=878608` parameter. Your affiliate ID is `878608`.
# Shareasale module
{% hint style="danger" %}
This module is deprecated. ShareASale is shutting down and fully transitioning to the Awin platform. Please use the [AWIN](/modules/affiliate/awin) or [Feed module](/modules/feed-modules) instead.
{% endhint %}
### How to get Token and Secret Key
1. Go to your account on Shareasale, follow `Tools` β `API Reporting`, and set the IP of your server, which you use for the site. You can get the correct server IP from your hosting provider.
2. Find `Token` and `Secret Key`, then save the settings.
### How to get Affiliate ID
You can find Affiliate ID in the top left corner of your account, near your login name.
### FAQ
**I am getting this error message: Error: Invalid Account - Error Code 4002 - xx.xx.xx.xx**
This means your IP address isnβt registered under `Tools` β `API Reporting` in your Shareasale dashboard. Be sure to register the IP youβre sending API requests from.
# Shopee module
Shopee WordPress Plugin Guide β How to Add Affiliate Products and Monetize Your Site
Shopee is one of the largest e-commerce platforms in **Southeast Asia, Taiwan, and Brazil**. It offers a wide variety of products including electronics, fashion, beauty, home goods, and groceries. Shopee is known for its mobile-first approach, user-friendly app, and frequent promotional campaigns such as flash sales and discount vouchers.
The platform also supports **local sellers and international brands**, making it a popular online marketplace for both buyers and merchants. Additionally, Shopee runs an **affiliate program**, allowing publishers and partners to earn commissions by promoting Shopee products through tracked affiliate links.
### How to Get App ID and API Key
1. **Sign up for Shopee Affiliate**\
Register with the Shopee Affiliate platform for your region:
* Brazil:
* Indonesia:
* Malaysia:
* Mexico:
* Philippines:
* Poland:
* Singapore:
* Taiwan:
* Thailand:
* Vietnam:
2. **Log in to your Shopee Affiliate dashboard**\
Use the account you created to access your dashboard.
3. **Go to the Open API section**\
From your Shopee Affiliate homepage, open the **βOpen APIβ** section.
4. **Generate credentials**\
In this section, you can create or view your **App ID** and **API Key**.
5. **Add to Content Egg**\
Copy both values into WordPress β **Content Egg β Modules β Shopee module**, then save changes.
{% hint style="warning" %}
**Affiliate links will be generated automatically** through the Shopee API, but you can also use **Deeplinks** from affiliate networks that support Shopee, such as Accesstrade. To do this, [set your Deeplink](/modules/deeplink-settings) in the Shopee module settings of Content Egg, and the plugin will use it to create affiliate links with proper tracking and commission credit.
{% endhint %}
### Shopee Module Details
The **Shopee module** lets you add affiliate products to your WordPress site in two ways:
* **Keyword search** β find products by entering relevant search terms.
* **Direct product URL** β import specific items by pasting their Shopee links.
You can also control how many results are displayed per query. The maximum limit is **50 products**.
#### Price Updates
The module supports **automatic price synchronization**.\
For best performance, we recommend running updates via a Cron job instead of triggering them on Page views. Review your preferences in the module settings.
#### Data Available from the Shopee API
Shopeeβs API provides only **basic product details**, including the product title, main image, and current price. Extended content such as full descriptions, attributes, or detailed specifications is not included in the API feed.
Despite these limitations, the Shopee module is a **reliable solution for affiliate integration**. You can build product blocks that encourage clicks and conversions, while enhancing your listings with the pluginβs [AI-powered content generation](/ai/content-generation-with-product-import).
# Tradedoubler Products module
### Getting Token
1. Log in to Tradedoubler and add your site (if you didn't do this already).
2. Follow: `Account` β `Manage tokens` and find your Token with the label `PRODUCTS`.
# Tradetracker Products module
### How to get Customer ID and Passphrase
The settings for this module are the same as for the [Tradetracker Coupon](/modules/coupon-modules/tradetrackercoupons) module.
# Trovaprezzi
### How to get your Partner ID
Trovaprezzi does not have a public affiliate program. Please contact the Trovaprezzi team directly to gain access to their affiliate program and your Partner ID.
### How to update product lists
The Trovaprezzi API does not have methods to update existing products. Therefore, it is recommended to use the [auto-update of product listings](/updating-products/updating-the-product-list) feature for this module.
You can use product URLs as keywords:
### Merchant domains
The Trovaprezzi API does not return direct product links or merchant domains. For this reason, you need to add `merchant -> domain` matching pairs manually. Add code like this to your functions.php file:
```php
function my_trovaprezzi_merchant2domain($m2d)
{
$m2d['Ri Si Electronic'] = 'risielectronic.it';
$m2d['Jolly Shop'] = 'interteria.it';
$m2d['Mondoshop'] = 'rmondoshop.it';
return $m2d;
}
add_filter('cegg_trovaprezzi_merchant2domain', 'my_trovaprezzi_merchant2domain', 10, 1);
```
# Udemy module (deprecated)
{% hint style="danger" %}
**Deprecation Notice: Udemy Affiliate API**
Udemy has officially closed its affiliate API, and as a result, this module is now **deprecated**.
{% endhint %}
### π Alternative ways to work with Udemy
If you're looking to promote Udemy products, consider the following options:
1. [**Rakuten module**](/modules/affiliate/linkshare)\
Use the Rakuten module to access Udemy affiliate products.
> *Note: You must first be approved for the Udemy affiliate program via Rakuten.*
2. [**Content Egg + Affiliate Egg**](/modules/affiliate-egg-integration)\
Integrate Udemy using Content Egg and Affiliate Egg.
> *No prior approval is required to add and display Udemy products using this method.*
***
### Obtaining Client ID and Client Secret
To access Udemy's API, follow these steps to obtain your **Client ID** and **Client Secret**:
1. Log in to your [Udemy account](https://www.udemy.com/).
2. Navigate to Edit profile > [API Clients](https://www.udemy.com/user/edit-api-clients/) and click **Request Affiliate API Client**.
3. Once approved, your **Client Id** and **Client Secret** will be available on the same page.
{% hint style="warning" %}
**Note:** If you do not see the **Client ID** in your profile, switch your account language to **English** in your Udemy settings.
{% endhint %}
### Generating a Deeplink on Rakuten Advertising
Udemy's affiliate program is available through the **Rakuten Advertising** network. Follow these steps to generate your deeplink:
1. Join the **regional merchant** specific to your target geographic regions. Refer to this [guide](https://partnersupport.udemy.com/hc/en-us/articles/360048655014-How-do-I-Join-the-Udemy-Affiliate-Program) for details.
2. Once approved, navigate to **Links > Link Tools > Deep Links** in Rakuten Advertising.
3. Select **Udemy** as the advertiser and generate your [deeplink](https://ce-docs.keywordrush.com/modules/affiliate/pages/-MTUXEKm5VcN0CRKILEW#id-1.-deeplinks).
# Sovrn (Viglink) module
### Getting API Key and Secret Key
To find your API key and Secret key for a site:
1. Log into the Sovrn Platform.
2. Go to Commerce > Settings > Site.
3. Under Actions, click on the Key to view the API keys for that site.
4. If no secret key has been created, click on "Generate Secret Key".
### Price comparison
The module allows you to search for a specific product in the Sovrn database and obtain all offers for that product. You simply need to provide a product URL from any supported retailer.
### Price filter
Sovrn API provides a simple search function that returns all products with keywords in the product title. To find the desired product, it is recommended to add a filter by price.
### Merchnat domains
Unfortunately, the Sovrn API does not return direct product URLs or merchant domains. As a result, some merchant domains may not be detected correctly. To resolve this, add the following code to your `functions.php` file with merchant-to-domain pairs like this:
```php
function my_viglink_merchant2domain($m2d)
{
$m2d['Verizon'] = 'verizon.com';
$m2d['Lowe\'s'] = 'lowes.com';
$m2d['Dell'] = 'dell.com';
return $m2d;
}
add_filter('cegg_viglink_merchant2domain', 'my_viglink_merchant2domain');
```
# Walmart module
### How to Get API keys
Walmart no longer releases new API keys. If you do not have your API key, leave this field empty.
### How to get Impact Publisher ID
Walmart doesn't have its own affiliate network, so it uses Impact Radius. You can find your Publisher ID in the top-right corner of your Impact [Radius Network account](https://app.impact.com/login.user).
# Webgains module
β οΈ Deprecated
The **Webgains module is deprecated** and no longer actively maintained.
Please use the more flexible **Feed module** instead, which fully supports Webgains feeds and is compatible with **any standard CSV feed**.
π Learn more: [Feed modules](/modules/feed-modules)
# Feed modules
Load a merchant's CSV, XML, or JSON product feed into WordPress and use its products anywhere in Content Egg.
If your merchant or affiliate network provides a **product feed** β a CSV, XML, or JSON file listing their catalog β a Feed module imports it into WordPress so you can use those products throughout Content Egg. Many networks (Awin, CJ, Rakuten/LinkShare, Tradedoubler, and others) offer such feeds.
### Where your products go after import
Setting up a feed loads its products into a **local product library** in your WordPress database. They're stored and searchable β but **not published as posts on their own**. From there, you choose how to use them:
* **Insert products as you write.** In the post editor, search your feed's products (just like any other Content Egg module) and add them to a specific post as product blocks. Best when you hand-pick a few products per article.
* **Bulk-create posts with Feed Import.** The [Feed Import tool](/set-up-products/import-tools/feed-import) turns *every* product in the feed into its own post or WooCommerce product. Best for publishing a large catalog automatically.
{% hint style="info" %}
You don't have to use Feed Import. If you only want to feature selected products, skip it and add products from the editor instead.
{% endhint %}
You can also build a [price comparison](/modules/feed-modules/price-comparison-based-on-feeds) across merchants by EAN, or add feed offers to existing posts with the [Fill tool](https://ce-docs.keywordrush.com/set-up-products/fill-tool).
### In this section
* [**Adding a feed**](/modules/feed-modules/general-information) β the setup wizard, supported formats and URLs, and how syncing works.
* [**Field mapping**](/modules/feed-modules/field-mapping) β match feed columns to product fields (CSV, XML/XPath, regex).
* [**Importing products as posts**](/modules/feed-modules/mass-import) β bulk-publish a whole feed with the Feed Import tool.
* [**Price comparison based on feeds**](/modules/feed-modules/price-comparison-based-on-feeds) β merge offers from multiple merchants by EAN.
* [**Troubleshooting**](/modules/feed-modules/troubleshooting) β fixes for parsing, downloads, and detection.
# Adding a feed
Set up a CSV, XML, or JSON feed with the setup wizard.
Content Egg includes a dedicated module for working with product feeds in **CSV**, **XML**, or **JSON** format. This page covers adding one with the setup wizard, the feeds and URLs it supports, and how the feed keeps itself in sync afterward.
### The setup wizard
Go to `Content Egg > Modules` and click **Add a Feed** to open the setup wizard.
1. **Paste the feed URL.** That's the only thing you need to enter on this step. The wizard downloads a sample and automatically detects the format, encoding, currency, merchant domain, and CSV/decimal settings β you don't need to know any of this in advance.
2. **Map the fields.** The plugin already fills in some of the mapping deterministically, based on common feed field names. Real sample rows from your feed are shown next to the mapping panel, along with a live preview of the first product, so you can confirm everything looks right. Click **Map with AI** to have the AI assign the remaining fields, or finish mapping any field manually.
3. **Confirm and import.** Give the feed a name, choose how often it should sync, then click **Save & import products**. The import runs in the background with a live progress view, so you can leave the page and come back once it's done.
{% hint style="info" %}
If the wizard can't detect your feed's parameters correctly, click **Set up manually** in the top-right corner of the page. This takes you straight to the classic module settings page, where you can enter every setting by hand.
{% endhint %}
{% hint style="info" %}
Once the import finishes, your products live in a local library, ready to use. See [where your products go](/modules/feed-modules#where-your-products-go-after-import) for what to do next.
{% endhint %}
### Supported feeds & URLs
* **Direct access**: The feed must be reachable at a direct, live URL β no login page or authorization step in front of it.
* **Formats**: CSV, XML, and JSON are supported. CSV is recommended when available, for better performance and simpler configuration.
* **Archives**: ZIP and GZ (GZIP) are supported. The wizard detects compression automatically; when setting up manually, select the matching **Archive format** option.
* **Protocols**: `http://`, `https://`, `ftp://`, and `ftps://` URLs are all supported.
{% hint style="warning" %}
To process **large** ZIP-compressed feeds, make sure ZIP support is enabled on your server.
{% endhint %}
{% hint style="warning" %}
In the Pro version you can enable up to **50** individual feed modules, and you can use merged feeds that combine products from multiple merchants (available in many affiliate networks). Avoid very large single feeds β splitting them keeps performance optimal.
{% endhint %}
### How syncing works
1. **Loading the feed file:** The feed file is downloaded to your server and cached. An unchanged feed is not re-downloaded or reprocessed on the next sync.
2. **Importing offers:** The plugin imports offers into the local database. Imports always run in the background, so saving settings or reloading a feed never blocks the page.
3. **Product search:** You can search feed products as you would in any other Content Egg module. If an import is still running, search shows a "please wait" message until it completes.
4. **Regular syncs:** By default, feed data is considered stale after 12 hours. The plugin re-syncs it in the background the next time that data is actually requested (e.g. someone views a page or admin screen using it) β not on a fixed clock. On a very low-traffic site, a refresh may take longer than 12 hours if nothing requests the feed in the meantime. You can change this interval (from every hour up to once a week) in the wizard's last step or in the module settings β both control the same **Feed sync interval** option.
5. **Adding more feeds:** Each feed is a separate module β repeat the steps above from `Content Egg > Modules`.
### Video walkthrough
{% hint style="info" %}
This walkthrough predates the current setup wizard, so the interface looks different β it's still a useful overview of the overall workflow.
{% endhint %}
{% embed url="" %}
# Field mapping
Product feeds can vary significantly in structure, depending on the source or affiliate network. To ensure accurate data import, each feed must be mapped to Content Eggβs internal product fields. This process is required for **every individual feed**.
### Automatic Field Mapping
You rarely have to map fields by hand. When [adding a new feed](/modules/feed-modules/general-information#the-setup-wizard), the setup wizard already fills in some fields for you automatically, based on common feed field names β this is a deterministic match, not AI. For anything it couldn't confidently match, click **Map with AI** to fill in the rest, or finish mapping any remaining field manually. Real sample rows from your feed and a live product preview sit right next to the mapping panel, so you can confirm everything looks right before importing anything.
{% hint style="info" %}
The **Map with AI** button is disabled until an **OpenAI API key** is added under `Content Egg > Settings > AI`.
{% endhint %}
The rest of this page covers the mapping syntax in more detail β useful when editing an existing feed's mapping directly in the module settings, or when you need an XPath/regex expression the wizard's dropdowns don't offer.
### CSV Feeds Mapping
Match each column header from your feed to the appropriate plugin field:
**Common CSV Field Mappings:**
| Plugin Field | Description |
| ---------------- | ---------------------------------------------------------------------------------------- |
| `id` | **Required.** Unique identifier for each product. Must remain consistent across imports. |
| `affiliate link` | The product's affiliate URL, including your tracking parameters. |
| `is in stock` | Stock status. Supported values: `1`, `true`, `on`, `yes`, `0`, `false`, `off`, `no` |
| `availability` | Text-based stock status. Supported values: `in stock`, `out of stock` |
| `direct link` | Direct (non-affiliate) URL to the original product page |
| `gtin` | Global Trade Item Number, such as EAN-13 (e.g., `3001234567892`) |
{% hint style="info" %}
Some fields are required, such as `id`, while others are optional. However, including more fields improves matching, filtering, and comparison quality.
{% endhint %}
{% hint style="info" %}
The wizard shows these same explanations as an **(i)** icon next to each field in the mapping panel, so you don't need to come back to this table while setting up a new feed.
{% endhint %}
### XML Feeds Mapping
{% hint style="warning" %}
**Tip:** If XML parsing fails, try switching the **XML processor** to **XmlReader** in the module settings.\
XmlReader handles nested and complex XML structures more reliably.
{% endhint %}
If your feed is in **XML format**, you'll map fields using either XML node names or XPath expressions β the same syntax works whether you're mapping in the wizard or the classic settings form:
**Example: Node Attribute Mapping**
You can directly select attributes from a node. For example:
```xml
```
You can map the image URL using:
//image/@url
**Example: Using XPath for Namespaced Nodes**
For more complex XML structures or namespaced elements, XPath expressions are supported:
```xpath
.//*[local-name()='media:thumbnail']/@url
```
This XPath selects the `url` attribute of a `` element, even if it uses a namespace.
### Extract Data with Regex
You can extract specific data from a feed field using a custom syntax that incorporates a regex pattern:\
**`[regex][pattern][feed_field_name]`**
This allows you to define a pattern to match and extract the desired portion of the data within the specified feed field.
**Example Use Case:**
Consider a feed containing a **"fields"** field that combines multiple pieces of product data. To extract the value of a specific key, such as **"from\_price"**, you can use the following syntax:
```plaintext
[regex][/from_price:([\d.]+) EUR/][fields]
```
**Explanation:**
* **`[regex]`**: This indicates you are using a regex-based extraction.
* **`/from_price:([\d.]+) EUR/`**: The regex pattern to match.
* **`[fields]`**: The feed field from which data will be extracted.
Use capturing groups **`()`** to define the exact portion of the match you want to extract.
### Product Attributes
You can map any fields from your CSV feed as product attributes, which can then be used to import WooCommerce attributes or display attributes via shortcode.
For example, if your feed includes columns like `delivery_weight` and `delivery_time` that you want to map as attributes, add them to the "attributes" mapping settings as follows:
`delivery_weight,delivery_time`
These fields will then appear as product attributes:
To customize their display names, update the "attributes" mapping like this:
`delivery_weight->Delivery Weight,delivery_time->Delivery Time`
The result will appear as shown:
# Importing products as posts
Setting up a feed loads its products into your local database, but doesn't publish anything on its own. When you want a **separate post or WooCommerce product for every item in the feed**, use the **Feed Import** tool β it queues the whole feed with a single click.
{% hint style="info" %}
This step is optional. To feature only selected products, skip Feed Import and add products directly from the post editor instead.
{% endhint %}
Full guide:
{% content-ref url="/pages/sDAijk4TAIJHDK7X7B8n" %}
[Feed Import](/set-up-products/import-tools/feed-import)
{% endcontent-ref %}
### Watch feed import in action
{% embed url="" %}
# Price comparison based on feeds
If your feeds include an EAN field for all products from different merchants, you can build a price comparison using the [Autoblog](https://ce-docs.keywordrush.com/set-up-products/autoblogging) or [Fill](https://ce-docs.keywordrush.com/set-up-products/fill-tool) feature. All products with the same EAN will be [merged together](https://ce-docs.keywordrush.com/set-up-products/price-comparison-websites#search-by-ean).
Donβt forget to add a shortcode to the body of your post to show the price comparison list, or use the special Content Egg product layouts from compatible themes.
You can use the [Fill tool](https://ce-docs.keywordrush.com/set-up-products/fill-tool) if you want to add offers to your existing products.
# Troubleshooting
Fixes for feeds that won't import, parse, or download correctly.
## First checks
Start here whenever a feed isn't behaving as expected.
#### 1. Verify the import
Open the **Feed Module Settings** page and confirm the feed shows a **Ready** status with a product count. This is where you see the current state, the last import result, and the cached feed file.
#### 2. Check the field mapping
Review your field mappings and fix any missing or incorrect fields. At minimum, the required `id` field must be mapped.
#### 3. Reload the feed data
Click **Reload Feed Data Now** (in the Feed Status panel shown in step 1) to re-sync the products from the feed into the local database. The import runs in the background, so this won't block the page β check back on the same settings page for progress and the result.
{% hint style="info" %}
Changing any module setting also triggers an automatic re-sync.
{% endhint %}
#### 4. Clear the cached feed file
The feed file is cached and reused between syncs to avoid unnecessary downloads. If the source changed in a way that reloading doesn't pick up, click **Clear** next to **Cached feed file** in the Feed Status panel (see the screenshot in step 1), then reload the feed data.
## Common problems
#### XML feed won't parse ("Premature end of data", "Unable to load XML source")
Usually the **product node** is wrong, or the feed nests the product element inside itself (some networks put a click URL as `β¦β¦β¦`, which the default parser can't read).
* Feeds added through the **wizard** handle this automatically β it detects the right product node and switches the parser when needed.
* For a feed set up manually (or one that still fails), open module settings and switch the **XML processor** to **XmlReader**, then reload. XmlReader handles nested and complex XML more reliably.
* Also confirm the **Product node** is the element that repeats once per product (e.g. `product`, `item`).
#### Wrong or empty product fields (wrong product node)
If the sample shows only one field, or products import with missing data, the wrong XML **product node** was detected.
* In the wizard, edit the **Product node** field and click **Re-scan fields** β the sample re-parses so you can confirm it looks right before importing.
* For an existing feed, set the correct **Product node** in module settings and reload.
#### FTP feed won't download
* URL-encode any special characters in the username or password: `@` β `%40`, `:` β `%3A`, `/` β `%2F`. For example, the password `pass@123` becomes `pass%40123`.
* Make sure the URL points to a **file**, not a directory (it must not end in `/`).
* Confirm your host allows **outbound FTP** connections β some managed hosts block them.
#### Wrong currency
The wizard detects the currency from the sample. If it guessed wrong (for example, a feed with no currency field), set the correct currency in the wizard's last step or in module settings, then reload.
# Coupon modules
# Admitad Coupons module
### Getting XML-file URL
1. To get the XML-file URL, first [create your account](https://www.keywordrush.com/go/admitad).
2. Log in to Admitad, follow `Tools` β `Coupons` β `Export` β `Get URL` to get the XML file.
{% hint style="info" %}
You can search with filters; all search parameters will be added to the URL of the XML file.
{% endhint %}
{% hint style="success" %}
Don't forget to tick **`Only my programs`** to get commissions from your programs.
{% endhint %}
Instead of keywords, you can search by **advertiser ID** to return all coupons for that advertiser.
# CJ Links module
{% hint style="info" %}
You can use this module to search for coupons and text links. Use [CJ Products](/modules/affiliate/cjproducts) module to search for products.
{% endhint %}
### Getting Personal Access Token
A Personal Access Token is a unique identification string for your account. Personal Access Tokens allow for secure authentication when accessing the CJ APIs.
You can manage your personal access tokens from the [personal access tokens](https://developers.cj.com/account/personal-access-tokens) page.
### Getting Website ID
1. Log in to your CJ account.
2. Follow `Account β Websites` and find the ID of your site:
# Coupon module
The Coupon module lets you add coupons to a post **manually**.
On the **Coupons** tab of the product manager, click **+ Add coupon**. The edit drawer opens in add mode β fill in the coupon's details (**Title** and **URL** are required) and click **Add coupon**.
+ Add coupon opens the edit drawer in add mode
{% hint style="info" %}
You don't need to activate the Coupon module first β Content Egg activates it automatically the first time you save a manually added coupon.
{% endhint %}
# Lomadee Coupons module
### Getting Source ID
1. Use your existing account or [create a new account](https://sso.lomadee.com/register.html).
2. Log in to Lomadee. Go to `Tools` β `IDENTIFICATION CODES` and find your `Source Id`.
# Skimlinks Coupons module
### How to get Public Key, Account Type, Account ID
1. Use your existing account or [create a new account](http://www.keywordrush.com/go/skimlinks).
2. To authenticate with the Skimlinks Merchant API, you first need to apply for an API key. You can do so by logging in to the [Publisher Hub](http://www.keywordrush.com/go/skimlinks) and requesting approval under `Toolbox` β `API Authentication credentials`.
3. Once you are approved, the same page will display your `Public Key`, your `Account Type`, and your `Account ID`.
{% hint style="info" %}
You can search for coupons and offers by keywords or domain name.
{% endhint %}
# Tradedoubler Coupons module
### Getting Token
1. Log in to Tradedoubler and add your site (if you didn't do this already).
2. Follow: `Account` β `Manage tokens` and find your Token with the label `VOUCHERS`.
# Tradetracker Coupons module
### How to get Customer ID and Passphrase
1. Log in to Tradetracker.
2. Go to `Creatives` β `Web Services` and find `Customer ID` and `Passphrase` in the right-side column. Sometimes you need to get access to this panel β click `Β«request accessΒ»`.
### How to get Affiliate Site ID
1. Log in to your account and add your site.
2. Follow `Account` β `My Sites`. The ID (without #) next to your site name is your `Affiliate Site ID`.
# Media modules
Bring free images and videos into your content from stock media services.
Media modules pull free **images** and **videos** into your posts from stock and media services. There are two families:
* **Image modules** β Pixabay, Pexels, Unsplash, Flickr, Google Images, Bing Images.
* **Video modules** β YouTube, Pexels Videos.
Activate a media module like any other and enter its API key where required. Then add images or videos to a post from the **Content Egg** panel using its **Images** or **Videos** tab, and display them with the **CE Images** and **CE Videos** blocks. The workflow is the same as for products β see [Add & manage products](/set-up-products/how-to-add-products) and [How content is displayed](/frontend/how-content-is-displayed).
{% hint style="info" %}
The older text-oriented "content" modules (Related Keywords, RSS Fetcher, Twitter, and similar) are deprecated and have been removed.
{% endhint %}
# Bing Images module
### Getting Subscription Key
1\. Go to Microsoft Cognitive Services: .
2\. Click on `Get API Key` and subscribe to `Bing Search API`. Follow the on-screen instructions to register for a subscription key.
3\. Find your `Subscription key` for Search API.
{% hint style="info" %}
You can set several keys separated by commas so that the plugin will use a random key for each request.
{% endhint %}
# Flickr module
### Getting API key
1. If you don't have a Yahoo account, first create one:
2. To obtain the key, go to:
3. Fill in the form on your own.
4. At the final stage you will have access to your API Key:
{% hint style="info" %}
βNoncommercialβ keys are issued automatically, while βcommercialβ keys take a long time to be reviewed.
{% endhint %}
# Google Images module
### Getting Your Search Engine ID
Follow these steps to set up a Google Custom Search Engine (CSE):
1. **Create a Custom Search Engine**
* Go to [Create a new CSE](https://cse.google.com/cse/create/new).
* Select **Search the entire web**.
* Enable **Image search**.
* Click **Create**.
2. **Get Your Search Engine ID**
* On the next screen, click **Customise**.
* Locate your **Search engine ID**.
* Copy and save this ID in the module settings.
### Getting an API Key
1. **Open the Google API Console**
* Visit [Google API Console](https://console.developers.google.com/).
2. **Create a Project**
* If you do not have a project, click **API Project** β **New Project**.
* Enter a name and click **Create**.
3. **Enable the Custom Search API**
* In the left menu, go to **Library**.
* Search for **Custom Search API**.
* Click **Enable**.
4. **Create an API Key**
* Go to **Credentials** in the left menu.
* Click **Create credentials** β **API key**.
* Copy and store the generated key.
{% hint style="warning" %}
**Note:** The JSON/Atom Custom Search API provides 100 search queries per day for free. To increase this limit, enable billing in the Google API Console.
{% endhint %}
# Pexels module
The Pexels integration ships as two modules β **Pexels** (photos) and **Pexels Videos** β and both use the same API key.
### Getting API Key
1. Create a free account on Pexels:
2. Go to the API page and request access:
3. Open your API dashboard and copy your `API Key`:
4. Paste the key into the module settings (enter it in both the Pexels and Pexels Videos modules).
{% hint style="info" %}
The API is free with a default rate limit of **200 requests per hour** and **20,000 requests per month**. You can request a higher limit from Pexels if you need it.
{% endhint %}
{% hint style="info" %}
Attribution is not required by the Pexels license, but crediting the photographer and Pexels is always appreciated.
{% endhint %}
# Pixabay module
### Getting API Key
1. Make an account on Pixabay:
2. Log in to your account.
3. Go to this link: . Scroll down and find your `API Key`, as shown in the image:
# Unsplash module
### Getting Access Key
1. Create a free account on Unsplash: and confirm it through the verification email Unsplash sends you.
2. Register a new application:
3. Accept the API use terms, then fill in your application name and description.
4. Open your application and copy the `Access Key`.
{% hint style="warning" %}
Register your application **only after** you have confirmed your new account through the verification email. Until your email is verified, Unsplash does not let you create an application.
{% endhint %}
{% hint style="info" %}
New applications start in Demo mode with a default rate limit of **50 searches per hour**.
{% endhint %}
# Pexels Videos module
The Pexels Videos module adds free stock **videos** from [Pexels](https://www.pexels.com/) to your posts.
### Getting an API key
1. Register for a free Pexels API key at [pexels.com/api](https://www.pexels.com/api/).
2. In **Content Egg β Modules**, activate **Pexels Videos** and paste your API key.
{% hint style="info" %}
Pexels Videos uses the same Pexels API key as the Pexels (images) module.
{% endhint %}
### Notes
* The video file is always hotlinked from Pexels. Optionally, the video's poster image can be saved to your server (a module setting).
* Add videos to a post from the **Videos** tab of the Content Egg panel, and display them with the **CE Videos** block.
# Youtube module
### Getting API Key
1\. Go to the Google API console (you must have a registered Google account): [https://console.developers.google.com](https://console.developers.google.com/)
2\. If you have not created a project in the API console yet, create it now:
3\. Go to `Your project` β `APIs & Auth` β `APIs`, search for the YouTube API in the list of available APIs, and activate it:
4\. Go to `Your project` β `Credentials`. If you have not created an `API Key` yet, create it now:
{% hint style="warning" %}
Don't set IP-address limits for the API key. If you do, use your server's external IP address (not your local IP).
{% endhint %}
# Module cloning
All affiliate modules include a feature that allows you to clone a module, effectively creating a duplicate of the parent module.
{% hint style="success" %}
You can create **up to 10 cloned modules** for each parent module.
{% endhint %}
This feature is useful when:
* Creating separate modules for different locales (e.g., Amazon US, UK, IT, FR).
* Setting up distinct modules with unique product search filters.
### How to Clone a Module
To create a cloned module:
1. Navigate to the module settings page.
2. Click the **"Clone This Module"** button.
### How to Delete a Cloned Module
{% hint style="danger" %}
**Warning:** Deleting a cloned module will permanently remove its settings and all associated products from all posts. This action cannot be undone.
{% endhint %}
If you no longer need a cloned module, you can delete it:
1. Go to the settings page of the cloned module.
2. Click **"Delete This Module."**
# Deprecated modules
Affiliate networks may occasionally close their APIs. When this happens, we mark the module as "deprecated." Existing products will remain on your website for as long as you wish, but you won't be able to add new ones, and prices will no longer be updated. We recommend using alternative modules.
# My network isn't listed
What if your advertiser is not yet supported?
Not all affiliate networks offer product APIs, which means direct integration into the plugin as separate modules is not possible. However, there are still ways to work with almost any affiliate program. Below, you will find several methods to accomplish this.
### 1. Affiliate Egg integration
[Affiliate Egg](https://www.keywordrush.com/affiliateegg) retrieves data directly from the store's website without needing an API. You [can activate](/integrations/affiliateeggintegration) Affiliate Egg parsers as separate modules within the Content Egg plugin. Additionally, we [can create custom parsers](https://ce-docs.keywordrush.com/modules/affiliate-egg-integration#how-to-order-custom-parsers) tailored to your specific merchants.
{% content-ref url="/pages/-MTUR8LzwpnWFrWLf5q3" %}
[Affiliate Egg integration](/modules/affiliate-egg-integration)
{% endcontent-ref %}
### 2. Feed modules
If your merchant provides a CSV/XML product feed, you can utilize Feed modules. Check if such a feed is available within your affiliate network.
{% content-ref url="/pages/-MUsIUexKR7xniUsTHce" %}
[Feed modules](/modules/feed-modules)
{% endcontent-ref %}
### 3. Offer module
You can use the Offer module to manually add any products.
{% content-ref url="/pages/-M4jZ\_kuQYziFGEUjxm2" %}
[Offer module](/modules/affiliate/offermodule)
{% endcontent-ref %}
# Affiliate Egg integration
[Affiliate Egg](https://www.keywordrush.com/affiliateegg) is a companion plugin that reads product data straight from store websites β **no API and no data feed required**. With the integration you can **connect almost any online store** as a Content Egg module and use it like any other module: keyword search, direct URLs, price updates, comparisons, templates and blocks.
* **No API required** β extract price, image, stock and more directly from the store page.
* **Almost any store** β connect a supported shop, or **any custom domain** by its address.
* **Custom parsers** β order a hand-written parser for stores that need one (see [Ordering a custom parser](#ordering-a-custom-parser)).
* **Full Content Egg power** β price updates, price comparison, product import, templates and blocks all work with connected stores.
{% embed url="" %}
{% hint style="info" %}
New to the difference between our plugins? Read [Content Egg vs Affiliate Egg vs External Importer](https://ei-docs.keywordrush.com/integration/ei-vs-ce-vs-ae).
{% endhint %}
### Requirements
* The [Affiliate Egg](https://www.keywordrush.com/affiliateegg) plugin is **installed, activated, and has a valid license**.
* **Affiliate Egg 11.0.0 or newer** to connect custom (unregistered) domains.
### Connect a store
1. Go to **Content Egg β Modules** and click **Connect a store** in the *Affiliate Egg modules* section.
2. Enter the **shop domain** (for example `example.com`).
3. *(Optional)* Enter a **Search URL** to enable keyword search β see [Search URL](#search-url). Leave it empty to work with direct product and category URLs only.
4. Click **Connect**. You're taken to the new module's settings, and the module is **active by default**.
### Add products to a post
Open a post and find the connected store in the Content Egg metabox. There are three ways to add products:
* **Direct product URL** β paste a product page URL. **Recommended:** it's the most reliable and uses the fewest requests to the store.
* **Category / listing URL** β paste a category URL to pull several products from it.
* **Keyword search** β type a keyword. Requires a Search URL.
{% hint style="info" %}
Prefer **direct product URLs** over keyword search whenever you can β fewer requests to the source site means less chance of being blocked.
{% endhint %}
### Module settings
Open the module's settings page (**Content Egg β Modules β \[your store]**) to configure:
* **Affiliate link (Deeplink)** β turn direct product links into your affiliate links. You can change this at any time to switch networks. See [Deeplink settings](https://ce-docs.keywordrush.com/modules/deeplink-settings).
* **Results** β how many products a keyword search returns.
* **Save images** β store product images on your own server.
* **Update frequency** β how often prices and availability refresh.
### Search URL
A Search URL lets a **custom domain** module search by keyword. To build one:
1. On the store's website, search for any product β say, `shoes`.
2. Copy the URL from your browser's address bar.
3. Replace your search word with **`%KEYWORD%`**.
So a search that looks like this:
```
https://example.com/search?q=shoes
```
becomes:
```
https://example.com/search?q=%KEYWORD%
```
* If you paste a normal search URL (for example `?q=bike`), Content Egg tries to insert `%KEYWORD%` for you automatically.
* No Search URL? The module still works with **direct product and category URLs** β only keyword search is unavailable.
{% hint style="warning" %}
Some stores render their search results with JavaScript, which a parser can't read. If keyword search returns nothing, use a **direct product URL** instead.
{% endhint %}
### Ordering a custom parser
**Why you might need one.** Custom-domain modules use Affiliate Egg's generic parser, which reads most modern stores. But some shops have unusual markup the generic parser can't understand β when that happens a search shows **"No product data found β this shop likely needs a custom parser."** A custom parser is hand-written for that specific store, so it reads its products reliably.
**Cost:** $25 per parser. Each store needs its own parser, and you can use it on any of your sites.
**Process:**
1. **Email us** your list of stores through the [contact form](https://www.keywordrush.com/contact).
2. **Invoice** β we review your list and send you an invoice.
3. **Creation** β it usually takes 1β2 days.
**Installation:**
* Copy the parser files to your server's `/wp-content/affegg-parsers/` directory.
* Custom parsers work exactly like the built-in ones β connect the store the same way as above.
**Guarantee:** 6 months. If a parser needs corrections during that time, we make them for free.
### Troubleshooting
When a search can't return products, Content Egg shows a short explanation in the metabox. Here's what each message means and how to resolve it:
| Message | What it means | What to do |
| -------------------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Blocked by the site** (503 / 403) | The store is blocking automated requests. | Enable a [scraping service](https://ae-docs.keywordrush.com/extractor-settings); slow down price updates; add products gradually. |
| **No product data found β needs a custom parser** | The generic parser couldn't read the product page. | [Order a custom parser](#ordering-a-custom-parser) for this store. |
| **No products found β try a direct product URL** | Keyword search returned nothing, often a JavaScript search page. | Paste a direct product URL instead. |
| **Keyword search isn't set up / Add a Search URL** | No keyword search is configured for this store. | Use a direct URL, or add a [Search URL](#search-url) in the module settings. |
| **That URL is for a different store** | The URL's domain doesn't match this module. | Enter a URL from the connected store, or a keyword. |
| **The store took too long to respond** | The request timed out. | Try again, or enable a scraping service. |
| **Your session has expired** | The editor was left open past the login token's lifetime. | Reload the page and search again. |
#### Avoid getting blocked
Affiliate Egg makes a separate HTTP request for each product search and price update. Sites with anti-bot protection or per-IP rate limits can return **503** or **403** errors if you make too many requests.
A block usually lifts after 24 hours. To avoid it in the first place:
* [x] **Search by direct product URL** instead of keywords (most important).
* [x] **Limit price updates** β avoid very frequent update schedules.
* [x] **Add products gradually** β don't import too many at once.
* [x] **Use a scraping service** for a persistent block β see [Extractor settings](https://ae-docs.keywordrush.com/extractor-settings).
### FAQ
**Why do I need Affiliate Egg if I have Content Egg?**
Not every store with an affiliate program offers a product API β smaller shops especially. Affiliate Egg reads the data directly from the site, so you can promote stores Content Egg doesn't support natively. If a store needs it, we can also build a custom parser for you.
**Which stores can I connect?**
Almost any online store β supported shops out of the box, and any other domain via the generic parser (Affiliate Egg 11.0.0+). A few stores may need a custom parser.
**Direct URL or keyword search β what do you recommend?**
Direct product URLs whenever possible. They're more reliable and make fewer requests to the store, which lowers the risk of being blocked.
**Amazon is in both plugins β which should I use?**
Prefer Content Egg's Amazon module. Amazon's API is fast and stable, while intensive web parsing can get your IP blocked.
# Deeplink settings
Deeplinks allow you to convert a direct product URL into a trackable affiliate link. This mechanism ensures that your affiliate program tracks clicks correctly and rewards you with commissions for sales. Most affiliate networks use one of two methods to generate affiliate links. Below, you'll find detailed explanations and setup instructions for each.
{% hint style="success" %}
**AI Helper: Generate Your Deeplink Automatically**
You can now use our **specialized GPT assistant** to generate correct Deeplink templates.
π [Open Deeplink Setup for Content Egg](https://chatgpt.com/g/g-6911df85b340819188ccf04452586c6e-deeplink-setup-for-content-egg)
Simply:
1. Paste your sample affiliate link(s) from your network dashboard.
2. The assistant will detect your format and build a proper Deeplink template for Content Egg.
3. Copy the suggested template into your **Deeplink Settings**.
{% endhint %}
### 1. Deeplink-Based Affiliate Links
Many affiliate networks (e.g., AWIN, ShareASale, CJ) use **Deeplink redirects**. These links first route the visitor through the affiliate network's servers for tracking purposes before redirecting them to the actual product page.
#### Example of a Deeplink:
```
https://ad.admitad.com/g/383ee6455773fd57830a7d95a12660/?ulp=https%3A%2F%2Fwww.lightinthebox.com%2Fen%2Fp%2Fkids-girls-rainbow-dress-purple_p7923807.html
```
As you can see, a Deeplink typically has **two components**:
* The **affiliate networkβs tracking script**.
* The **encoded product URL** from the advertiserβs website (percent-encoded format).
{% hint style="info" %}
You can replace the product part of the URL with any other valid product link β the Deeplink will still function correctly as long as the structure is preserved.
{% endhint %}
#### How to Configure a Deeplink
1. **Generate a sample affiliate link** for any product page (not the homepage) using your affiliate account or tools provided by the network.
2. **Identify the product URL** inside the link.
3. **Replace** the product URL portion with the [placeholder](https://ce-docs.keywordrush.com/features/subid-tracking#url-dynamic-placeholders) `{{url_encoded}}`.
4. **Paste** the new Deeplink into the **Deeplink URL field** in Content Egg.
**Example Template:**
```
https://ad.admitad.com/g/383ee6455773fd57830a7d95a12660/?ulp={{url_encoded}}
```
When generating links, Content Egg will automatically substitute `{{url_encoded}}` with the current productβs encoded URL.
{% hint style="info" %}
Use `{{url}}` instead if the network does **not** require encoding.
{% endhint %}
### 2. Direct Affiliate Links with ID Parameters
Some affiliate programs (like Amazon) don't use Deeplink redirection. Instead, they simply append a unique affiliate ID to the product URL.
#### Example Amazon Affiliate Link:
```
https://www.amazon.com/dp/B07XKF5RM3/?tag=yourtag-20
```
* `yourtag-20` is your **affiliate tracking ID**
* `tag` is the **parameter name** used by Amazon (this may vary across networks)
#### How to Set Up Affiliate ID-Based Links
1. **Generate a few affiliate links** using your advertiserβs website or affiliate dashboard.
2. **Identify the common tracking ID** β this will appear the same across all links.
3. **Locate the tracking parameter name** (e.g., `tag=yourtag-20`, `aff_id=abc123`).
4. **Enter the full parameter** (name + value) in the domain settings within Content Egg.
{% hint style="warning" %}
**Do not include** `?`, `&`, or any prefixes before the parameter. Content Egg will automatically format the final URL properly when generating links.
{% endhint %}
#### β Correct:
* `tag=yourtag-20`
* `aff_id=abc123`
#### β Incorrect:
* `?tag=yourtag-20`
* `&tag=yourtag-20`
* `yourtag-20`
* Just `tag` without a value
### Optional Tracking Parameters
Some networks allow you to pass additional information (e.g., sub IDs) for better tracking. You can use the following dynamic templates within your Deeplink:
* `{{post_id}}` β WordPress Post ID
* `{{author_id}}` β Post Author's User ID
* `{{author_login}}` β Post Authorβs Username
* `{{item_unique_id}}` β Unique ID of the product
Please check the full list of [supported placeholders](https://ce-docs.keywordrush.com/features/subid-tracking#url-dynamic-placeholders).
### Multiple Deeplinks
Content Egg Pro supports multiple Deeplinks for different domains or subdomains. This is useful if you work with networks that require different tracking templates for specific sites.
Syntax:
```
default_deeplink;subdomain1:deeplink1;subdomain2:deeplink2
```
Example:
```
https://alitems.com/g/1234567/?ulp={{url_encoded}};tmall.aliexpress.com:https://alitems.com/g/abcdef/?ulp={{url_encoded}}
```
In this example:
* The default Deeplink (`https://alitems.com/g/1234567/?ulp={{url_encoded}}`) will be used for all domains unless a match is found.
* A specific Deeplink (`https://alitems.com/g/abcdef/?ulp={{url_encoded}}`) will be used **only** for `tmall.aliexpress.com`.
### Advanced Regex Syntax
For more complex scenarios, you can apply **custom rewrite rules** using regular expressions in the following format:
```
[regex][pattern][replacement]
```
This allows you to **search and replace** parts of the product URL using regex.
Examples:
Flipkart:
```
[regex][/https://www.flipkart.com/(.+)/][http://dl.flipkart.com/dl/$1&affid=myaffid]
```
Shopee Malaysia:
```
[regex][/https://shopee.com.my/(.+)/][https://shopee.com.my/universal-link/$1?utm_source=an_12345670001&utm_medium=affiliates&utm_campaign=-&utm_content=kpgmk-aepro---&af_siteid=an_12358850002&pid=affiliates&af_click_lookback=7d&af_viewthrough_lookback=1d&is_retargeting=true&af_reengagement_window=7d&af_sub_siteid=kpgmk-aepro---&c=-]
```
### Final Tips
* After configuring your Deeplinks or affiliate IDs, **test a few product pages**.
* Ensure that redirection works as expected and **clicks are being tracked** properly in your affiliate dashboard.
* If tracking isnβt working, double-check the templates and encoding format.
# Add & manage products
Search for products across your modules and attach them to a post β the Content Egg product workflow in the block editor.
Content Egg follows one simple loop:
> **Modules** fetch product data β the **Product Manager** searches and attaches products to your post β **blocks** render them on the page.
This page covers the middle step: finding products and attaching them to a post in the **block editor**.
{% hint style="info" %}
Using the **classic editor** or a **custom post type** like WooCommerce products? The workflow is identical β only the location differs. See **Classic editor & custom post types** *(guide coming next)*.
{% endhint %}
{% hint style="warning" %}
Search only spans modules that are **active and configured**. If a network is missing from your results, activate its module first β see [Modules](/modules/general-information).
{% endhint %}
## Where products are managed
In the block editor, open the **Content Egg** panel from the egg icon in the top-right plugin area. By default it's a compact **Products** panel in the right sidebar, listing the products attached to this post. The panel has a tab for each family β **Products**, **Coupons**, **Images**, and **Videos**. This guide uses **Products**; the other families work exactly the same way.
The Content Egg panel β your attached products for this post
{% hint style="info" %}
**Choose your interface.** Change how the manager appears at **Content Egg β Settings β Egg Blocks β Product manager interface**:
* **In-editor sidebar** *(default)* β the compact Products panel beside the editor.
* **Full product manager** β the full search & manage screen shown inline, instead of opening as a modal.
* **Classic metabox** β the older interface. *Deprecated; it will be removed in a future version.*
{% endhint %}
{% hint style="info" %}
**Same manager everywhere.** In the classic editor and on custom post types (including WooCommerce products), the same manager appears in the right sidebar β identical to the block-editor panel. Only the mount differs; everything on this page applies there too. See [Classic editor & custom post types](/set-up-products/classic-editor).
{% endhint %}
## The Products panel
The panel lists the products already attached to this post β thumbnail, title, price, and quick actions. From here you can:
* **Search & add productsβ¦** β opens the full-screen manager on the **Search** tab.
* **Manage products** (list icon) β opens the manager on the **Added** tab.
Each row also lets you **edit**, **remove**, **reorder** (drag), and **insert a block** at the cursor.
## Search & add products
Click **Search & add productsβ¦** to open the manager on the **Search** tab.
* Type a **keyword** and search. Content Egg queries all your active modules at once and lists the results.
* Choose which **modules** to search. By default, the highest-priority module is preselected (priority is set in each module's settings).
* Click **Add** on a result β or click anywhere on the product row β to attach it. Products already on the post are flagged.
Search your active modules and add products to the post
The search box adapts to the modules you're searching β its placeholder shows what you can enter, for example *"Keyword, product URL, or EAN."*
* **Product URL** β some modules let you paste a product page URL to add that exact product.
* **EAN / GTIN** β some modules let you search by EAN. To match the same product across stores, see [Price comparison](/set-up-products/price-comparison-websites).
### Multiple keyword search
Enter several keywords separated by commas and Content Egg runs a separate query for each, then merges the results into one list. This is useful for [EAN/GTIN searches](/set-up-products/price-comparison-websites), and it also powers [product-list auto-update](/updating-products/updating-the-product-list) and [autoblogging](/set-up-products/autoblogging).
You can also assign results to [groups](/frontend/groups) directly from the search, using this syntax:
```
keyword1,keyword2,keyword3 -> group1,group2,group3
```
## Manage attached products
Open the **Added** tab (or click **Manage products**) to work with everything attached to the post:
* **Edit** a product's fields and description.
* Assign products to **groups**.
* **Reorder** by dragging, or **bulk remove**.
* **Refresh prices** to re-pull current price and availability.
* Generate an **AI title** or **description**.
Manage, group, reorder, refresh, and enrich attached products
{% hint style="info" %}
**Tip:** double-click any product on the Added tab to open its **edit drawer** β the fastest way to adjust fields, edit the rich-text description, or run the AI title/description.
{% endhint %}
### Editing a product
The edit drawer gives you the product's fields plus a rich-text **description** editor.
The edit drawer β fields, rich-text description, and AI actions
{% hint style="warning" %}
**AI title & description** need AI features enabled first. Go to **Content Egg β Settings β AI**, enter your API key, and configure the defaults. See [Activating AI features](/ai/activating-ai-features).
{% endhint %}
## Put the products on the page
Attached products are saved to the post automatically β a **block** renders them. You have two ways to place one:
1. **By filter** β insert the **CE Products** block from the block inserter (under the **Content Egg** category). By default it renders products by filter: all modules, or the modules/groups you choose.
2. **Bound to specific items** β from the panel or the Added tab, drag an item into the editor (or use **insert**) to drop a CE Products block bound to exactly those products. Select several with **Ctrl/Shift** and drag them together to build a product list.
Drag products from the panel into the editor β select several with Ctrl/Shift to drop them as one list
You can also start from the block: add an empty **CE Products** block, then open the Product Manager right from the block's sidebar to search and bind products to it.
The CE Products block renders your products β by filter or bound to specific items
For all block settings β template, filter vs binding, columns, showing or hiding fields β see [Gutenberg product blocks](/frontend/gutenberg-blocks).
## Build a shortcode
The manager's **Shortcode** tab generates a `[content-egg-block]` shortcode you can paste anywhere. It's most useful in the **classic editor**, but not only β shortcodes expose more parameters than blocks and let you select **custom templates**.
Configure:
* **Product groups**
* **Modules**
* **Exclude modules**
* **Limit**
* **Template** (including custom templates)
Copy the generated shortcode and paste it into your content. See [Shortcode parameters](/frontend/shortcode-parameters) for the full parameter list.
Build a [content-egg-block] shortcode with groups, modules, limit, and template
# Classic editor
Add products in the classic editor and on custom post types like WooCommerce β the same Product Manager, as a metabox, with shortcodes for display.
The Content Egg Product Manager isn't only for the block editor. On the **classic editor** and on **custom post types** β including **WooCommerce products** β the same manager appears **automatically** in the right sidebar, identical to the block-editor panel. There's nothing to enable.
## The Product Manager metabox
The metabox is the same Product Manager you'd use in the block editor, just in a different place:
* The same family tabs β **Products**, **Coupons**, **Images**, **Videos**.
* The same **Search**, **Added**, and **Shortcode** tabs, edit drawer, groups, price refresh, and AI title/description.
The same Product Manager, in the right sidebar
{% hint style="info" %}
The whole search-and-attach workflow is identical to the block editor. For the full walkthrough β searching modules, adding, managing, groups, and AI β see [Add & manage products](/set-up-products/how-to-add-products).
{% endhint %}
## Displaying products without blocks
The classic editor has no blocks, so products are displayed with **shortcodes** or **automatic embedding**:
* **Shortcode** β on the manager's **Shortcode** tab, build a `[content-egg-block]` (choose groups, modules, limit, and template, including custom templates) and paste it wherever you want the products to appear. See [Shortcode parameters](/frontend/shortcode-parameters).
* **Automatic embedding** β enable it in a module's settings to place its products at the start or end of the post automatically, with no shortcode. See [How content is displayed](/frontend/how-content-is-displayed).
## WooCommerce products
On WooCommerce products (and other custom post types) the metabox appears automatically β attach products exactly as above. For WooCommerce-specific display and synchronization (price sync, attributes, offers badges), see the [WooCommerce](/woocommerce/general-information) section.
# Import tools
### Watch Import Tools in Action
{% embed url="" %}
Content Egg's Import Tools make it easy to automatically and efficiently create:
* WordPress posts
* WooCommerce products
using product data from connected modulesβindividually or in bulk.
**Access:**\
Go to **Content Egg > Import Tools** in your WordPress dashboard.
### Table of Contents
{% content-ref url="/pages/3wHeLCAPNMRWoiaqEVHt" %}
[Import Presets](/set-up-products/import-tools/import-presets)
{% endcontent-ref %}
{% content-ref url="/pages/Vct1t557dk2DhFCT4MmQ" %}
[Import Queue](/set-up-products/import-tools/import-queue)
{% endcontent-ref %}
{% content-ref url="/pages/BH038dYJx1iXBjYApxMj" %}
[Search and Import](/set-up-products/import-tools/search-and-import)
{% endcontent-ref %}
{% content-ref url="/pages/LWU1Bwhn0TcZJqvl5f7A" %}
[Bulk Import](/set-up-products/import-tools/bulk-import)
{% endcontent-ref %}
{% content-ref url="/pages/sDAijk4TAIJHDK7X7B8n" %}
[Feed Import](/set-up-products/import-tools/feed-import)
{% endcontent-ref %}
{% content-ref url="/pages/ZEhNI6HGvvkLXIpnaM4R" %}
[Auto Import](/set-up-products/import-tools/auto-import)
{% endcontent-ref %}
# Import Presets
**Import Presets**
Import Presets are reusable configurations that simplify and speed up your import workflow. They allow you to apply consistent settings across all import methods, including Search, Bulk Import, Feed Import, and Auto Import.
The plugin comes with several built-in presets that you can edit or duplicate as needed.
You can also enhance your imported content using AI:
* Select from built-in AI prompts
* Or write your own custom prompts to generate unique, helpful content tailored to your site visitors β for the post title and body, for extra content sections, or for SEO fields such as the meta description and focus keyword
**Access:**\
Content Egg > Import Tools > **Presets** tab
When you import via Search, Feed Import, Auto Import, or Bulk Import, simply choose the preset you want to apply.
### **Main Settings**
**1. Post Type**\
Choose the type of content to create:
* **Post** β Standard WordPress post
* **WooCommerce Product** β Requires WooCommerce to be installed
For WooCommerce products, you can choose between two product types:
* **External/Affiliate Product -** Customers are redirected to the merchantβs website via your affiliate link. Products cannot be added to the cart on your site.
* **Simple Product -** A standard WooCommerce product.
{% hint style="info" %}
To automatically synchronize product images and prices with WooCommerce, go to Content Egg β Settings β WooCommerce. Ensure that the required modules are enabled under the "Automatic Synchronization Modules" section.
{% endhint %}
**2. Post Title Template**\
Use placeholders to generate dynamic post titles:
* `%AI.title%` β AI-generated title (set under AI-Powered Post Title)
* `%AI.content%` β AI-generated content snippet (set under AI-Powered Post Content)
* `%AI.your_prompt_name%` β the result of one of your own prompts (see Custom Prompts below)
* `%PRODUCT%` β Entire product object as JSON, including title, description, price, specifications, etc.
* `%PRODUCT.title%` β Product title
* `%PRODUCT.price%` β Product price
* `%PRODUCT.domain%` β Merchant domain
* `%PRODUCT.url%` β Product URL
* `%PRODUCT.ATTRIBUTE.attribute-name%` β Specific product attribute value
For the full list of supported placeholders, see [this link](/faq/placeholders-reference).
*Example:*
```
Buy %PRODUCT.title% for %PRODUCT.price% β %AI.title%
```
{% hint style="info" %}
**Pro Tip:**
Use `%SOURCE%` and `%SOURCE.%` placeholders instead of `%PRODUCT%`.
* `%SOURCE%` (and `%SOURCE.*%`) returns the original product data before AI-powered fields are applied.
* `%PRODUCT%` returns the data after AI-powered processing.
{% endhint %}
**3. Post Body Template**
Craft your content with the same placeholders as above, plus any Content Egg shortcodes to display product blocks.
*Example:*
```markdown
[content-egg-block template=review_box groups=ProductImport]
%AI.content%
```
{% hint style="info" %}
**Pro Tip:** Imported products are automatically assigned to the `ProductImport` group. Use `groups="ProductImport"` in your shortcodes to display only those items.
{% endhint %}
**4. AI-Powered Product Fields**
Enhance raw product data by generating short titles, subtitles, badges, ratings, and more.
1. Go to **Content Egg > Settings > AI** and enter your OpenAI API Key.
2. Enable the fields you want AI to generate.
**5. AI-Powered Post Title**
Select a predefined AI prompt to generate an optimized and relevant post title based on product data.
Choose a prompt that best matches the content type you're creating.\
For example, if you're generating a product review, select a **review-style prompt** for both the **title** and **content** to ensure consistency.
You can also use a **custom prompt** tailored to your specific needs.
{% hint style="success" %}
The generated title will be inserted using the `%AI.title%` placeholder in your **Post Title Template**.
{% endhint %}
**6. AI-Powered Post Content**
Choose a predefined AI prompt to automatically generate engaging and informative post body content based on the product data.
You can use this feature to create content such as:
* Product reviews
* Buyerβs guides
* How-to instructions
* Unique WooCommerce product descriptions
* And much more...
{% hint style="success" %}
Use `%AI.content%` in your Body Template to insert the generated content.
{% endhint %}
**7. Custom Prompts**
Write your own prompt, give it a short name, and use its placeholder anywhere in the preset. Add as many prompts as you need.
Each prompt has three fields:
* **Name** β a short name such as `meta_description`. It creates the placeholder shown next to the field, for example `%AI.meta_description%`. Use the copy button to copy it.
* **Prompt** β the instruction sent to the AI. Use placeholders like `%SOURCE%`, `%PRODUCT%`, `%PRODUCT.title%`, `%PRODUCT.price%` and `%PRODUCT.domain%` to pass product data. See the [full list of placeholders](/faq/placeholders-reference).
* **Result** β **Plain text** for values like a meta description or a keyword, **HTML** for content sections with headings, lists and tables.
Once a prompt is named, you can use it in three ways:
* Insert `%AI.your_name%` into the **Post Title Template** or **Post Body Template**
* Insert it into a **Custom Meta Field** value (see below)
* Pick it in the **AI-Powered Post Title**, **Post Content** or **Short Description** menus, where it appears as *Custom prompt: your\_name*
*Example β a meta description (Result: Plain text):*
```
Write a 155-character meta description for %PRODUCT.title%. Lead with the single biggest real benefit from the data below. Plain text, no quotation marks.
%SOURCE%
```
*Example β a product overview (Result: HTML):*
```
Write an overview of %PRODUCT.title% (priced at %PRODUCT.price%), highlighting its three best features in bullet points. Use only the data below.
%SOURCE%
```
Add `%SOURCE%` on its own line at the end whenever the answer has to state facts about the product β it passes the title, description, price, rating and specifications to the AI, so it writes from real data instead of guessing. Leave it out for purely wording tasks:
*Example β a title prompt:*
```
Make the product title exactly five words. Source: '%PRODUCT.title%'
```
{% hint style="info" %}
Each prompt runs **once per imported product**, and only when it is actually used β a prompt you have defined but not referenced anywhere costs nothing.
The same value is reused everywhere you reference it, so one prompt can fill several fields with a single AI request.
{% endhint %}
{% hint style="warning" %}
When a prompt is selected in the **Post Title**, **Post Content** or **Short Description** menu, that field's own formatting is applied and the **Result** setting is ignored. Post Content always expects Markdown from the AI.
{% endhint %}
**8. Custom Meta Fields**
Save any generated value into a post meta field β most often the fields your SEO plugin reads.
Add a field, enter the meta key and a value, where the value can contain any placeholder:
| Field name | Field value |
| ----------------------- | ----------------------- |
| `_yoast_wpseo_metadesc` | `%AI.meta_description%` |
| `_yoast_wpseo_focuskw` | `%AI.focus_keyword%` |
If you don't know the exact meta key, use **Add a known field** and pick it from the list. Content Egg knows the fields for **Yoast SEO**, **Rank Math**, **SEOPress** and **The SEO Framework**, and shows the plugins installed on your site first.
{% hint style="info" %}
One prompt can feed several plugins at once β point both `_yoast_wpseo_metadesc` and `rank_math_description` at the same `%AI.meta_description%` and it is generated only once.
{% endhint %}
{% hint style="warning" %}
**All in One SEO** is not in the list. Since version 4 it stores titles and descriptions in its own database table rather than in post meta, so writing those meta keys would have no effect.
{% endhint %}
**9. Price comparison**\
Enable this option to automatically add the same product from multiple modulesβallowing you to build a price comparison block within a single post or WooCommerce product.
This feature works only with modules that support EAN-based search (European Article Number), enabling the plugin to match identical products across different sources.
When price comparison is enabled, modules will be processed based on **priority**, which you can configure in the settings of each module. Higher-priority modules are searched first when matching products.
{% hint style="info" %}
Recommendation: Use Sovrn (VigLink) for price comparison. It offers a large product database and doesnβt require individual advertiser approvals, making it easy to get started.
{% endhint %}
**10. Avoid Duplicates**\
Enable this option to automatically skip any product thatβs already in the Import Queue or has been previously imported as a post or WooCommerce product.
**11. Use as Default Preset**\
Select this to make the current preset the default choice across all Import Tools.
### Supported Modules for Price Comparison
* Amazon
* Amazon No API
* BestBuy
* Bol.com
* CJ Products
* eBay
* Kelkoo
* Kieskeurig.nl
* Sovrn (VigLink)
* Tradedoubler Products
* Tradetracker Products
* Walmart
* Webgains
### Add Extra AI-Generated Content Sections
Content Egg lets you generate **extra AI-powered sections** in addition to the main post title and body content during import. You can use this to automatically create additional sections such as:
* Product Benefits
* FAQ
* User Tips
* Pros & Cons
* β¦or anything you define with a custom prompt
**1. Create a Custom Prompt**
In your Import Preset, under **Custom Prompts**, add a prompt and give it a short name such as `faq` or `pros_cons`.\
Each prompt should output only the section text you want (e.g. just the benefits list or FAQ block).
Set **Result** to **HTML** so headings, lists and tables are kept.
**2. Insert the Placeholder in Your Template**
Add the placeholder shown next to the prompt name into your **Post Body Template**, where you want the generated content to appear:
```markdown
%AI.content%
FAQ
%AI.faq%
Pros and cons
%AI.pros_cons%
```
Add as many sections as you need β there is no limit.
**Result**
When importing products, Content Egg generates each section and inserts it into the post according to your template layout.
# Import Queue
When you import products or posts with any Import Tool, they arenβt created immediately. Each import request becomes a task thatβs processed in the backgroundβone task at a time.
**Location**\
Content Egg > Import Tools > Queue
**Task Statuses**
* **Pending**: Awaiting processing
* **Working**: Currently importing
* **Success**: Completed without errors
* **Failed**: Encountered an error
### How It Works
* The plugin uses the default WordPress Cron systemβ**no additional setup is required**.
* If youβve replaced WP-Cron with a real cron job, schedule it to run every 1β5 minutes for timely imports.
### Managing the Queue
* **Stop All Tasks**\
Click this button to remove any tasks that are still Pending.
* **Task Log & Links**\
In the queue table, each row shows a brief import log. Once a task completes, click the link to view the newly created post or WooCommerce product.
# Search and Import
The Search tool lets you find products by keyword and quickly create posts or WooCommerce products from the results.
**Access:**\
Go to **Content Egg > Import Tools > Search** tab
{% hint style="success" %}
Before using this tool, make sure your [**Import Presets**](/set-up-products/import-tools/import-presets) are configured according to your needs.
{% endhint %}
### How It Works
1. **Enter a search keyword**\
Type in the keyword related to the product you want to find.\
Some modules also allow searching by product URLs.
2. **Select a Module**\
Choose the product source (e.g., Amazon, Ebay) you want to search from.
3. **Apply filters (optional)**\
If the selected module supports it, you can set locale, price range, and other filters.
4. **Click the Search button**\
Product results will appear below the search form.
5. **Choose an Import Preset**\
Select a preset to define how the post or product will be created.
6. **Choose a Category**\
Select the post or WooCommerce product category for the imported items.\
If no category is selected, the default category from the chosen preset will be used.
7. **Import Products**
* Click individual products to import them one by one
* Or click **Import All** to queue all search results
{% hint style="info" %}
All selected products will be added to the Import Queue and processed in the background.\
To track their status, go to the [**Queue tab**](/set-up-products/import-tools/import-queue).
{% endhint %}
# Bulk Import
The **Bulk Import** tool allows you to create multiple posts or WooCommerce products using a list of keywords.
**Access:**\
Go to **Content Egg > Import Tools > Bulk Import** tab
{% hint style="warning" %}
Each keyword in the list will generate a separate post or product.
{% endhint %}
{% hint style="success" %}
Before using this tool, make sure your [**Import Presets**](/set-up-products/import-tools/import-presets) are configured according to your needs.
{% endhint %}
### How It Works
1. **Select an Import Preset**\
Choose how the post or product will be structured.
2. **Select a Category**\
Choose the post or WooCommerce category for the imported items.\
If left empty, the default category from the selected preset will be used.
3. **Select a Module**\
Pick the product source you want to use (e.g., Amazon, Ebay, etc.).
4. **Set Publishing Options**\
Choose when the posts should be published:
* Immediately
* Scheduled: Spread the publishing over 1 to 12 months
5. **Add Keywords or URLs**\
Enter one keyword per line. Each line will create a new post.\
Some modules also support direct product URLsβuseful for partial feed imports.\
Simply paste the product URLs, one per line.
6. **Start Import**\
Click the **Start Import** button. Tasks will be added to the [**Import Queue**](/set-up-products/import-tools/import-queue) and processed in the background.
{% hint style="info" %}
You can monitor import progress and access completed posts/products via the [Queue tab](/set-up-products/import-tools/import-queue).
{% endhint %}
# Feed Import
The **Feed Import** tool allows you to import a complete product feed with a single click. Each product in the feed will be turned into a separate post or WooCommerce product.
### Watch Feed Import in Action
{% embed url="" %}
{% hint style="warning" %}
**Note:** This tool imports **all** products from the selected feed. If you want to import only selected products, use the [**Bulk Import**](/set-up-products/import-tools/bulk-import) tool instead.
{% endhint %}
**Access:**\
Go to **Content Egg > Import Tools > Feed Import** tab
### Important Considerations
This tool makes it easy to queue large product feedsβeven 100,000+ itemsβwith one click. There are no built-in hard limits on the number of products you can import.
However, performance depends heavily on your hosting environment. Here's what you should know:
**Can WordPress Handle a Million Products?**
* **Up to 3,000 products:** Easy to manage, even on shared hosting.
* **3,000β30,000 products:** Recommended to use VPS or cloud hosting. Basic performance tuning required.
* **30,000β100,000+ products:** Needs a powerful server, database optimizations, and expert setup.
* **1,000,000+ products:** Technically possible, but not practicalβexpect slow performance, high server costs, and SEO indexing limits.
{% hint style="warning" %}
Be realistic with your goals. Start small and scale carefully.
{% endhint %}
{% hint style="success" %}
Before using this tool, make sure your [**Import Presets**](/set-up-products/import-tools/import-presets) are configured according to your needs.
{% endhint %}
### How It Works
1. **Configure Feed Module**\
Set up the Feed module for your CSV or XML file as described in the [Feed Module Guide](/modules/feed-modules).
2. **Check Feed Status**\
Ensure that your feed is synced correctly and shows a **"Ready"** status. All feed products must be loaded into the local database.
3. **Select an Import Preset**\
Choose how each product will be imported and displayed.
4. **Set Publishing Options**\
Decide whether to publish immediately or schedule posts over time.
5. **Start Import**\
Click **Import All** to queue all feed products for import.
{% hint style="success" %}
All tasks will be added to the Import Queue and processed automatically in the background.\
You can monitor progress under the [**Queue tab**](/set-up-products/import-tools/import-queue).
{% endhint %}
# Auto Import
The Auto Import tool allows you to automatically search for products by keyword at scheduled intervals and import any **newly found products** as WordPress posts or WooCommerce products.
**Access:**\
Go to **Content Egg > Import Tools > Auto Import** tab
{% hint style="success" %}
Before starting, ensure your [**Import Presets**](/set-up-products/import-tools/import-presets) are configured correctly and have the **"Avoid Duplicates"** option enabled to prevent re-importing the same products.
{% endhint %}
### How It Works
1. **Click "Add New Rule"**\
Start by creating a new auto-import rule.
2. **Set Rule Details**
* **Rule Name** β Name your rule for easy identification
* **Import Preset** β Select how products will be imported
* **Module** β Choose the product source (e.g., Amazon, Ebay)
3. **Set Run Frequency**\
Choose how often the rule should run: daily, weekly, etc.
4. **Enable "Sort by Newest First" (optional)**\
When enabled, the rule will prioritize newly released products.
> **Note:**
>
> * Not all modules support sorting by newest. If unsupported, the default sort order will be applied.
> * In some cases, enabling this option may lead to less relevant search results.
5. **Add Keywords**\
Enter one keyword per line.
* Each rule run will process one keyword at a time
* Up to 10 products are processed per keyword per run
6. **Avoid Duplicates**\
Ensure your selected import preset has "Avoid Duplicates" enabled to skip already-imported products.
7. **Start Rule**\
Once saved, the rule will run based on your configured schedule.
### Cron and Scheduling
* The plugin uses WordPress's default **WP-Cron** system. **No additional setup is required**.
* If you use real cron, make sure it runs every 5β15 minutes for timely execution.
{% hint style="success" %}
All tasks will be added to the Import Queue first. You can monitor progress under the [**Queue tab**](/set-up-products/import-tools/import-queue).
{% endhint %}
### Smart Rule Controls
Each module has a **limited number of results per keyword**. To avoid running idle jobs or importing outdated results, configure rule limits:
* **Stop after X days** β Auto-pauses the rule after the selected number of days
* **Stop after importing X products** β Stops the rule once the total import count is reached
* **Stop if no new products for X runs** β Pauses the rule after consecutive empty runs
* **Disable keyword after no products for X runs** β Disables a keyword after X runs without results
* Disabled keywords will be marked in square brackets `[like this]` and skipped in future runs
{% hint style="danger" %}
If a module returns an error 5 times in a row, the auto import rule will automatically **pause** to prevent further failures.
{% endhint %}
### Tip for Getting More Products
{% hint style="success" %}
When using "Sort by Newest First" with supported modules, you can automatically capture **newly released products** as they become available on the source site.
In some cases, enabling this option may lead to less relevant search results.
{% endhint %}
#### Modules Supporting "Sort by Newest First"
* Amazon API
* Amazon NoAPI
* Bol.com
* Ebay
* Envato
* Tradedoubler
* Walmart
# Bridge Pages
Bridge Pages let you send visitors to a clean product-focused page on your own site, instead of linking them straight to the merchant.
{% hint style="info" %}
**Recommended Reading.** For step-by-step instructions, best practices, and SEO tips, read the full guide: [How to Build Bridge Pages for Affiliate Marketing](https://www.keywordrush.com/blog/how-to-build-bridge-pages-for-affiliate-marketing/)
{% endhint %}
**Watch Bridge Pages in Action**
{% embed url="" %}
**Bridge funnel:**
Your Resource/landing page (main article) β Bridge Page (dedicated product details) β Merchant website (Amazon)
### Why itβs useful
* **More pageviews & session depth**: clicks first land on your Bridge Page, increasing pageviews and session depth.
* **Reduced βthin affiliateβ signals**: Pages overloaded with outbound affiliate links can sometimes be flagged by Google as low-value. Moving most links into Bridge Pages distributes them more naturally.
* **SEO opportunities**: each Bridge Page can rank for long-tail queries (e.g. specs, reviews, FAQs), not just the parent article.
* **Better monetization**: use Bridge Pages to display multiple merchants, show price history, coupons, or alternatives.
#### Examples of Bridge Pages
* A detailed product entry in your WooCommerce catalog
* A standalone product review
* A price comparison page
### What you can do with Bridge Pages
* Import Bridge Pages for many products in one click from the post editor.
* Choose where links go: merchant (affiliate) or your Bridge Page.
* Make a product canonical so the same item across your site points to one central Bridge Page.
### Creating Bridge Pages (from the Post Editor)
1. Open a post in wp-admin and scroll to the Content Egg metabox.
2. Search/add products as usual (select some, or leave unselected to import all).
3. Click the **Import as Bridge Page** dropdown and choose a preset.
4. Youβll see a small toast message confirming how many items were queued.
{% hint style="warning" %}
Bridge Pages arenβt created immediatelyβtheyβre added to the [import queue](/set-up-products/import-tools/import-queue). To monitor progress, go to Content Egg β Import Tools β Queue.
After importing, refresh the post edit page. Youβll see a small link icon next to products that now have a Bridge Page, along with a quick link to edit that page.
{% endhint %}
### Canonical Bridge Pages (Preset option)
In Content Egg β Import Tools β [Presets](/set-up-products/import-tools/import-presets), each preset can enable:
**Make imported Bridge Pages canonical**
* ON: every product you import with this preset becomes the *site-wide default* destination for that product. Wherever that product appears, links will prefer this Bridge Page (unless you intentionally override it per post).
* OFF: the mapping only applies in the post where you imported it.
### Where should product links send visitors?
{% hint style="info" %}
**Downside of Bridge Pages:** Some visitors just want to buy right away. Forcing them through a Bridge Page can sometimes lower conversions.
Thatβs why itβs often smart to keep your **top product blocks linked directly with affiliate URLs**, while using Bridge Pages for secondary products or deeper comparisons.
{% endhint %}
**You control this in three layers:**
1. Per-block override (Gutenberg)
2. Per-shortcode override (classic editor)
3. Global setting (default)
#### Global default
Settings β Frontend β Link destination preference
* Prefer Merchant (affiliate) β send users to the retailer by default.
* Prefer Bridge Page (on your site) β send users to your Bridge Page when one exists.
#### Block (Gutenberg) override
In the block sidebar (Display Options β Link Destination):
* Auto (follow global setting)
* Prefer Merchant (affiliate)
* Prefer Bridge Page (on your site)
#### Shortcode override
Add `link_target=` to your shortcode:
* `affiliate | bridge | auto`
### Button text (optional)
Content Egg β Settings β Frontend
* Product Button Text (affiliate): customize βBuy nowβ.
* Bridge Button Text: customize βSee detailsβ.
Both support dynamic tags: %MERCHANT%, %DOMAIN%, %PRICE%, %STOCK\_STATUS%.
Suggestions
* Affiliate: *Buy now*, *Buy at %MERCHANT%*, *Check price*
* Bridge: *See details*, *View product page*, *Read review*
### Best practices
* Use canonical for evergreen products youβll reference in many posts (one trusted Bridge Page).
* Use per-post mapping if a product needs a unique context in a specific article.
* Pick one link strategy (merchant vs. bridge) for your site, then override per block only when needed.
* Save the post before importing to ensure it records where the mapping was created.
### FAQ
**Do Bridge Pages work with WooCommerce?**
Yes. You can import as Posts or Woo products; your preset controls the type.
**Can I change where a product points later?**
Yes. Importing a new Bridge Page for the same product will replace the previous mapping.
**What happens if I delete a Bridge Page?**
The plugin automatically cleans up its references, so other posts wonβt link to a deleted page.
# Prefill tool
The Prefill Tool allows you to automatically add Content Egg products to existing posts.
{% embed url="" %}
{% hint style="warning" %}
Prefill will modify your posts, and changes **cannot be undone**. Be sure to **back up your database** before proceeding.
{% endhint %}
### AI Integration
To enable AI-powered features in Prefill, enter your [OpenAI API key](https://ce-docs.keywordrush.com/ai/openai-api) under:\
**Content Egg > Settings > AI > OpenAI API Key**\
Make sure your OpenAI account has sufficient balance.
### How It Works
1. **Navigate to:** Content Egg > Prefill
2. **Select Posts to Prefill:**\
Use filters such as **post type**, **status**, **category**, etc., to narrow down your selection.
3. **Alternatively**, you can run Prefill on a single post directly from the post edit screen. Just click the β**Prefill**β button in the editor.
4. **Choose Modules:**\
Select one or more Content Egg modules to use for product insertion.
* Modules are processed based on priority (set in each moduleβs settings).
* If the first module fails to find relevant products, the next module in the priority list will be used.
5. **Set Prefill Mode & Options:**\
Choose your desired **Prefill Mode** and adjust any additional settings.
6. **Start the Process:**\
Click **Start Prefill** to begin. The process runs in the background using **WP-Cron**, so you can safely leave the page and return later to monitor progress.
### Fully Automatic AI Mode
This mode works with both Gutenberg and Classic Editor posts. It does everything for you:
* Splits the article into clear sections
* Finds keywords based on each sectionβs content
* Filters out products that donβt match
* Writes unique content for each product
* Adds product blocks directly to your post
# Price comparison websites
{% hint style="info" %}
For an in-depth understanding of how price comparison platforms work and some useful tips on creating your own price comparison website using WordPress, take a look at this article: [Can I Create a Price Comparison Website for $50 on WordPress?](https://www.keywordrush.com/blog/create-price-comparison-website-on-wordpress/)
{% endhint %}
{% embed url="" %}
To create a price comparison list, you need to find and add the same product to the different modules.
Add the same product from several modules to compare their prices
Then display them with a price-comparison template. Insert the **CE Products** block and choose a price-comparison template, or use a `[content-egg-block]` shortcode β for example:
```
[content-egg-block template=price_comparison]
[content-egg-block template=price_comparison_card]
[content-egg-block template=buttons_row]
[content-egg-block template=offers_logo]
[content-egg-block template=offers_list]
```
You can use the `title` parameter for shortcodes to set a custom title. For example:
```
[content-egg-block template=price_comparison_card title="Best prices for Xiaomi Mi Electric Shaver S500"]
```
### Merging products
Content Egg usually searches for products by keyword, and the search results depend on the API. When entering a product name, such as a smartphone model, you can find both smartphones and accessories or other semantically relevant products in the search results.
There's no great way to automatically combine products from different sources in one price comparison list. You usually need to search and select products manually. Depending on the module, you can use filters by price, category, or other parameters to increase products' relevance.
### Search by EAN
The only reliable way to combine items into one price comparison list is to search by a product's EAN.
{% hint style="success" %}
**One-click EAN search.** When a product in your search results shows an EAN, click it β Content Egg instantly re-runs the search by that EAN across every module that supports EAN search, gathering the same product from all your stores into one list. It's the fastest way to build a price-comparison list.
{% endhint %}
Click an EAN in the results to search all EAN-capable modules at once
Currently, only the following modules support the ability to search by EAN:
* Amazon
* Amazon No API
* Awin
* Bestbuy
* Bolcom
* Daisycon
* CJ Products
* Ebay
* Impact Radius
* Kelkoo
* Kieskeurignl
* Sovrn (Viglink)
* Tradedoubler
* Tradetracker
* Walmart
* Webgains
* Feed modules
In addition, not all advertisers can fill out the EAN field for their products. If that's the case, EAN search is not available.
### Price comparison and autoblogging
Automatically combining products into one price comparison list can yield distorted results since autoblogging also works with keywords.
That's why we recommend that you start your website with any single module and then add products for price comparison manually. The second option is to use pending posts for autoblogging and moderate the content before posting it.
Manually creating big price comparison websites may take a long time. Usually, about 10% of pages generate up to 90% of your website's traffic. So you can automatically fill your website with products and add price comparison boxes only to the most visited pages for better conversion.
### WooCommerce or Posts
We recommend using WooCommerce for price comparison websites. Please refer to [this guide](/faq/how-to-add-price-comparison-blocks-to-woocommerce) on how to add price comparison blocks to WooCommerce single and archive page templates.
# All Products page
Go to `Content Egg > All Products` to view all products added to your website via the Content Egg plugin. This is a convenient place to track products' availability or the date of the last price update.
{% hint style="info" %}
Please note that this page only displays products that have already been added to your website. It has nothing to do with advertiser databases.
{% endhint %}
# How to add badge icons
To add one of the standard icons before a badge, use the following format by adding an **icon name** followed by a colon (`:`):
**Available Icons:**
* award
* bag-check
* balloon-heart-fill
* bell
* bookmark-heart
* bookmark-star
* box2-heart
* boxes
* chat-heart-fill
* check-all
* check-circle
* check-lg
* check-square-fill
* circle-fill
* coin
* controller
* earbuds
* emoji-frown
* emoji-sunglasses
* fire
* gem
* hand-thumbs-down
* hand-thumbs-up
* headphones
* heart
* house-check
* lightning-charge-fill
* music-note-beamed
* patch-check
* patch-exclamation
* rocket-takeoff
* star-fill
* stars
* trophy
#### **Example:**
To add the "award" icon with a badge "Editor's choice", use:
```
award:Editor's choice
```
### Custom SVG Icons
To add custom SVG icons for badges, use the `cegg_svg_icon_list` filter. This filter allows you to easily extend the list of available icons by adding new ones. Below is an example of how to add custom icons:
```php
function add_custom_icons($icons) {
// Check-square icon
$icons['check-square'] = '';
// Star-fill icon
$icons['star-fill'] = '';
return $icons;
}
add_filter('cegg_svg_icon_list', 'add_custom_icons');
```
{% hint style="info" %}
For more SVG icons, you can explore a large collection from the [Bootstrap Icons Library](https://icons.getbootstrap.com/).
{% endhint %}
# Autoblogging
{% hint style="warning" %}
While the Autoblogging feature is now deprecated, it will remain available in the plugin for as long as needed. We recommend using the new [Auto Import tools](/set-up-products/import-tools/auto-import).
{% endhint %}
The autoblogging feature allows you to automatically create posts or WooCommerce products. Go to `Content Egg > Add autoblogging` to create an autoblogging task. You can set a keyword list, post title, and body template, as well as select modules and other settings.
{% hint style="info" %}
Autoblogging's primary principle is **1 keyword = 1 post**.
{% endhint %}
For example, if you set 10 keywords, up to 10 posts will be created.
You can also set the frequency of the autoblogging task launch and the number of keywords to be processed in one run.
All processed keywords are marked with `[`square brackets`]`.
When all the keywords are processed, the task switches to inactive status. You'll need to add new keywords to resume autoblogging.
### How to import products in bulk
The Content Egg plugin isn't designed to bulk import all products to your website when a separate page is created for each product. We recommend using our [External Importer plugin](https://www.keywordrush.com/externalimporter) for this task. It imports entire website sections to your WooCommerce directory in just a few clicks.
You can set a list of product names as keywords for autoblogging and enable the `Results for updates and autoblogging = 1` option in module settings if you want to import only one product to each separate page.
This will allow you to create a regular catalog with products in automatic mode.
### Working with keywords
When we were developing the autoblogging feature, we had a few unique ideas in mind that make the Content Egg plugin different from other product import plugins.
One of these ideas is that you can **work with keywords** instead of products. In other words, instead of mindlessly importing all products from affiliate websites, you can focus exclusively on selecting keywords.
Your primary job will be to find low-competition keywords that can generate search traffic. These can be trending keywords, long-tail keywords, answers to questions, and so on. We think you get the idea. You can do a simple Google search to find some great guides on the following topics:
* How to find the right niche
* Finding keyword ideas
* How to analyze keywords
* Keyword research tools
Try to choose commercial keywords for which the product modules can make relevant product selections. Please note that it will be difficult for the modules to select products based on informational keywords. In this case, you can set a separate keyword for product modules using a special syntax:
```
Main Keyword;Amazon:Keyword 1;ModuleId2:Keyword 2;β¦
```
For example:
```
How to Use a French Press for Loose Tea;Amazon:French press;CjProducts:Loose tea
```
In this example:
* `How to Use a French Press for Loose Tea` is the main keyword. You can use it for media modules like YouTube or Google Images.
* `French press` is a special keyword for the Amazon module.
* `Loose tea` is a special keyword for the CJ Products module.
### Content mashup
The second important idea behind Content Egg autoblogging is the ability to use a [content mashup](https://en.wikipedia.org/wiki/Mashup_\(web_application_hybrid\)), where different types of content from many sources are combined to be presented on one page. As a result, we turn non-unique content into a **unique page** and a useful service for website visitors.
As such, for automatically generated websites, we recommend using a mix of modules, such as products, images, videos, news, and coupons.
Coupons may provide good conversions, but coupon modules don't have a large content base for long keyword searches. Typically, you will need to use single words to find relevant coupons.
### Tags and formulas
Tags are special placeholders that will be replaced with the current keyword or product data. You can use tags in your post title or body template.
For SEO, 'additional' keywords in titles usually work well. These can be, for example, the current year; words like "sale", "cheap", and "discount"; answers to questions like "where to buy", "what is the best", "how to use", etc. For example:
`What is the best %KEYWORD% in 2021?`
To generate more unique content, you can use 'formulas' in which one random phrase or word is selected from a list. For example:
`{Where to buy|What is the best} %KEYWORD%?`
`{Discount for|Sale|Cheap|Hot deals:} %PRODUCT.title%`
### Why autoblogging doesn't create posts
General recommendation: Before you start setting up autoblogging, make sure that all modules on the manual post edit page are working well and returning data for your keywords.
The most common reasons why autoblogging doesn't create new posts are:
1. There are no active keywords, and the task has become inactive. Add more keywords.
2\. Data is missing for a required module. Go to the post edit page and test the module with your keywords.
### Affiliate Egg and autoblogging
If you're using [Content Egg + Affiliate Egg integration](/modules/affiliate-egg-integration), the most convenient way to bulk import products for Affiliate Egg modules is to use a **list of product URLs instead of keywords**. Doing this creates a separate post/product for each URL on your website.
You can collect the list of URLs from the sitemap or using another convenient way.
### Searching by URL and autoblogging
Some Content Egg modules also search for products by URL:
* Aliexpress
* Amazon
* Awin
* Daisycon
* Flipkart
* Viglink
* Walmart
* Webgains
You can use a list of direct URLs instead of bulk import keywords for these modules, too. For example, you can copy a list of product URLs directly from the AWIN data feed.
### WooCommerce and autoblogging
{% content-ref url="/pages/-MTVSGB-pZXH7jj0EwdT" %}
[WooCommerce and autoblogging](/woocommerce/woocommerce-and-autoblogging)
{% endcontent-ref %}
### Price comparison and autoblogging
{% content-ref url="/pages/-MTUfLmEwJqH6Y9kk7\_c" %}
[Price comparison websites](/set-up-products/price-comparison-websites)
{% endcontent-ref %}
### How to create a top products affiliate website
{% embed url="" %}
# How content is displayed
The ways to show your Content Egg products on the page β blocks, shortcodes, and automatic embedding.
Once you've [added products](/set-up-products/how-to-add-products) to a post, there are three ways to show them on the page. In the block editor, use **blocks**; in the classic editor or when you need extra options, use **shortcodes**; or let a module **embed automatically**.
## Blocks (recommended)
In the block editor, Content Egg adds its own **Content Egg** section to the block inserter, with four blocks:
* **CE Products** β product cards, lists, grids, comparison tables, and more. See [Gutenberg product blocks](/frontend/gutenberg-blocks).
* **CE Coupons** β coupon output.
* **CE Images** β image output.
* **CE Videos** β video output.
The Content Egg section in the block inserter
These blocks are the recommended way to display products, coupons, images, and videos.
Separately, **Egg Blocks** are a collection of editorial blocks (intros, pros & cons, verdicts, FAQs) that can also display product data. See [Egg Blocks](/egg-blocks/introduction).
## Shortcodes
Shortcodes give you the same output outside the block editor β and a few options blocks don't expose.
* **`[content-egg-block]`** β the product display shortcode. Same output as the CE Products block, but with **more parameters** and support for **custom templates**. Build one on the **Shortcode** tab of the product manager (or write it by hand), then paste it wherever you want the products. Best for the **classic editor**, page builders, or advanced options. See [Shortcode parameters](/frontend/shortcode-parameters).
Build a [content-egg-block] shortcode on the Shortcode tab
* **`[content-egg]`** β the older module shortcode. **Deprecated** and superseded by the blocks and `[content-egg-block]`. It still works on existing sites, but isn't recommended for new content.
{% hint style="info" %}
In a visual editor, insert shortcodes with a **Shortcode block** β not as plain text β so they render correctly once saved.
{% endhint %}
## Automatic embedding (deprecated)
A module can also embed its products automatically at the beginning or end of every post, set per module in its settings. This older method is **deprecated** β prefer blocks or the `[content-egg-block]` shortcode for new content β but it still works on existing sites.
## Page builders
Content Egg works with most WordPress page builders, including Gutenberg and Elementor. In any builder, add shortcodes with a dedicated **shortcode block/widget** rather than as plain text.
# Gutenberg product blocks
Display your Content Egg products anywhere in a post with the CE Products block β templates, product binding, and display options, edited live in Gutenberg.
The **CE Products** block displays your Content Egg products anywhere in a post β product cards, lists, grids, comparison tables, bestseller sections, and more. It produces the same output as the `[content-egg-block]` shortcode, but you edit it visually with a live preview.
{% hint style="info" %}
**Do not confuse it with Egg Blocks.**\
**Egg Blocks** are a separate collection focused on **structured editorial content** β intros, FAQs, key takeaways, pros and cons, verdicts, and similar article sections. Some Egg Blocks can also show product data, but they are a separate concept, documented separately.
[Egg Blocks β Introduction](/egg-blocks/introduction)
{% endhint %}
## Add the block
1. Add your products first β see [Add & manage products](/set-up-products/how-to-add-products).
2. Insert the **CE Products** block from the block inserter (under the **Content Egg** category).
3. Pick a **template** from the gallery that appears (sorted by most recently used).
Choose a template when you insert the block
From the block **toolbar** you can switch the template (**Select Template**), toggle **Dark mode**, or refresh the preview.
## Choose which products show β Product Binding
In the sidebar's **Data Filtering** panel, the **Product Binding** control decides which products the block renders:
* **Filter** *(default)* β show products by module, group, or all:
* **Include modules** / **Exclude modules**
* **Product Groups**
* **Products** β specific product IDs, comma-separated
* **Limit** and **Offset**
* **Choose products** β search and pick **specific products**, shown in exactly the order you set.
Filter by module/group/all, or choose specific products
There's also a **Source Post ID** field β leave it empty to use the current post, or enter another post's ID to display products attached there.
## Display options
The **Display Options** panel controls presentation, independent of the data:
* **Visible / Hidden Elements** β show or hide individual fields (price, image, rating, button, badge, shipping, stock status, subtitle, and more).
* **Link Destination** β **Auto** (follow the global setting), **Prefer Merchant** (affiliate), **Prefer Bridge Page** (on your site), or **Both**.
* **Render via AJAX (async)** and **Lazy load** β load the block asynchronously, or only when it scrolls into view (lazy load requires async).
Show/hide fields, choose the link destination, and control loading
## Output customization
The **Output Customization** panel adjusts styling. Which controls appear depends on the template:
* **Columns** / **Columns (Small)** β for grid templates
* **Tabs Type** β tabs, pills, or underline, for grouped templates
* **Button Variant** and **Button Text**
* **Border** and **Border Color**
* **Title Tag** β `div` or `h1`β`h5`
* **Image Ratio** β 1x1, 4x3, 16x9, or 21x9
* **Columns Order** and **Start Number**
Columns, buttons, borders, title tag, and image ratio
## Data changing
The **Data Changing** panel adjusts the data itself:
* **Currency** β convert displayed prices to another currency.
* **Add Query Argument** β append a parameter to affiliate links (for example `tag=CUSTOM_TAG`) for your own tracking.
## Custom templates
Custom (theme) templates aren't available in the block's template gallery β apply them with a **shortcode** instead. Custom templates don't implement the block's sidebar controls, so they're used via `[content-egg-block]`: build one on the **Shortcode** tab of the product manager (or write it by hand) and set its `template` to your custom template.
See [How to create a custom template](/custom-templates/how-to-create-a-custom-template) and [Shortcode parameters](/frontend/shortcode-parameters).
## Full parameter reference
Every block setting maps to a `[content-egg-block]` shortcode parameter. For the complete list β including a few parameters not exposed in the block UI, such as `next` β see the [**Shortcode Parameters Guide**](/frontend/shortcode-parameters).
{% hint style="info" %}
**Not using Gutenberg?** [Content Egg shortcodes](/frontend/how-content-is-displayed) give the same product output on any post type, and work with most page builders including Elementor.
{% endhint %}
# Shortcode parameters
Shortcode parameters allow you to control both the product data output and the layout design in Content Egg. These parameters can be applied similarly for both module-specific and global shortcodes.
### 1. Data Filtering and Selection
#### limit
The `limit` parameter controls how many items are displayed in the output. It restricts the product count to a specified number.
**Display the first 5 products only:**
```
[content-egg-block template=offers_logo limit=5]
```
#### offset
The `offset` parameter skips a specified number of items before starting the output, allowing you to control where the product listing begins.
**Combining limit with offset**: If you want to show a specific subset of products (e.g., products 6 to 10), you can combine `limit` with `offset`:
```
[content-egg-block template=offers_logo limit=5 offset=5]
```
#### next
The `next` parameter is used to divide a product list into separate blocks, allowing you to display items in sequential batches. Each time you use the shortcode with the next parameter, it shows the next set of products.
**Display the first two products:**
```
[content-egg-block next=2]
```
**Display the next four products after the first two:**
```
[content-egg-block next=4]
```
Each time you increase the `next` value or repeat the shortcode, the next set of items will be shown.
#### post\_id
The `post_id` parameter lets you display Content Egg data from one post in any other post, page, or widget. This is useful for reusing product data across your site without duplication.
```
[content-egg-block template=offers_logo post_id=123]
```
#### sources
The `sources` parameter aggregates curated picks from **multiple posts** into one block β e.g. a comparison page pulling a "best budget" pick and a "best premium" pick from other posts. Works only with block shortcodes.
**Format:** a `;`-separated list of source definitions. Each definition starts with a `post_id`, followed by optional `|key:value` options:
* `group` β only include products from this group
* `limit` (default `1`) β max number of products to take from this source
* `badge` β forces this badge onto the cheapest surviving product from this source
Only in-stock products are considered, sorted by price ascending before `limit` is applied.
**Example:** Pull the cheapest "budget" and "premium" picks from post 28649, plus one pick from post 1305748:
```
[content-egg-block template=top_listing sources="28649|group:budget|limit:2|badge:Best Budget; 28649|group:premium|badge:Best Premium; 1305748|badge:Best 230V"]
```
By default, results display in the order the sources are listed. Add an explicit `sort` parameter (e.g. `sort=price`) to override this with normal price-based sorting instead.
#### modules
The `modules` parameter allows you to specify which modules to pull data from by using **module IDs**, not the module names. You can find the correct module IDs in the Content Egg settings pages under the specific module configurations.
You can add as many module IDs as needed, separated by commas.
```
[content-egg-block template=offers_logo modules="Amazon,Ebay2"]
```
#### exclude\_modules
Excludes certain modules from the output.
**Example:** To exclude Amazon from a price history graph, you can use the following shortcode:
```
[content-egg-block template=price_history exclude_modules=Amazon]
```
#### **sort**
The `sort` parameter sets the sorting criteria for products, with options: `price`, `discount`, `reverse`, and `total_price`.
**Example:**
```
[content-egg-block template=list sort=discount]
```
This sorts products by the highest discount first.
For more detailed information on product sorting options, [click here](/frontend/product-sorting).
#### **order**
The `order` parameter controls the sorting direction in sortable shortcodes, such as product lists. You can set it to either `asc` (ascending) or `desc` (descending).
**Example:**
```
[content-egg-block template=list sort=price order=desc]
```
By default, the sorting order is `asc` (ascending).
#### products
Filter products output by product ID. Click on the "`id`" button to add the product ID filter to the output shortcode. You can also set multiple IDs separated by commas.
#### groups
The `groups` parameter filters data based on predefined product groups. This allows you to display only products that belong to specific groups, providing a way to categorize and organize product outputs.
**Example:** To display products from a specific group, use:
```
[content-egg-block template=offers_logo groups="group_name"]
```
You can also display products from multiple groups by separating group names with commas.
For more details on how to set up and use groups, check the instructions [here](/frontend/groups).
#### group\_pick
The `group_pick` parameter selects one product per group.\
Allowed values:
* `cheapest` β selects the lowest-priced product
* `priciest` β selects the highest-priced product
* `random` β selects a random product
Note: This parameter works only with block shortcodes, not with module shortcodes.
**Example:**
To display only the cheapest product for each group:
```
[content-egg-block template=offers_logo_groups group_pick="cheapest"]
```
#### locale
The `locale` parameter can be used only with the **Amazon**, **eBay**, and **Shopee** modules to filter products based on the selected country.
**Example:** To display US-based products from Amazon, use:
```
[content-egg-block modules=Amazon locale=US]
```
For details on integrating this with visitor geolocation plugins, please refer to the [relevant documentation](https://ce-docs.keywordrush.com/modules/affiliate/amazon#id-2.-geolocation-ip-detection).
#### ean
The `ean` parameter filters products by one or more EAN codes. It allows you to narrow down the output based on specific product EANs.
**Example:** To display products with specific EAN codes, use:
```
[content-egg-block template=list ean=0711719765790,5016488137300]
```
Please note, this parameter does not add new products; it only filters the existing products in the output.
#### remove\_duplicates\_by
The `remove_duplicates_by` parameter removes duplicate products from the output by checking one of the specified product fields: `orig_url`, `url`, `title`, `ean`, or `domain`. The module priority will determine which duplicate product to keep. This parameter can only be used with block shortcodes.
**Example:**
```
[content-egg-block template=offers_list remove_duplicates_by=orig_url]
```
### **2. Data Changing:**
#### currency
The `currency` parameter allows you to convert all offers in your product list to a single currency, ensuring consistency when products come from different regions with varying currencies.
**Example:** To convert all offers to EUR:
```
[content-egg-block template=offers_grid currency=EUR]
```
If the desired currency is [not listed](http://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html#dev), you can manually add an exchange rate by modifying the `functions.php` file of your theme (or child theme) using a custom function like this:
**Example (Adding a Custom Exchange Rate):**
```php
function my_content_egg_currency_rate ($rate, $from, $to)
{
if ($from == 'USD' && $to == 'KES')
return 100.15; // <--- exchange rate from USD to KES
if ($from == 'KES' && $to == 'USD')
return 0.01; // <--- exchange rate from KES to USD
}
add_filter( 'content_egg_currency_rate', 'my_content_egg_currency_rate', 0, 3 );
```
This allows you to manually set the conversion rate for any currency not natively supported by the plugin.
#### add\_query\_arg
The `add_query_arg` parameter allows you to modify affiliate URLs by appending custom query variables to the URL. This can be useful for adding tracking parameters or custom tags to the affiliate links.
**Example:** To add a custom tag to Amazon affiliate URLs, use:
```
[content-egg-block modules=Amazon add_query_arg="tag=CUSTOM_TAG"]
```
This appends the `tag=CUSTOM_TAG` query variable to all Amazon product URLs, making it easy to customize the URL for tracking or other purposes.
#### keyword
The `keyword` parameter allows you to create an auto-updated list of products by specifying a keyword. It works only with [module shortcodes](/frontend/how-content-is-displayed#shortcodes) and automatically filters products based on the provided keyword.
**Example:** To display a list of Amazon products related to "Echo Dot":
```
[content-egg module=Amazon template=list keyword="echo dot"]
```
You can also assign a custom group name by encoding the group separator `->`:
```
[content-egg module=Amazon template=list keyword="echo dot->Smart speakers"]
```
Additionally, you can control the maximum number of results using the `limit` parameter:
```
[content-egg module=Amazon keyword="echo dot" limit=3]
```
The auto-update schedule and the maximum number of search results can be configured in each module's settings.
### 3. Template Output Customization
#### template
Defines the layout template used for displaying product data. Typically, you will set this parameter through the [shortcode builder](/frontend/how-content-is-displayed).
#### hide/visible
The `hide` and `visible` parameters allow you to control the display of specific elements in your product templates. Each template has default settings for what data is shown or hidden, but these parameters give you the flexibility to hide or force display certain fields.
`hide`: Hides specified fields that would otherwise be shown.
`visible`: Forces the display of fields that might be hidden by default.
**Available Fields to Hide or Display:**
`badge`, `button`, `code`, `coupons`,`coupon_revival`, `delivery_at_checkout`, `description`, `disclaimer`, `domain`, `endDate`, `img`, `logo`, `merchant`, `new_used_price`, `number`, `percentageSaved`, `price`, `priceOld`, `price_update`, `prime`, `promo`, `rating`, `shipping_cost`, `shop_info`, `startDate`, `stock_status`, `subtitle`, `title`
**Example to Hide Multiple Fields:**
```
[content-egg-block template=offers_list hide=price,shop_info]
```
**Example to Display Hidden Fields:**
```
[content-egg-block template=offers_list visible=description,badge]
```
These parameters give you control over which product data elements are shown or hidden, allowing you to customize the look and feel of your product display.
#### **async**
Enables asynchronous (AJAX) rendering on the frontend.
* `async=1` β enable async rendering
* `async=0` (default) β normal server-side rendering
Example:
```
[content-egg-block template=item_simple async=1]
```
#### **lazy**
Delays async rendering until the block is close to (or inside) the userβs viewport. Works only with `async=1`.
* `lazy=1` β load when visible (lazy load)
* `lazy=0` (default) β load immediately (still async)
Examples:
```
[content-egg-block template=item_simple async=1 lazy=1]
[content-egg-block template=list async=1 lazy=1]
```
#### **link\_target**
The `link_target` parameter controls whether product links in your block point directly to the merchant (affiliate link) or to a [Bridge Page](/set-up-products/import-tools/bridge-pages) (if one exists).
Usage example:
```
[content-egg-block template="item_simple" link_target="bridge"]
```
Available options:
* `affiliate` β Always prefer the merchantβs affiliate link, even if a Bridge Page exists.
* `bridge` β Always prefer a Bridge Page (on your site) when available. If no Bridge Page exists, the link falls back to the affiliate link.
* `both` β Enables dual destinations (typically two action buttons: one for Bridge Page + one for affiliate). Not all templates support this. Supported templates: *Product card*, *Grid*, *List*.
* `auto` *(default)* β Follow the global setting you chose in *Content Egg β Settings β Frontend β Link Destination Preference*.
#### **btn\_variant**
Changes the button style, allowing you to choose from a variety of predefined styles such as solid or outlined versions of different color schemes. The available options are:
`primary`, `secondary`, `success`, `danger`, `warning`, `info`, `light`, `dark`, `link`, `outline-primary`, `outline-secondary`, `outline-success`, `outline-danger`, `outline-warning`, `outline-info`, `outline-light`, `outline-dark`.
**Note:** `btn_color` is an alias for `btn_variant`.
You can also customize all the color themes for these styles (`primary`, `secondary`, etc.) in the `Frontend settings` of Content Egg.
**Example:** To set a button with the `outline-primary` style, use:
```
[content-egg-block template=offers_list btn_variant=outline-primary]
```
#### **btn\_text**
Customizes the text displayed on buttons.
**Example:** To change the button text to "Check Price", use:
```
[content-egg-block template=offers_list btn_text="Check Price"]
```
This will override the default button text and display "Check Price" on all buttons.
#### color\_mode
Changes the color theme for the current block. The only available option is `color_mode=dark`, which applies a dark theme to the block.
You can also set the Dark theme globally by going to **Content Egg settings > Frontend > Color Mode**.
**Example:**
```
[content-egg-block template=offers_list color_mode=dark]
```
#### cols
Controls the number of columns in `grid` templates. You can also adjust the number of columns across different screen sizes using the parameters `cols_xs`, `cols_sm`, `cols_md`, `cols_lg`, `cols_xl`, and `cols_xxl`.
`cols` is equivalent to `cols_md` (medium screens).
**Example:**
To set a grid with 4 columns for medium screens and 2 columns for small screens:
```
[content-egg-block template=offers_grid cols_md=4 cols_sm=2]
```
This will display 4 columns on medium screens and 2 columns on smaller screens, allowing for a responsive layout.
#### img\_ratio
Specifies the aspect ratio of the product images in the display. Allowed values are `1x1`, `4x3`, `16x9`, and `21x9`.
**Example:** To set the image aspect ratio to `16x9`, use:
```
[content-egg-block template=offers_grid img_ratio=16x9]
```
#### **title\_tag**
Sets the HTML tag for the product title. Allowed values are `div`, `h1`, `h2`, `h3`, `h4`, `h5`, and `h6`.
**Example:** To set the product title as an `h3` tag, use:
```
[content-egg-block template=offers_list title_tag=h3]
```
#### **border**
Adds a border to the product display. You can set the border width from 0 (no border) to 5 (thickest border) using this parameter.
**Example:** To add a border with a width of 3, use:
```
[content-egg-block template=offers_list border=3]
```
#### **border\_color**
Specifies the color of the border. The allowed values are `primary`, `secondary`, `success`, `danger`, `warning`, `info`, `light`, and `dark`.
**Example:** To add a border with the `danger` color, use:
```
[content-egg-block template=offers_list border=2 border_color=danger]
```
#### **tabs\_type**
Customizes the style of tabs for displaying products in templates that support tabs. The available options are:
* `tabs`: Standard tab style.
* `pills`: Rounded "pill" style tabs.
* `underline`: Tabs with an underline for the active tab.
**Example:** To display tabs in "pills" style, use:
```
[content-egg-block template=offers_list_groups tabs_type=pills]
```
#### **cols\_order**
Changes the display order of columns in templates with multiple columns. You can specify the order of columns by listing their numbers in the desired sequence.
**Example:** To rearrange the columns in the order `3, 2, 1, 5, 4`, use:
```
[content-egg-block template=offers_logo cols_order=3,2,1,5,4]
```
This will display the third column first, followed by the second, and so on.
#### **start\_number**
Specifies the starting number for product number badges. This is useful for listings where you want to start numbering from a specific value rather than 1.
**Example:** To start numbering products from 3, use:
```
[content-egg-block template=top_listing visible=number start_number=3]
```
This will make the list begin with number 3 for the first product.
#### **title**
Customizes or overrides the main title used in some templates.
**Example:**
```
[content-egg-block template=price_comparison_card title="Sony Playstation 5 Slim"]
```
#### **show**
The `show` parameter is used only with "`customizable`" block templates. It allows you to display specific information about a product, such as the price, title, button, etc. It's recommended to use this parameter in combination with the [`products`](#products) parameter to target specific product information.
**Available Fields for `show`:**
`button`, `currencyCode`, `img`, `img+url`, `last_update`, `price`, `priceOld`, `stock_status`, `title`, `url`
**Example:**
To display only the price of a specific product (ID: 808726894), use:
```
[content-egg-block template=customizable product="808726894" show=price]
```
**Low Price**: Display the lowest price product:
```
[content-egg-block template=customizable show=price limit=1 sort=price order=asc]
```
**High Price**: Display the highest price product:
```
[content-egg-block template=customizable show=price limit=1 sort=price order=desc]
```
### Customizing Templates with CSS:
{% content-ref url="/pages/t2QCqrN8xmH5EwZHvxzl" %}
[Customizing templates with CSS](/custom-templates/customizing-templates-with-css)
{% endcontent-ref %}
# Product groups/variations
Split product output into separate blocks with product groups β assign, display, and show them as tabs.
Groups are the simplest way to split product output into separate blocks β for example, a phone in one group and its accessories in another, or different colors and variations of the same product. (The other way to control exactly what a block shows is to bind specific products to it β see [Choose products](/frontend/gutenberg-blocks).)
{% hint style="info" %}
Check the [Smart Groups](/ai/smart-groups) feature to create and assign product groups using AI.
{% endhint %}
## Assign products to a group
On the **Added** tab of the product manager:
* **In bulk** β select products, then pick a group from the dropdown, or choose **+ New groupβ¦** to create one.
* **Per product** β assign a group (or a new group) on a product's row, or in its **edit drawer**.
Assign a group in bulk or per product on the Added tab
You can also assign a group **while searching**, using the syntax `keyword -> group name`. After the product is added, it's placed in that group automatically. This syntax also works for [auto-update keywords](/updating-products/updating-the-product-list).
## Display one or more groups
To show only certain groups:
* In the **CE Products** block, set the **Product Groups** filter in the block's Data Filtering panel β pick one or more groups. See [The Products block](/frontend/gutenberg-blocks).
* Or use the `groups` shortcode parameter, with several groups separated by commas:
```
[content-egg-block template=offers_logo groups="PlayStation 5 Digital,PlayStation 5 Disc Edition"]
```
See [Shortcode parameters](/frontend/shortcode-parameters#groups).
## Show groups as tabs
Special group templates render each group as its own tab automatically. Set the tab order with the `groups` parameter, and the tab style with `tabs_type` (`tabs`, `pills`, or `underline`).
```
[content-egg-block template=offers_logo_groups]
[content-egg-block template=offers_list_groups groups="PlayStation 5 Digital,PlayStation 5 Disc Edition"]
```
Group templates turn each group into a tab
## Removing a group
To remove a group, simply unassign it from all products β once no product uses it, the group is deleted automatically.
## Static groups
If you want certain groups to be available for **all posts by default**, use the `cegg_static_product_groups` filter.
Add the following to your theme's `functions.php` (preferably in a **child theme**):
```php
add_filter('cegg_static_product_groups', function ($groups, $post_id) {
$groups[] = 'Top Picks';
$groups[] = 'Editor\'s Choice';
$groups[] = 'Limited-Time Deals';
return $groups;
}, 10, 2);
```
# Product sorting
How the display order of products is decided in Content Egg blocks and shortcodes β drag-and-drop, chosen order, price templates, and sort options.
The order products appear in is set mainly by **drag-and-drop**, with a few rules that can take over (a price-sorting template, or an explicit sort).
## Arrange products by hand
In the product manager, **drag** attached products into the order you want. This sets a position that's saved with the post and used across all your product blocks.
Drag attached products to set their order
You can also set an exact position with the numeric **Order** field in a product's edit drawer, under **More fields** β handy for precise tweaks. Drag-and-drop is the usual way.
## What decides the final order
For the **CE Products** block and `[content-egg-block]` shortcodes, the display order is decided in this priority:
1. **A `sort` parameter**, if set β sorts by `price`, `discount`, `reverse`, or `total_price` (with `order` set to `asc` or `desc`). This overrides everything else. See [Shortcode parameters](/frontend/shortcode-parameters#sort).
2. **Price-focused templates** β some templates always sort by price (ascending), even with no sort set: **Price Comparison**, **Price Comparison Card**, **Offers Logo**/**Offers List** variants, **Price Alert**, **Price Statistics**, **Review Box**, and similar. Other templates (Grid, List, Top Listing, Buttons Row, and custom templates) keep your chosen order.
3. **A specific list of products** β when you use **Choose products** binding, or a manual `products="β¦"` filter, the block renders the products in the exact order you picked or listed them.
4. **Your manual order** β otherwise (Filter mode by module, group, or all), products follow your drag-and-drop order. Products you haven't arranged yet fall back to badge-first, then each module's priority.
{% hint style="info" %}
To force a strict price sort, either choose one of the price-focused templates above, or add `sort` / `order` to a `[content-egg-block]` shortcode.
{% endhint %}
## Egg Blocks
Egg Blocks that show products β **Product Card**, **Quick Picks**, **Comparison Table** β render products in the **exact order you add them** in the block. There's no drag-to-reorder and no automatic price sorting inside these blocks. To change the order, remove and re-add the products in the order you want.
# Featured images
Each Content Egg module includes an option to automatically set featured images for posts.
You can activate external featured images in Content Egg by going to `General settings > External featured images`. This works for both WordPress posts and WooCommerce products.
### Additional Gallery Images
Additional gallery images are available for **WooCommerce products only**.
To activate this feature, go to\
**Content Egg > Settings > WooCommerce** and enable **"Gallery Images"**.
You can choose between two options:
* **Use external URLs** β images will be loaded directly from the source.
* **Download images into media library** β images will be saved locally.
**Note:**\
If you choose to save images locally, the download does not happen immediately.\
Images are processed in the background, and you'll see a notice about the scheduled gallery image download (as shown in the screenshot).
#### Gallery Image Support
Most product APIs provide only the main product image.\
Gallery images are supported **only** by the following modules:
* Aliexpress
* Amazon API
* Amazon NoAPI
* Bol.com *(must be enabled in the module settings β disabled by default)*
* eBay
* Tradedoubler
* Walmart
# Frontend Search
With Content Egg, you can add each deal as a separate post. WordPress searches by post titles, but if you want a search form that shows results from affiliate networks directly (without creating posts for each deal), you can use Content Egg's Frontend Search function.
You need to create two things: a page with the search form (or widget) and a page for displaying the results.
### Creating a Search Form
There are several ways to show the affiliate search form with Content Egg:
1. **Using a Widget**:
* Find the widget **CE: Product Search** in **Appearance β Widgets**.
* Place the widget in a sidebar. It will have the same styling as a standard WordPress widget.
2. **Using a Shortcode**:
* Use the shortcode `[content-egg-search-form]`.
* This shortcode will generate a standard WordPress search form and direct users to a special page with results from affiliate modules instead of the default WordPress search page.
* The shortcode design matches the standard WordPress search form.
Please note, some themes can extend the Content Egg search form. For example, Rehub offers additional shortcodes.
#### Search Settings
The next step is to set up the page for output results. To do this:
1. Go to **Content Egg β Settings β General**.
2. Add the output shortcode to the text area labeled **Search page template**.
We recommend using common Content Egg shortcodes. For example:
```
[content-egg-block template=offers_list]
```
### Customization
To configure the search form, create a `ce-product-searchform.php` file in the root directory of your theme (or child theme). Add and customize the form code:
```php
```
To configure the global page template with a search result, create a `ce-product-search.php` file in the root directory of your theme (or child theme). Use code similar to the code in your `page.php` template.
To configure `product-search` in the URL search form, use a filter that returns a new slug:
```php
add_filter('cegg_product_search_slug', 'example_callback');
```
# Translation
Translation Guide
The frontend language of Content Egg can be different from your main WordPress language and admin dashboard language. Content Egg has its own setting for this:
* Go to **Content Egg > Settings > Frontend**.
* Set the **"Website Language"** option to choose the language used for the frontend display.
{% hint style="info" %}
If you only want to change a button label, go to **Content Egg β Settings β Frontend**, and update the **"Product Button Text"** or **"Coupon button text"** fields.
{% endhint %}
### **1. Quick Translation via Plugin Settings**
For most use cases, you can translate frontend strings directly in the WordPress dashboard:
* Go to **Content Egg > Frontend > Frontend Texts**.
* Modify the available strings to your desired language.
{% hint style="warning" %}
**Note:**\
If a string includes placeholders such as `%s` or `%d`, make sure your translated version includes **the exact same placeholders** in the correct position. These are dynamically replaced with actual values and are essential for proper functionality.
{% endhint %}
### **2. Advanced Translation with POT Files**
For more comprehensive setups, you can use a traditional translation method with `.POT` files.
* This allows you to translate all plugin strings using tools like **Poedit** or **Loco Translate**.
* Detailed steps are provided in this guide: [Localization with POT files](/customization/localization).
# Greenshift templates
Greenshift is a Gutenberg block builder plugin available for installation from the [WordPress repository](https://wordpress.org/plugins/greenshift-animation-and-page-builder-blocks/). With this plugin, you can create your own templates for displaying Content Egg products, as well as use prebuilt patterns and customize them.
{% hint style="warning" %}
**Note**: Greenshift is a free plugin, but to integrate with dynamic data from Content Egg, you will need a paid [Query Addon](https://www.keywordrush.com/go/greenshift-query-addon).
{% endhint %}
Before you start, make sure that Greenshift and the Query Addon are installed on your site.
### Using Prebuilt Patterns
1. Add Content Egg products [as usual](/set-up-products/how-to-add-products) and save the post.
2. Toggle the block inserter:
3. Go to the `Patterns > Content Egg` tab and select one of the prebuilt templates:
4. In the `Repeater Builder` settings, you can apply various filters, similar to how you do with the [shortcode parameters](/frontend/shortcode-parameters), to filter out the products to output in that block:
5. You can also customize and adjust any block parameters (e.g., button color, font size, number of columns, padding, and much more):
### Reusable Templates
Once the template's appearance is customized according to your requirements, you can save it as a custom pattern.
1. From the `Repeater Builder` menu, select "`Create pattern`":
2. Add a name for the template and select the "`Synced`" checkbox.
3. Your pattern is now available in the `My Patterns` section. Use it in any posts you want.
4. Go to `Appearance > Patterns` if you want to edit the pattern. Select "`Select Post type for preview`" to get Content Egg data for preview from the last created post.
5. Because you selected the synchronization option in step 2, any changes made to this pattern will be applied to all pages where you use this pattern to display products.
# Egg Blocks β Introduction
Review, roundup, and buying-guide articles assembled from 25 semantic blocks β designed around Google's E-E-A-T framework and optimized for the signals AI search engines actually cite.
Egg Blocks are a set of 25 purpose-built Gutenberg blocks included with Content Egg. They let you assemble a full product review, roundup, or buying guide from semantic, styled, structured blocks instead of raw paragraphs, headings, and tables.
Each block is server-side rendered: what you see in the Gutenberg editor is the structure your visitors see on the frontend. Blocks come with multiple visual variants, a shared design system, and direct integration with Content Egg products.
### Contents
1. [Why Egg Blocks](#why-egg-blocks)
2. [Getting started](#getting-started)
3. [Core concepts](#core-concepts)
4. [Recipes](#recipes)
***
### Why Egg Blocks
Writing product content in a generic editor usually means stitching together paragraphs, bullet lists, and shortcodes. Egg Blocks replace that ad-hoc approach with a library of editorial primitives organized into five groups:
* **Article structure** β `intro`, `conclusion`, `section-header`, `toc`, `faq`, `callout`, `step-list`
* **Editorial insights** β `key-takeaways`, `criteria`, `methodology`, `definitions`, `myth-fact`, `pros-cons`
* **Product commerce** β `product-card`, `quick-picks`, `where-to-buy`, `comparison-table`, `verdict`, `rating-breakdown`, `specifications`
* **Conversion & social proof** β `contextual-cta`, `pricing`, `testimonial`, `trust-signals`
* **Navigation** β `related-posts`
All blocks share consistent typography, spacing, and color tokens. You pick the block that matches the content you're writing and the theme handles the styling.
{% hint style="info" %}
Prefer to let an AI assistant assemble these for you? With [**Agent Access**](/ai-agents/ai-agents), you can connect ChatGPT or Claude and ask it to build a full review or roundup from Egg Blocks β you just describe what you want.
{% endhint %}
#### Benefits over core Gutenberg blocks
* **Semantic structure** β a `pros-cons` block carries more meaning than a two-column list; a `faq` block emits FAQPage JSON-LD automatically
* **Product-aware** β product-bound blocks pull live price, availability, and CTA URL from Content Egg offers at render time β no stale prices in your content
* **Consistent styling** β all blocks respect a single theme and color scheme setting
* **Multiple variants** β most blocks offer 2β6 visual styles (default, compact, cards, inline, etc.) so the same data can match different article layouts
* **AI-friendly** β the schema is stable and documented, so tools like the EggBlocks Writer skill can generate complete articles you copy-paste
***
### Getting started
#### Inserting a block
1. Open a post or page in the WordPress block editor.
2. Click the **+** (Add block) button.
3. Type the block name (e.g. `pros cons`, `quick picks`, `faq`) into the block search, or open the **Egg Blocks** category.
4. Click the block to insert it.
