Glossary
Key concepts
Promotion
A set of rules and actions that define discounts or special offers for customers. Promotions can be applied to individual items, groups of items, or the entire cart.
Project
A container that corresponds to one online store. Each project has its own settings, promotions, and usage data.
Integration provider
The system or platform that connects your store with Deducto (e.g. Shopify, Algolia, or Typesense – WooCommerce support is coming soon).
Promotion types
Group promotion
Applies to a specific group of products in a customer's cart, which may or may not be the entire contents.
Whole Cart promotion
Applies to the entire cart, treating all items as a single unit.
Whole Cart (Final) promotion
Similar to Whole Cart but always processed last (even if another promotion with a 'Stop' action has been applied) and does not affect the cart's subtotal.
Promotion components
Trigger conditions
Rules that determine if a promotion applies to a customer's cart. When met, they 'trigger' the promotion. Example: "Spend at least $100" for a free shipping promotion.
Item Groups
Define the filter conditions and quantities for product groups to which the promotion action will be applied. Required for item-based promotions.
Action
The specific benefit applied to the customer's cart (e.g., percentage discount, fixed amount off, free shipping). Each promotion can have only one action.
Batch limit
Restricts the number of times a promotion can be applied per cart or per item group.
Promotion flow control
After Processing Action
Defines how a promotion interacts with other promotions:
- Continue: Processing continues to the next promotion in order
- Stop: No further promotions are processed if this promotion applies
- Exclusive: Evaluated before non-exclusive promotions; once applied, no further promotions are considered
Lock affected items
When enabled, items affected by a promotion cannot receive discounts from subsequent promotions. Typically used for group promotions.
Coupon features
Coupon required
When enabled, customers must enter a valid coupon code to trigger the promotion.
Maximum use count
- Per Coupon: Limits how many times an individual coupon can be used
- Per Email: Limits how many times a customer (identified by email) can use the promotion
Attributes
Core attributes
Core attributes are available for all products and carts. These attributes are included in a product or cart by default.
Custom attributes
Custom attributes are defined by the user and can be added to products or carts.
Attribute types
- Boolean: Simple true/false values
- Integer: Whole numbers
- Decimal: Numbers with decimal points
- Money: Currency amounts
- Exact String: Text that must match exactly
- Wildcard String: Text that can contain specific patterns
- Single Membership: Contains one identifier string
- Multi Membership: Contains multiple identifier strings
Project settings
Supported currencies
List of currencies that promotions can apply to. Currency codes must comply with ISO 4217.
Cart limits
- Cart Item Limit: Maximum number of unique items allowed in an order
- Coupon Limit: Maximum number of coupon codes allowed in an order
- Shipping Method Limit: Maximum number of shipping methods allowed in an order
Shipping methods
Configuration of available shipping methods and their display labels, used for shipping-related promotions.
Integration features
Integration types
- Full Integration: Connects your store with Deducto to enable promotions and be able to search products within the Deducto Dashboard.
- Search-Only Integration: Enables product searching and filtering within the dashboard.
Shopify integration
- Store Domain: The domain of your Shopify store (e.g., your-store-name.myshopify.com)
- Metafields: Custom fields that can be linked to Deducto attributes
WooCommerce integration (coming soon)
- Global Attributes: Attributes defined across the entire store, shared among products
- Custom Attributes: Attributes defined on individual products, limited to specific items
Search index configuration
Settings that define how Deducto connects with search providers (Algolia/Typesense) to enable product searching and filtering within the dashboard.
Search index configuration types
- Value-based Search: Provides auto-completed values when setting up promotions. The exact value is saved and used in the promotion.
- ID-based Search: Uses Deducto's Entity Searcher to find and include entities in promotion logic. The entity's ID is stored, allowing updates to other fields without affecting the promotion.
Attribute mapping
Links between Deducto's attributes and your store's data structure, ensuring proper data flow between systems.
Account features
Organisation management
- Legal Name: Official business name used on invoices
- Business Email: Primary contact email and invoice identifier
- Region: Geographic location where infrastructure is set up
Plan tiers
- Free: Entry tier for getting started with Deducto
- Lite: For growing stores with higher API and team requirements
- Pro: For higher-volume stores running more complex promotion programs
Specific quotas (API request allowance, active promotions, users, projects) for each tier are listed on the pricing page and surface inside Deducto's account settings. For Shopify-billed projects the tiers carry their own per-project quotas – see the Shopify integration guide.
API usage
- API Requests: Used by ecommerce frontend and backend to verify and record promotions
- Request Limits: Vary by plan tier with additional requests billed at different rates
- Webhooks: Integration points for connecting external systems
User management
Access control
- Account-Level Permissions: Apply to all projects in the account
- Project-Specific Permissions: Fine-grained access control for individual projects
- User Invitations: System for adding new users to the organisation
Billing and usage
Usage tracking
- API Request Count: Number of verification and recording calls made
- Active Promotions: Count of currently active promotional campaigns
- Coupon Usage: Tracking of coupon redemptions and limits
Billing features
- Monthly Subscription: Regular billing cycle for plan charges
- Additional Usage: Charges for API requests beyond plan limits
- Standard PDF Invoice: Documentation of charges and usage
Deducto Dashboard pages
Project list page
This page shows all projects in your Deducto account that you have access to.
Promotion list page
This page shows all promotions for the current project. You can navigate to this page by clicking on the project ID from the Project List Page.
Promotion view page
The page you see when you click on the name of a promotion from the Promotion List Page. This page shows the details and configuration of a single promotion. It also contains tabs for usage and coupon details of the promotion.
Promotion edit page
The page you see when you click on the "Edit" button from the Promotion View Page, or the "Edit" icon of a promotion on the Promotion List Page. This page shows the configuration details of a single promotion, such as trigger conditions or promotion action.
Updated 9 days ago