# Price movers
Want to showcase products that have recently dropped in price? The **Price Movers** feature lets you do exactly that—by displaying products with the biggest recent discounts, either as a widget or shortcode block.
### How It Works
Content Egg tracks historical price data for each product in your site’s database. This allows it to detect **price drops** and display the best deals based on configurable filters.
{% hint style="info" %}
**Note:** Price history builds up over time. You need several update cycles before the Price Movers feature has enough data to display meaningful results.
{% endhint %}
### Configuration
You can control the tracking period via:
**Settings → Content Egg → Price Alerts → Price Drop Period**
This sets the **maximum age (in days)** of price history used to compare old vs. new prices. A longer period increases the chance of detecting a discount.
### Price Movers Widget
The **Price Movers Widget** lets you display a sidebar or block section with the top discounted products during a given period.
**To use:**
1. Go to **Appearance → Widgets**
2. Add the **“Price Movers”** widget to your desired sidebar or block area.
3. Set options such as:
* Number of products to show
* Drop type: absolute or relative
* Timeframe for last price update
* Included/excluded modules
> After adjusting the "Price Drop Period", wait for the next scheduled price update. The changes will apply only after new price history is recorded.
### Price Movers on Pages (Shortcode)
You can also show discounted products directly on pages (e.g., homepage, category page, etc.) using a shortcode.
#### Basic Example:
```plaintext
[content-egg-price-movers template=wdgt_price_movers_list limit=3]
```
#### Full Example with Options:
```plaintext
[content-egg-price-movers template=wdgt_price_movers_grid limit=20 drop_type=absolute direction=drops last_update=7 include_module_ids=Amazon,Ebay2 exclude_module_ids=Walmart]
```
#### Available Shortcode Parameters
| Parameter | Description |
| -------------------- | ---------------------------------------------------------------------- |
| `limit` | Number of products to display (default: `5`) |
| `drop_type` | Type of drop: `absolute` (raw value) or `relative` (percentage) |
| `direction` | `drops` (price decreases) or `increases` (price hikes) |
| `last_update` | Max age (in days) of last update to consider (e.g., `7`) |
| `include_module_ids` | Comma-separated list of module IDs to include (e.g., `Amazon,Walmart`) |
| `exclude_module_ids` | Comma-separated list of module IDs to exclude |
| `template` | Layout: `price_movers_grid` or `price_movers_list` |
### Tips
* Ensure **price history is enabled** in module settings.
* Price Movers needs at least **two recorded prices per product** to calculate changes.
Here is a clearer, more professional, and user-friendly rewrite of your **Custom Price Movers Templates** documentation section:
***
### Custom Price Movers Templates
{% hint style="warning" %}
**Advanced Users Only:** This section is intended for developers or users comfortable editing PHP templates.
{% endhint %}
You can fully customize the output of the **Price Movers** widget by creating your own template.
#### Steps to Create a Custom Template
1. **Locate Default Templates**\
Navigate to the following directory in your WordPress installation:
```
/wp-content/plugins/content-egg/templates/
```
Copy one of the following files:
* `wdgt_price_movers_list.php` (List view)
* `wdgt_price_movers_grid.php` (Grid view)
2. **Paste into the Custom Template Directory**\
Create a new directory if it doesn’t already exist:
```
/wp-content/content-egg-templates/
```
Paste your copied file into this directory.
3. **Rename the File**\
Rename the file while keeping the `wdgt_` prefix. For example:
```
wdgt_price_movers_custom.php
```
4. **Edit the Template**\
Open the file and make any changes needed to the layout, HTML structure, or styling.
5. **Include the Default CSS and a Div Container** (optional)\
To include the default CSS, add the following code to your template:
```php
\ContentEgg\application\components\BlockTemplateManager::getInstance()->enqueueCeggStyle(true);
```
Next, add the following div container:
```html
```
#### Using the Custom Template
Once created, your custom template will appear in the **Price Movers widget** template dropdown with a `[custom]` prefix.
To use it with a **shortcode**, specify the template name (without the `.php` extension):
```php
[content-egg-price-movers template=custom/wdgt_price_movers_custom limit=10]
```
Make sure to use the `custom/` prefix, and ensure the filename matches exactly what you specify in the shortcode.
