Bundle Status & Lifecycle

Overview

Each bundle has a lifecycle that controls its visibility and availability on the storefront.

This is managed through:

• Activation (on/off)
• Scheduling (start and end time)

Bundle Status

Active

• The bundle is visible on the storefront
• Customers can interact with it and add items to cart
• Discounts and bundle logic are applied
• Analytics are tracked

Inactive

• The bundle is hidden from the storefront
• Customers cannot purchase the bundle
• The bundle remains available in the dashboard for editing

Scheduled

When scheduling is enabled:

• Before start time → bundle is hidden
• During active period → bundle is visible and purchasable
• After end time → bundle is automatically hidden

Activation Behavior

When a bundle is activated:

• Required discount logic is created and linked
• Shipping discounts are applied if configured
• Bundle logic (including cart behavior) is initialized
• The bundle becomes available on the storefront

Deactivation Behavior

When a bundle is deactivated:

• The bundle is removed from the storefront
• Associated discount logic is disabled
• Bundle configuration (steps, items, discounts, styling) remains محفوظ and can be reactivated

Deactivation does not delete the bundle.

Auto Activation

• By default, new bundles can be automatically activated after creation
• If disabled, bundles remain inactive until manually activated

Resource Recovery

The app ensures bundle functionality remains intact:

• If any required bundle resource (such as discounts) is removed externally
• The app can automatically restore it

This prevents bundles from breaking due to external changes.

Deleting a Bundle

Deleting a bundle permanently removes:

• Steps and items
• Discounts and configurations
• Styling and settings

Before deletion:

• The bundle is deactivated
• All associated resources are removed

⚠️ Deletion cannot be undone.

Lifecycle Flow

A typical bundle lifecycle:

1. Inactive → Bundle created
2. Scheduled → Optional future start time
3. Active → Bundle is live
4. Inactive/Expired → Hidden manually or by schedule

Important Notes

• Activation is required for bundles to appear on the storefront
• Scheduling works automatically once configured
• Deactivation is recommended instead of deletion for temporary changes
• All lifecycle updates follow the store’s timezone

Best Practices

• Use scheduling for time-based campaigns
• Verify discount setup before activation
• Prefer deactivation over deletion to preserve configuration
• Monitor active bundles to ensure proper functionality