--- title: Stock History Settings Reference description: "Every Stock History & Reports Manager for WooCommerce setting with its label, option ID, default and Free/Pro status." url: "https://wpfactory.com/docs/stock-history-settings/" updated: "2026-10-05" category: References --- # Stock History Settings Reference This is the complete settings reference for [Stock History & Reports Manager for WooCommerce](https://wpfactory.com/item/stock-snapshot-for-woocommerce/): every label, option ID, default and Free/Pro status, by section. Find the settings at **WPFactory > Stock Snapshot** (also reachable at **WooCommerce > Settings > Stock Snapshot**). Only the Emails section switches are Pro. ## General section ### Stock Snapshot Options | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Product update snapshots (take a snapshot on each product update) | `alg_wc_stock_snapshot_product_update` | Yes | Free | | Extra data (store action, context, order ID and user with each snapshot) | `alg_wc_stock_snapshot_extra_data` | Yes | Free | | Allow snapshots via URL (site address plus `?alg_wc_stock_snapshot=1`) | `alg_wc_stock_snapshot_url` | No | Free | ### Variable Product Options | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Include variations (track variations as separate products) | `alg_wc_stock_snapshot_include_variations` | Yes | Free | | Append variations (add variations' stock to the parent product's stock) | `alg_wc_stock_snapshot_count_children` | No | Free | ### Periodic Snapshots Options | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Periodic snapshots | `alg_wc_stock_snapshot_action_scheduler` | Yes | Free | | Interval (in seconds), minimum 60 | `alg_wc_stock_snapshot_action_scheduler_interval` | 86400 (24 hours) | Free | ### Advanced Options | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Prepare reports in background (affects the Report section) | `alg_wc_stock_snapshot_report_do_in_background` | No | Free | The General section also lists the `[alg_wc_stock_snapshot_restocked]` shortcode. See [How to Show Recently Restocked Products in WooCommerce](https://wpfactory.com/docs/stock-history-restocked-products/). ## Tools section Tick a tool and click **Save changes** to run it. The box unticks itself after the run. | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Take snapshot (take a snapshot of all products now) | `alg_wc_stock_snapshot_tools_take_snapshot` | No | Free | | Delete all snapshots (no undo) | `alg_wc_stock_snapshot_tools_delete_snapshots` | No | Free | | Clear plugin transients (cached Report, History and shortcode results) | `alg_wc_stock_snapshot_clear_transients` | No | Free | Plugin transients are also cleared every time you save any section of the settings. ## Report section The Report section has no stored settings and no Save button. Its range links, user, category and report type selectors and date fields are applied through the page address. See [How to Create a WooCommerce Stock Change Report](https://wpfactory.com/docs/stock-history-stock-change-report/). ## History section | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Scale (Years, Months, Days, Hours, Minutes, Seconds) | `alg_wc_stock_snapshot_history_date_points` | Days | Free | | Product categories | `alg_wc_stock_snapshot_history_product_cats` | Empty (all categories) | Free | ## Emails section ### Email Options (snapshot emails) | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Emails | `alg_wc_stock_snapshot_email_enabled` | No | Pro | | Email address | `alg_wc_stock_snapshot_email_address` | Site admin email | Pro | | Email subject (placeholders `{site_title}`, `{date}`) | `alg_wc_stock_snapshot_email_subject` | `{site_title} - Stock Snapshot - {date}` | Pro | | Email heading | `alg_wc_stock_snapshot_email_heading` | Stock Snapshot | Pro | | Email content (placeholders `{stock_changes}`, `{all_stock}`) | `alg_wc_stock_snapshot_email_content` | "Stock Changes" and "All Stock" headings with both tables | Pro | ### Report Email Options | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Daily report emails | `alg_wc_stock_snapshot_report_emails_enabled` | No | Pro | | Email data (one line per email: `report type|days|email address|email subject|time`) | `alg_wc_stock_snapshot_report_emails` | Empty | Pro | In the free version the **Emails** and **Daily report emails** checkboxes are disabled, and the other email fields have no effect. See [How to Email WooCommerce Stock Reports Automatically](https://wpfactory.com/docs/stock-history-email-reports/). ## Reset settings Every section except Report ends with **Reset section settings** (option ID `alg_wc_stock_snapshot_{section}_reset`, default No). Tick it and save to restore that section's defaults. A notice confirms "Your settings have been reset." ## Related guides - [Getting started with Stock History](https://wpfactory.com/docs/stock-history-getting-started/) - [Stock History Free vs Pro](https://wpfactory.com/docs/stock-history-free-vs-pro/) Need a hand? Our team answers every ticket on the [Stock History support forum](https://wpfactory.com/support/). Related articles - [Stock History Developer Reference: Hooks, Filters and Data](https://wpfactory.com/docs/stock-history-developers/) - [Stock History Troubleshooting: Missing Snapshots, Slow Reports and Emails](https://wpfactory.com/docs/stock-history-troubleshooting/) - [How to See WooCommerce Stock History for a Product](https://wpfactory.com/docs/stock-history-product/) - [How to Schedule Automatic WooCommerce Stock Snapshots](https://wpfactory.com/docs/stock-history-schedule-snapshots/) - [How to See WooCommerce Stock Levels on a Past Date](https://wpfactory.com/docs/stock-history-past-stock-levels/)