Documentation

Time-Based Offers for WooCommerce is a powerful behavioral discount system designed to increase your WooCommerce store's conversion rates. The plugin displays intelligent time-limited discount popups when visitors spend a configured amount of time browsing your product pages.

What is Time-Based Offers for WooCommerce?

Time-Based Offers for WooCommerce is a standalone behavioral discount system with a custom admin panel. It shows a time-limited discount popup when visitors stay on a product page for a configured duration. This strategic approach helps convert hesitant visitors into customers by offering timely incentives at the right moment.

Key Benefits

• Increase Conversions: Convert up to 40% more visitors with behavioral targeting
• Smart Timing: Show popups at the optimal moment based on visitor behavior
• Flexible Targeting: Apply discounts to specific products, categories, or globally
• Real-time Analytics: Track impressions, claims, conversions, and revenue
• Custom Design: Fully customize popup appearance to match your brand

How It Works

The plugin uses a behavioral targeting approach. When a visitor lands on a product page, a timer starts counting. Once the configured trigger time is reached (e.g., 1 minute), a discount popup appears offering a time-limited discount. Visitors can claim the discount and proceed to checkout, where the discount is automatically applied.

Why Choose Time-Based Offers for WooCommerce?

Unlike traditional coupon systems that require customers to manually enter codes, Time-Based Offers for WooCommerce automatically applies discounts at checkout. This frictionless experience increases conversion rates and reduces cart abandonment. The behavioral targeting ensures discounts are shown to engaged visitors who are more likely to convert.

System Requirements

Step 1: Download the Plugin

Purchase and download the Time-Based Offers for WooCommerce plugin zip file from our website. The file will be named something like time-based-offers-for-woocommerce.zip.

Step 2: Prerequisites - Install WooCommerce

Before installing Time-Based Offers for WooCommerce, ensure you have WooCommerce installed and activated on your WordPress site:

1. 1. Go to Plugins → Add New
2. 2. Search for "WooCommerce"
3. 3. Click "Install Now" on the WooCommerce plugin
4. 4. Click "Activate" after installation completes
5. 5. Follow the WooCommerce setup wizard if prompted

Step 3: Upload to WordPress

1. 1. Log in to your WordPress admin dashboard
2. 2. Navigate to Plugins → Add New
3. 3. Click the "Upload Plugin" button at the top
4. 4. Select the Time-Based Offers for WooCommerce plugin zip file from your computer
5. 5. Click "Install Now"

Step 4: Activate the Plugin

After installation, click the "Activate Plugin" button. The plugin will automatically check if WooCommerce is active. If WooCommerce is not installed or activated, you'll see an error message and the plugin will be deactivated automatically.

Step 5: Activate License or Free Trial

Before creating discount rules, you must activate the plugin with either a Free Trial or a Pro license key. Go to Time-Based Offers → Settings and complete one of the two sections below. See the Licensing & Trial section for full details.

Step 6: Access the Dashboard

Navigate to Time-Based Offers → Dashboard to view analytics. Use Product Rules to create discounts and Settings to manage license and popup design.

Time-Based Offers for WooCommerce uses server-side license verification. Your WordPress site must be connected to our licensing server with either a free trial email or a Pro license key. Without an active trial or license, the plugin will not run on the storefront and admin features will be locked.

Where to Activate

Go to WordPress Admin → Time-Based Offers → Settings. You will see two separate sections:

• Free Trial — for trial users (email only)
• Pro Plan License — for paid customers (license key)

Option A: Free Trial

Start a free trial from our website, then connect it to your WordPress store:

1. 1. Visit our website and register for the Free Trial using your email address
2. 2. In WordPress, go to Time-Based Offers → Settings → Free Trial
3. 3. Enter the same email you used on our website
4. 4. Click Verify Trial to check status, then Save Trial Email

Option B: Pro Plan License

After purchasing Pro on our website, activate your license in WordPress:

1. 1. Purchase the Pro plan on our website and copy your license key
2. 2. Go to Time-Based Offers → Settings → Pro Plan License
3. 3. Paste your license key in the License Key field
4. 4. Click Verify License, then Save License

What Happens When Trial Expires?

When your free trial expires and you do not have a valid Pro license:

• Product Rules locked — you cannot add, edit, delete, or activate/deactivate rules
• Frontend disabled — discount popups will not appear on product pages
• Existing rules paused — rules list shows "Paused — License expired — not running on shop"
• Discounts stop applying — no discounts at checkout

Admin Menu Overview

Verification & Security

• License status is verified against our server — not stored locally only
• Your discount rules are saved in your Time-Based Offers account and synced to your store automatically, so they are never lost when you move or reinstall the plugin
• Your store refreshes its rules every few hours; if our server is briefly unreachable, your popups keep working for up to 48 hours
• Status is re-checked daily via WP-Cron and on admin actions
• Each site domain is validated during verification
• Use Verify Trial or Verify License before saving to confirm status

All payments on our website are processed securely through Paddle — a trusted global payment platform. Paddle handles card details, wallets, and PayPal so your payment information stays encrypted and secure. You do not pay inside the WordPress plugin; payment happens on our website first, then you connect your account to WordPress.

Supported Payment Methods

Before You Pay

1. 1. Create an account on our website (Sign Up) or Log In if you already have one
2. 2. Go to the Pricing section and choose Free Trial or Pro
3. 3. The secure payment window opens — enter your email and select your country
4. 4. Click your preferred payment method — Paddle checkout opens as an overlay
5. 5. Complete payment — your trial or license is activated automatically

Free Trial Payment ($0)

The Free Trial plan costs $0. When you click Start Free Trial:

• The same payment screen opens with Google Pay, Apple Pay, PayPal, and Card options
• Click a payment method to open the Paddle checkout overlay (used to verify your payment details for the trial)
• Alternatively, submit the form to start the trial directly when available
• Your trial period begins (default: 14 days) — full plugin access during this time
• No automatic charge when the trial ends — you must manually upgrade to Pro

Pro Plan Payment (Paid)

When you purchase the Pro plan:

• Currency: All payments are in USD ($) only
• Domain quantity: Select how many website domains you need (each domain gets a license)
• Payment required: You must select a payment method (Google Pay, Apple Pay, PayPal, or Card)
• Paddle checkout: Complete payment in the Paddle overlay
• License key: Generated automatically after successful payment
• Lifetime access: Pro is a one-time purchase — no monthly subscription

My Account & Payment History

After logging in, open My Account from the website header to view:

• Trial status — active trial days remaining or expired notice
• License key — your Pro license key (after paid purchase)
• Activated domain — which WordPress site is linked to your license
• Payment History — list of trial and paid transactions with date, amount, and payment method
• Upgrade to Pro — button to purchase when trial expires

Payment Flow Diagram

Troubleshooting Payments

Step 0: Activate Trial or License

Before creating rules, activate the plugin in Time-Based Offers → Settings:

• Free Trial: Enter your website trial email → Verify Trial → Save Trial Email
• Pro Plan: Enter license key → Verify License → Save License

Your First Discount Rule

Let's create your first discount rule to see how the plugin works.

1. 1.
   Navigate to Add New Rule

   Go to Time-Based Offers → Product Rules → Add New

2. 2.
   Configure Target

   Select "All Products" for your first rule to apply it globally

3. 3.
   Set Trigger Time

   Enter 1 as the trigger time (Timing Settings are in minutes, so 1 = 1 minute)

4. 4.
   Configure Discount

   Select "Percentage" and enter 20 as the discount value

5. 5.
   Save the Rule

   Click "Save Rule" to activate it

Testing Your Rule

To test your new rule:

1. 1. Open an incognito/private browser window
2. 2. Navigate to any product page on your store
3. 3. Wait for 1 minute on the page
4. 4. The discount popup should appear
5. 5. Click "Claim Discount" and proceed to checkout to verify the discount is applied

Core Features

Technical Features

• WooCommerce HPOS (High-Performance Order Storage) compatible
• Session management to prevent popup spam
• Automatic cart integration with discount application
• Clean code with no conflicts with other plugins
• Mobile-responsive popup design
• Server-side license verification (Free Trial + Pro Plan)
• Performance optimized with minimal page load impact

There is one plugin for both plans. Free Trial and Pro users install exactly the same plugin — your plan decides which options are available. Activate it in Time-Based Offers → Settings with your trial email or Pro license key.

Upgrading is instant: there is nothing new to download or reinstall. After purchasing Pro, enter your license key in Settings and the Pro options unlock right away. Your existing discount rules stay as they are.

In Product Rules, Pro-only sections show a Pro Feature notice until you activate a Pro license key. Upgrade from our website Pricing page.

Go to Time-Based Offers → Settings to manage licensing and global plugin options. Settings are organized into separate sections.

Free Trial Section

• Account Email: Same email used on our website to start the free trial
• Verify Trial: Checks trial status with our server without saving
• Save Trial Email: Saves the email to your WordPress site

Pro Plan License Section

• License Key: Your Pro license key from our website after purchase
• Verify License: Validates the key with our server
• Save License: Saves the license key to your WordPress site

General Settings

• Enable Plugin Globally: Plugin is active; individual rules are controlled in Product Rules
• Discount Applied Message: Text shown on the product page when a discount is active (e.g. "Special Offer Applied!")

Popup Design

Customize the discount popup appearance with a live preview:

• Background Color — popup panel background
• Text Color — main text color
• Button Color — "Claim Discount" button background
• Button Text Color — button label color
• Badge Color — discount badge (e.g. "20% OFF")
• Border Radius — rounded corners in pixels
• Font Family — Theme Default, Arial, Georgia, Inter, or Roboto
• Logo / Image URL — optional logo at top of popup (upload supported)

Complete Rule Settings

Step 1: Target Selection

Choose where to apply your discount rule:

• Specific Product: Apply to individual products (highest priority)
• Product Category: Apply to entire product categories (medium priority)
• All Products (Global): Apply to all products globally (lowest priority)

Step 2: Rule Status

Enable or disable the rule:

• Enable this rule: Check the box to activate the discount rule
• Disable this rule: Uncheck to deactivate without deleting

Step 3: Schedule (Optional) Pro

Restrict the rule to specific dates, days, or times. Requires Pro license.

• Enable Schedule: Check to activate scheduling options
• Quick Presets: Choose from Weekends Only, Weekdays Only, or Business Hours
• Date Range: Set start and end dates for the promotion
• Days of Week: Select specific days (Sunday through Saturday)
• Time Range: Set start and end times for daily activation

Step 4: Timing Settings

Configure when and how the popup appears:

• Trigger Time (Minutes): Time visitor must spend on page before popup appears (default: 1 minute; recommended: 0.5-1.5 minutes)
• Discount Duration (Minutes): How long the first offer is valid after claiming (countdown timer value). Default for a new rule: 60 minutes (1 hour)
• Re-trigger Delay (Minutes): How long to wait before showing popup again if user closes it. 0 = do not show it again Pro

Step 5: Discount Configuration

Set the discount type and value:

• Percentage Discount (%): Discount as a percentage (e.g., 20 for 20% off) — available on Free Trial
• Fixed Amount: Fixed currency amount off the product price Pro
• Flat Product Price: Set a fixed price for the product Pro
• Discount Value: Enter the numeric value based on selected type

Step 6: Popup Content

Customize the popup message:

• Popup Heading: Main headline text (default: "Special Offer Just For You!")
• Popup Message: Detailed message with formatting options (default: "Wait! Don't leave yet...")

Step 7: Second Tier Offer (Optional) Pro

Configure a backup offer for visitors who close the first popup. If they close the second popup too, they are not shown any further offer for that product:

• Enable Second Offer: Check to activate second tier offer
• Second Discount Type: Choose percentage, fixed, or flat price
• Second Discount Value: Enter the discount amount (often higher than first offer)
• Second Discount Duration (Minutes): How long the second offer is valid after claiming (countdown timer value). Default: 120 minutes (2 hours)
• Second Popup Heading: Custom heading for second popup
• Second Popup Message: Custom message for second popup

Complete Step-by-Step Guide

1. 1
   Navigate to Add New Rule

   Go to Time-Based Offers → Product Rules → Add New

   This will open the rule creation form with all configuration options.

2. 2
   Configure Target Selection

   Choose one of three target types:

   • • Specific Product: Select individual products from dropdown (highest priority)
   • • Product Category: Select a category to apply to all products in it (medium priority)
   • • All Products (Global): Apply to all products store-wide (lowest priority)
3. 3
   Set Rule Status

   Check "Enable this rule" to activate the discount immediately after saving.

   You can disable rules later without deleting them by unchecking this option.

4. 4
   Configure Schedule (Optional) Pro

   Check "Enable Schedule" to restrict the rule to specific times:

   • • Quick Preset: Choose Weekends Only, Weekdays Only, or Business Hours (9AM-6PM)
   • • Date Range: Set start and end dates for the promotion period
   • • Days of Week: Select specific days (Sunday through Saturday checkboxes)
   • • Time Range: Set start and end times for daily activation

   Leave all schedule options blank to run the rule continuously.

5. 5
   Set Timing Settings

   Configure when the popup appears:

   • • Trigger Time (Minutes): Enter time visitor must spend on page (recommended: 0.5-1.5 minutes)
   • • Discount Duration (Minutes): Enter how long discount is valid after claiming (countdown timer; default 60 minutes)
   • • Re-trigger Delay (Minutes): Enter wait time before showing popup again if user closes it Pro

   Example: Trigger Time: 1, Discount Duration: 60, Re-trigger Delay: 5

   This means popup appears after 1 minute, discount valid for 1 hour, and reappears after 5 minutes if closed. Decimals are allowed (0.5 = 30 seconds).

6. 6
   Configure Discount

   Set the discount type and value:

   • • Percentage Discount (%): Enter percentage (e.g., 20 for 20% off)
   • • Fixed Amount: Enter a fixed amount off (e.g., 100 for 100 off in your store currency) Pro
   • • Flat Product Price: Set a fixed price for the product Pro

   Enter the Discount Value based on your selected type.

7. 7
   Customize Popup Content

   Personalize the popup message:

   • • Popup Heading: Main headline (default: "Special Offer Just For You!")
   • • Popup Message: Detailed message with rich text editor (default: "Wait! Don't leave yet...")

   Use the rich text editor to add formatting, links, or custom styling to your message.

8. 8
   Configure Second Tier Offer (Optional) Pro

   Set up a backup offer for visitors who close the first popup (closing the second popup ends the offers for that product):

   • • Check "Enable Second Offer" to activate
   • • Choose Second Discount Type (percentage, fixed, or flat)
   • • Enter Second Discount Value (often higher than first offer)
   • • Enter Second Discount Duration in minutes — how long the second offer is valid after claiming (default 120 minutes = 2 hours)
   • • Customize Second Popup Heading and Message

   Tip: Use a higher discount value for the second offer to incentivize conversion (e.g., First: 15%, Second: 20%)

9. 9
   Save the Rule

   Click the "Save Rule" button at the bottom of the form.

   The rule is now active on your store and will start showing popups based on your configuration.

Managing Multiple Rules

When you have multiple discount rules for the same product, you can easily activate or deactivate them without deleting them. This allows you to test different offers or temporarily disable promotions.

How to Activate/Deactivate Rules

1. 1. Navigate to Time-Based Offers → Product Rules
2. 2. You will see a list of all your discount rules with their current status
3. 3. Click the "Edit" button next to the rule you want to modify
4. 4. Check or uncheck "Enable this rule" to activate or deactivate
5. 5. Click "Save Rule" to apply the changes

Filtering and Searching Rules

When you have many rules, use the filter bar above the rules list in Time-Based Offers → Product Rules to find the ones you need.

• Filter by category — choose a category and click Filter. The list shows the category rules for that category (and its sub-categories) and the product rules for products in that category.
• Search by product name — type part of a product name and click Search Rules. Upper and lower case do not matter, so "shirt" also finds "Blue Shirt".
• Use both together — for example, choose "Clothing" and search for "shirt".
• Clear Filter removes the category filter and keeps your search. Clear Search removes the search and keeps the category filter. Each button is greyed out when there is nothing to clear.
• The filter and search stay in place after you activate, deactivate or delete rules, including bulk actions.

Sorting the Rules List

Click the Product or Status column heading to sort the list. Click the same heading again to reverse the order. An arrow next to the heading shows the current direction.

• Product — sorts A to Z (or Z to A) by the name shown in the column: the product name, the category name for category rules, or "All Products (Global Rule)". Upper and lower case do not matter.
• Status — ascending shows Active rules first, then Paused — requires Pro, then Inactive; descending shows the opposite.
• Sorting only changes the order of the list. It does not change any rule or its status, and it does not change which rule is applied on your store.
• Until you click a heading, the list keeps its normal order. Rules with the same name or status keep their normal order among themselves.
• The sort stays in place when you filter, search, clear a filter or search, and after you activate, deactivate or delete rules (including bulk actions).
• The Trigger and Duration columns are shown in minutes (e.g. "60 min").

Target Types Explained

Priority Order

1. 1. Product-specific rules (highest priority)
2. 2. Category rules (medium priority)
3. 3. Global rules (lowest priority)

Scheduling is a Pro-only feature. On Free Trial these options stay locked until you activate a Pro license.

Date Range Scheduling

• Start Date: When the rule becomes active
• End Date: When the rule expires
• Leave blank for no date restrictions

Day of Week Scheduling

Select specific days (e.g., Weekends only). Useful for limited-time weekly promotions. Can combine with date ranges.

Time Window Scheduling

Set specific hours (e.g., 9 AM - 5 PM). Useful for business hours promotions. Can combine with day and date scheduling.

Quick Presets

• Weekends: Saturday & Sunday
• Weekdays: Monday - Friday
• Business Hours: 9 AM - 5 PM
• After Hours: 5 PM - 9 AM

Design Options

Colors

• Background Color: Popup background
• Overlay Color: Background overlay
• Button Color: CTA button color
• Text Color: Main text color
• Heading Color: Heading text color

Typography

• Font Family: Choose from available fonts
• Font Size: Adjust text size
• Font Weight: Normal, bold, etc.

Layout

• Border Radius: Rounded corners
• Padding: Internal spacing
• Shadow: Drop shadow effect

Content

• Heading Text: Main headline
• Description Text: Subheading or description
• Button Text: CTA button label
• Logo: Upload your brand logo

Best Practices

• Use colors that match your brand
• Keep text concise and compelling
• Use clear, action-oriented button text
• Test different designs to optimize conversions

Second Tier Offers and Re-trigger Delay are Pro-only features.

What Are Second Tier Offers?

When a visitor closes the first discount popup, you can show a second offer after a delay. This helps recover abandoning visitors who weren't convinced by the first offer.

Configuration

1. Enable Second Tier: Toggle "Enable Second Tier Offer" to ON
2. Set Re-trigger Delay: Time in minutes before showing second popup (recommended: 0.5-1 minute)
3. Configure Second Discount: Can be different from first offer (often a higher discount)
4. Set Second Discount Duration: Time in minutes the second offer stays valid after it is claimed (countdown timer). It is separate from the first offer's Discount Duration. Default: 120 minutes (2 hours)
5. Customize Second Popup: Separate design options for second popup

Use Cases

Metrics Tracked

Viewing Analytics

1. Go to Time-Based Offers → Dashboard
2. Select date range (Today, Yesterday, Last 7 Days, Last 30 Days, Custom)
3. View metrics for each rule
4. Export data if needed

Using Analytics to Optimize

• High Impressions, Low Claims: Improve popup design or offer value
• High Claims, Low Conversions: Improve checkout flow or offer terms
• Low Impressions: Increase trigger time or expand targeting

Getting Help

Premium Support

Pro plan customers receive priority support with faster response times and dedicated assistance.

Reporting Bugs

To report a bug or issue:

1. Describe the issue in detail
2. Include your WordPress and WooCommerce versions
3. Include plugin version
4. Provide screenshots if applicable
5. Contact us on WhatsApp: +91 88663 00463