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
Every promotion has one of three types, set when it's created. See Creating a Promotion.
Product deal
Discounts chosen products in the cart, which may or may not be the entire contents. Product deals are considered first.
Whole-order deal
Applies to the cart as a whole, such as an amount off the order, free shipping or a free gift. Whole-order deals are considered after product deals.
Final deal
Like a whole-order deal, but always considered last, and still applies when an earlier promotion stops other promotions from applying. Final deals can only discount shipping or add a free item, so they don't change the cart's subtotal.
Promotion components
Order conditions
Rules that decide whether a cart is eligible for the promotion, such as "spend at least $100" for a free shipping promotion.
Product sets
The groups of items a product deal works with. Each set has item conditions that decide which products belong to it and the number of items needed to fill it. Only sets marked This set gets the discount are discounted.
Reward
What the customer gets when the promotion applies, such as a percentage off, an amount off, free shipping or a free item. Each promotion has one reward.
How many times per cart?
Limits how often a product deal can apply within a single cart.
Excluded items
Item conditions on a whole-order deal's amount off that keep matching items out of the discount, such as items already on sale.
Promotion flow control
After this promotion applies
Decides how a promotion works with the ones considered after it.
Keep checking other promotionsmoves on to the next promotion in order.Stop — don't apply anything elseskips the product deals and whole-order deals considered after this one. Final deals can still apply.Only this promotion appliesmoves the promotion ahead of every promotion without this setting. Once it applies, no other product deals or whole-order deals apply, but final deals still can.
Final deals always keep checking other promotions.
Don't let other promotions discount these items again
When turned on, the items a product deal uses, both the discounted items and the items that qualified the cart, can't be used by product deals considered later. Whole-order deals that take an amount off the order can still include them.
Coupon features
Needs a coupon code?
When turned on, customers must enter one of the promotion's coupon codes to get it.
Usage limits
How many times can it be used in total? limits uses across all orders. On a promotion that needs a coupon code, it becomes How many times can each code be used? and applies to each code separately. How many times per customer? limits uses per customer, identified by email address.
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
The kind of value an attribute holds, which decides the comparisons conditions can make with it:
Text (exact match)holds text that must match exactly.Text (pattern match)holds text that can also be matched by part, such as "starts with".One value from a setholds a single ID, such as a brand ID.Several values from a setholds a list of IDs, such as category IDs or tags.Money amountholds an amount in a currency.Whole numberholds a number without decimals.Decimal numberholds a number with decimals.Yes / noholds a true or false value.
See Attributes.
Project settings
Supported currencies
List of currencies that promotions can apply to. Currency codes must comply with ISO 4217.
Promotion limits
Per-cart ceilings the checkout API enforces. You can change Cart items per evaluation (cart lines, not item quantities) and Shipping methods per cart in project settings. There's also a limit on coupon codes per cart, which isn't shown in settings. A request over any of them fails without evaluating promotions. See Before evaluation.
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 Console.
- Search-Only Integration: Enables product searching and filtering within the Console.
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 Console.
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 Console pages
Project list page
This page shows all projects in your Deducto account that you have access to.
Promotions list
Shows all promotions for the current project. Open Promotions in your project to see it. It's sorted by Evaluation order by default, which shows the order promotions are considered in.
Promotion page
Opens when you click a promotion in the promotions list. It shows the promotion's summary, usage and version history, and lets you edit, duplicate or delete it. Promotions that need coupon codes also have a Coupons section, opened with Manage coupons.
Promotion builder
The single-page form you use to create or edit a promotion, with sections for what customers get, when the promotion applies, which products it covers, limits and advanced settings. See Creating a Promotion.
Updated 11 days ago