---
title: URL Coupons Settings and Option IDs Reference
description: Every WooCommerce URL coupon setting with its option ID, default, and free or Pro status, plus notice placeholders.
url: "https://wpfactory.com/docs/url-coupons-settings-reference/"
updated: "2026-09-27"
category: References
---

# URL Coupons Settings and Option IDs Reference

This is the complete option reference for [Coupons & Add to Cart by URL Links for WooCommerce](https://wpfactory.com/item/url-coupons-woocommerce/), listing every setting, its stored option ID, default value, and whether it is available in the free version or requires Pro. Use it to confirm an exact option key, script a configuration, or check a default before you change it. Every value here is taken from the plugin source (Pro v1.8.2).

All of these settings live under **WPFactory > Coupons by URL** (also reachable at **WooCommerce > Settings > URL Coupons**), split across three sub-tabs: **General**, **Notices**, and **Advanced**.

### General sub-tab

| Label | Option ID | Type | Default | Free/Pro |
| --- | --- | --- | --- | --- |
| URL Coupons (enable plugin) | `alg_wc_url_coupons_enabled` | Checkbox | yes | Free |
| URL coupons key | `alg_wc_url_coupons_key` | Text | `alg_apply_coupon` | Free |
| Session: force session start | `alg_wc_url_coupons_force_start_session` | Checkbox | yes | Free |
| Force session start earlier and everywhere | `alg_wc_url_coupons_force_start_session_earlier` | Checkbox | no | Free |
| Add products to cart (enable) | `alg_wc_url_coupons_fixed_product_discount_add_products` | Checkbox | no | Pro |
| Add products to cart: empty cart first | `alg_wc_url_coupons_fixed_product_discount_add_products_emptycart` | Checkbox | no | Pro |
| Delay coupon (enable section) | `alg_wc_url_coupons_delay_coupon` | Checkbox | no | Free |
| Delay on non-empty cart | `alg_wc_url_coupons_delay_coupon_non_empty_cart` | Select | yes | Free |
| Check product | `alg_wc_url_coupons_delay_coupon_check_product` | Checkbox | no | Free |
| Delay coupon: success notice | `alg_wc_url_coupons_delay_coupon_notice[success]` | Textarea | Coupon code applied successfully. | Free |
| Delay coupon: error, already applied | `alg_wc_url_coupons_delay_coupon_notice[error_applied]` | Textarea | Coupon code already applied! | Free |
| Delay coupon: error, does not exist | `alg_wc_url_coupons_delay_coupon_notice[error_not_found]` | Textarea | Coupon "%coupon_code%" does not exist! | Free |
| Hide coupon field: cart page | `alg_wc_url_coupons_cart_hide_coupon` | Checkbox | no | Free |
| Hide coupon field: checkout page | `alg_wc_url_coupons_checkout_hide_coupon` | Checkbox | no | Free |
| Hide condition | `alg_wc_url_coupons_hide_coupon_condition` | Select | always | Free |
| Redirect URL | `alg_wc_url_coupons_redirect` | Select | no | Pro |
| Custom local URL | `alg_wc_url_coupons_redirect_custom_url` | Text | (empty) | Pro |
| Redirect URL per coupon | `alg_wc_url_coupons_redirect_per_coupon` | Checkbox | no | Pro |

### Notices sub-tab

| Label | Option ID | Type | Default | Free/Pro |
| --- | --- | --- | --- | --- |
| Delay notice | `alg_wc_url_coupons_delay_notice` | Checkbox | no | Free |
| Custom notice | `alg_wc_url_coupons_notice` | Textarea | (empty) | Pro |
| Notice per coupon | `alg_wc_url_coupons_notice_per_coupon` | Checkbox | no | Pro |
| Override global notice | `alg_wc_url_coupons_notice_per_coupon_override` | Checkbox | no | Pro |
| Override default notice | `alg_wc_url_coupons_notice_remove_default` | Checkbox | no | Pro |
| Notice method | `alg_wc_url_coupons_notice_method` | Select | add | Pro |
| Notice type | `alg_wc_url_coupons_notice_type` | Select | success | Pro |
| Notice glue | `alg_wc_url_coupons_notice_glue` | Text | `<br>` | Pro |

### Advanced sub-tab

| Label | Option ID | Type | Default | Free/Pro |
| --- | --- | --- | --- | --- |
| Save on empty cart | `alg_wc_url_coupons_save_empty_cart` | Checkbox | no | Free |
| Remove "add to cart" key | `alg_wc_url_coupons_remove_add_to_cart_key` | Checkbox | yes | Free |
| Force coupon redirect | `alg_wc_url_coupons_add_to_cart_action_force_coupon_redirect` | Checkbox | no | Free |
| WP Rocket: disable empty cart caching | `alg_wc_url_coupons_wp_rocket_disable_cache_wc_empty_cart` | Checkbox | no | Free |
| Payment request buttons: WooCommerce Stripe Gateway | `alg_wc_url_coupons_payment_request_product_data[wc_stripe]` | Checkbox | no | Free |
| Payment request buttons: WooCommerce Payments | `alg_wc_url_coupons_payment_request_product_data[wcpay]` | Checkbox | no | Free |
| Javascript reload | `alg_wc_url_coupons_javascript_reload` | Checkbox | no | Free |
| Main hook | `alg_wc_url_coupons_main_hook` | Select | wp_loaded | Free |
| Hook priority | `alg_wc_url_coupons_priority` | Number | (empty, uses lowest priority) | Free |
| Data storage type | `alg_wc_url_coupons_data_storage_type` | Select | session | Free |
| Extra cookie | `alg_wc_url_coupons_cookie_enabled` | Checkbox | no | Free |
| Cookie expiration (seconds) | `alg_wc_url_coupons_cookie_sec` | Number | 1209600 (14 days) | Free |

Each sub-tab also carries a **Reset section settings** checkbox (`alg_wc_url_coupons_<section>_reset`, default `no`). Ticking it and saving deletes that section's options and returns them to the defaults above.

### Notice placeholders

The notice fields support one placeholder, which the plugin swaps for the coupon code at display time:

| Placeholder | Replaced with | Where it works |
| --- | --- | --- |
| `%coupon_code%` | The coupon code from the URL | The Delay coupon success and error notices |

### Related reading

For code-level extension points (the actions and filters), see the [URL Coupons](https://wpfactory.com/item/url-coupons-woocommerce/) developer hooks and filters reference. To change any value in the admin, open **WPFactory > Coupons by URL**.

### Need a hand?

If an option is not behaving as its default suggests, our team answers every ticket on the [URL Coupons support forum](https://wpfactory.com/support/item/url-coupons-woocommerce/).

Related articles

- [URL Coupons: Developer Hooks and Filters Reference](https://wpfactory.com/docs/url-coupons-developer-hooks-filters/)
- [Make URL Coupons Work for Guests and Cached Sites](https://wpfactory.com/docs/woocommerce-url-coupons-guests-caching/)
- [How to Translate URL Coupon Text with WPML and Polylang](https://wpfactory.com/docs/woocommerce-translate-url-coupon-notices/)
- [How to Set a Redirect URL Per Coupon](https://wpfactory.com/docs/woocommerce-redirect-url-per-coupon/)
- [How to Delay a URL Coupon Until a Product Is Added](https://wpfactory.com/docs/woocommerce-delay-url-coupon/)