> For the complete documentation index, see [llms.txt](https://ce-docs.keywordrush.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ce-docs.keywordrush.com/updating-products/price-alert.md).

# Price Alerts

Price alerts let visitors leave their email and get a message when a product gets cheaper, or when a sold-out product is back in stock. Each alert sends one email, then it is done.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-7a5827cbcbae2ad29adec2eff5ef52b78ecf174b%2Fprice-alerts-form.webp?alt=media" alt=""><figcaption><p>The sign-up form on a post</p></figcaption></figure>

### Turn On Price Alerts

1. Go to **Content Egg > Settings > Price alerts**.
2. Make sure **Price History** is more than 0. Alerts compare against the price history.
3. Check **Enable Price Alerts**.
4. Set **Alert Design** to **Modern**. Classic is deprecated; subscribers keep their alerts when you switch.
5. Optional: set **Sender Name** and **Sender Email Address**. Use an address on your site's domain, so the emails don't land in spam.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-3db782c7c702a8954e06d5576b0fe71db52c6e5b%2Fprice-alerts-settings.webp?alt=media" alt=""><figcaption><p>Content Egg → Settings → Price alerts</p></figcaption></figure>

{% hint style="info" %}
Select a privacy page in **Settings > Privacy**. The form then shows an "I agree to the Privacy Policy" checkbox that visitors must tick.
{% endhint %}

### Add the Form to a Post

* **Block editor:** add the **CE Products** block and choose the **Price drop alert** template.
* **Shortcode:**

```
[content-egg-block template=price_alert]
```

Visitors choose **Any drop**, a discount (**−5%**, **−10%**, **−20%**, each with its price), or **Custom** to type their own price, then enter their email.

When every product in the block is out of stock, the form asks for a back-in-stock email instead:

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-4005e22deb02ab148e780cbd6d7ed39dc9ae9d7f%2Fprice-alerts-form-back-in-stock.webp?alt=media" alt=""><figcaption><p>The form for an out-of-stock product</p></figcaption></figure>

**Alert Trigger Scope** sets what an alert watches:

* **Per product** — the product the visitor subscribed to.
* **Per post** — any product in the post. Use it on price comparison pages.

### What Subscribers Get

1. **A confirmation email.** The alert starts only after the subscriber clicks **Confirm my alert**. Unconfirmed alerts are deleted after 30 days.
2. **One alert email** when the price drops to their target, or when the product is back in stock.
3. **A way back:** the price drop email has an **Alert me if it drops further** link that sets up a new alert from the current price.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-e64378eb58444af29f4e5eb8a9e92391ebdd06bd%2Fprice-alerts-email.webp?alt=media" alt=""><figcaption><p>The price drop email</p></figcaption></figure>

Every email has **Manage your alerts** and **Unsubscribe** links. Mail apps that show their own unsubscribe button, such as Gmail and Yahoo, unsubscribe in one click.

If someone signs up again with an address that already has an alert for the product, the site shows the usual message and the address gets an email with a link to its alerts page. Nobody can find out from your site which addresses are subscribed.

### The Subscriber's Alerts Page

The **Manage your alerts** link opens a page with all alerts of that address. No account or login is needed: the link itself proves the address.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-1550be724ffea76627d645555811d7b66b0bf918%2Fprice-alerts-manage-page.webp?alt=media" alt=""><figcaption><p>Subscribers change or remove their alerts here</p></figcaption></figure>

Subscribers can change the price they wait for, confirm an alert still waiting for confirmation, or remove one alert or all of them.

### Customize the Emails

There are three emails: **Activation**, **Price Alert** and **Back in Stock**. Each has a **Subject** and a **Content Template** in **Content Egg > Settings > Price alerts**.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-e64787fc6b9b1f4ef18060896c4a6db25a95b5e7%2Fprice-alerts-email-editor.webp?alt=media" alt=""><figcaption><p>Editing the price drop email</p></figcaption></figure>

* The fields show the default text. Edit it, or leave it as is: text you don't change keeps following plugin updates and translations.
* Click a tag button to insert it, for example `%PRODUCT_TITLE%` or `%PRODUCT_CARD%` (the product with image, prices and a button). **Button** adds a call-to-action button.
* **Preview** shows the email with sample data. **Send test email** sends it to the admin email. **Reset to default** brings back the default text.
* **Email Logo**, **Email Accent Color**, **Email Footer Text** and **Email Signature** apply to all three emails.

### Statistics and Subscribers

Go to **Content Egg > Price Alerts**.

The **Overview** tab shows active alerts, sent emails, the confirmation rate and clicks, a sign-up chart, and the most watched products with their current price and the median target price. Click the number of watchers to see who watches a product.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-6fc798481e53273b43981e5eccafc37e2829bc4c%2Fprice-alerts-overview.webp?alt=media" alt=""><figcaption><p>Content Egg → Price Alerts → Overview</p></figcaption></figure>

The **Subscribers** tab lists every alert. Filter by status or post ID, or search by email. Hover over a row to **Resend confirmation**, **Retry failed** or **Delete**. Use **Export all (CSV)** or **Export active (CSV)** to download the list.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-cd731e848c30f486c9a1dba5846ff13e45962e1f%2Fprice-alerts-subscribers.webp?alt=media" alt=""><figcaption><p>Content Egg → Price Alerts → Subscribers</p></figcaption></figure>

### Sending and Troubleshooting

Content Egg checks alerts when product prices update and sends the emails in the background, up to 25 per minute.

* **No emails go out:** the background queue runs on WP-Cron. If `DISABLE_WP_CRON` is set in `wp-config.php`, make sure a server cron job calls `wp-cron.php`.
* **Emails land in spam:** use an SMTP plugin and a sender address on your site's domain.
* **An alert shows "Failed":** the error is in the **Sent or error** column. Fix the mail setup, then use **Retry failed**.

### Privacy

* Price alert data is included in **Tools > Export Personal Data** and **Tools > Erase Personal Data**.
* Sent alerts are deleted after 180 days. Alerts of a post you delete permanently are deleted with it.
