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 promotions moves on to the next promotion in order.
  • Stop — don't apply anything else skips the product deals and whole-order deals considered after this one. Final deals can still apply.
  • Only this promotion applies moves 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 set holds a single ID, such as a brand ID.
  • Several values from a set holds a list of IDs, such as category IDs or tags.
  • Money amount holds an amount in a currency.
  • Whole number holds a number without decimals.
  • Decimal number holds a number with decimals.
  • Yes / no holds 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.


Did this page help you?