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.