Marqo Cloud Feature Glossary
A reference of all features across the Marqo Cloud platform, organized by product area with a focus on the Ecommerce Platform.
Accounts
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Account Initialization | One-time account setup that creates default configs for index creation, doc ingestion, search, and collections. Configurable per account via POST /api/v1/account/init. | Ecom API Docs | Deprecated |
(/account/init will be moved to the Admin Service)
Indexes
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Index Creation | Creates a new ecom index with a specified model type (ecommerce, fashion, text). Settings derived from account-level create_index_config, including collapse field and infra sizing. | Ecom API Docs | Live |
| Index Settings | Per-index configs (search_config, collections_config, add_docs_config) stored in DDB and synced to Cloudflare KV via the Settings Exporter Lambda. | Ecom API Docs | Live |
| Default Search Config v2 | Per-index search behavior settings (SKU field, out-of-stock handling via filter/deboost/none, stock availability field, relevance modes for search and sort) with automatic score modifier resolution across all tiers. | — | Live |
| Index Reset | Deletes all docs and returns an index to a clean state by recreating the underlying Vespa index with the same settings, avoiding stale graph structure from incremental deletes. | Ecom API Docs | Live |
| Collections API | Account-level collection metadata management at /api/v1/collections, supporting display names and arbitrary KV metadata. Shared across indexes within an account. | Ecom API Docs | Live |
Indexing
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Async Indexing Pipeline | Document writes are asynchronous: the API records requests to S3, enqueues an SQS message, and a Lambda worker processes them into Marqo index writes. Returns a job ID for tracking. | Ecommerce Platform | Live |
| Indexer Auto Scaling | Dynamic scaling of indexer Lambda concurrency based on an index's provisioned inference resources, balancing indexing throughput against search performance. | Indexer Auto Scaling | Live |
| Indexer Pipelining | Advanced batching and throughput strategies for the indexing pipeline, including continuous SQS polling, intelligent job merging, and configurable FIFO vs standard queue behavior. | Indexer Pipelining | In development |
| Merchandising Fields | The indexer generates hidden internal fields on docs (e.g., _merch_brand) that enable score-modifier-based boosting of products by field value. Configured via add_docs_config. | Ecommerce Platform | Live |
| Merchandising Transforms | Computed fields stored at indexing time (e.g., log of price, percentage discount, title length) that enable complex merchandising rules beyond simple string matching. | Ecommerce Platform | Live |
| Fitment Enrichment | Enriches product documents with structured vehicle compatibility data (type/year/make/model) from uploaded fitment and keyword CSVs during indexing. Can auto-PATCH into Marqo indexes. | Fitment | Live |
| Lexical Enrichment | Language-specific lexical analysis applied during indexing to improve search quality for non-English catalogs (e.g., Finnish compound word decomposition). Configurable per-index via LexicalEnrichmentConfig and exported to KV for search-time use. | — | Rolling out |
Retrieval
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Search | Hybrid (tensor + lexical) product search via /api/v1/indexes/{index}/search. Supports facets, filters, score modifiers, and product-level collapse. | Ecom API Docs | Live |
| Collections Browse | Retrieves products within a named collection via /api/v1/indexes/{index}/collections, applying a filter on the collection membership field. | Ecom API Docs | Live |
| Public Query Endpoints | Read-only search and collections endpoints callable without an API key by providing an x-marqo-index-id header, suitable for direct use from public storefronts. | Ecom API Docs | Live |
| Recommendations | Multiple recommendation endpoints: Similar products, Complementary products, Search Suggestions (typeahead), and For You (personalized). | Ecom API Docs | Live |
| Composite Search | Multi-query search endpoint (/composite-search) that executes multiple search requests in parallel and returns combined results in a single response. | — | Live |
| Groups | Grouped search endpoint (/groups) that clusters results by a field value, returning representative hits per group for faceted browsing. | — | Live |
| Get Documents | Retrieve specific documents by ID from the index (/get-documents), bypassing search ranking. | — | Live |
| Search Redirects | Redirects users to specific URLs based on query matching. Checked in parallel with search so redirects add zero latency to non-matching queries. | — | Live |
| AI Image Detection | Visual search capability allowing image-based product discovery. | Ecom API Docs | Live |
| Variant Color Swatches | Search results include sibling variant details (images, names, URLs) for color swatch display on product cards, enabling customers to browse variants inline. | Ecom API Docs | Live |
| Fitment Hierarchy | Serves a precomputed vehicle hierarchy tree for cascading year/make/model dropdown UIs on storefronts. | Fitment | Live |
| Instant Search | Search-as-you-type experience on storefronts with immediate result previews on each keystroke, replacing static search pages with a dynamic overlay. | — | Live |
| Personalisation | Personalized search results based on tracked user behavior (clicks, ATCs, purchases) within a session, with configurable event types and cooldowns. | Ecommerce Platform | Rolling out |
Agentic
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Agentic Search | AI-powered search that intercepts queries to provide LLM-generated summaries, category search suggestions, and streaming results alongside standard search hits. | Agentic Configurability | Live |
| Conversational Search | Multi-turn chat interface (/converse) that maintains conversation history and context across follow-up queries with the product catalog. | Agentic Configurability | Live |
| Agentic Image Upload | Allows end users to upload images as part of agentic search queries. Images stored in Cloudflare R2 and resolved concurrently with the initial search for non-blocking multimodal LLM prompts. | Agentic Image Upload | In development |
| Chat Suggestions | AI-generated follow-up questions displayed on product pages, prompting users to ask about specific product attributes via the conversational interface. | Agentic Configurability | Live |
| Conversation Starters | AI-generated initial prompts shown when a user opens the chat interface, seeded from the product catalog to encourage engagement. | Agentic Configurability | Live |
| Review Summaries | AI-generated summaries of product reviews, stored per-product and served via CRUD endpoints for display on product pages. | Agentic Configurability | Live |
| Conversation Management | Persistent conversation history with endpoints to list, retrieve, and provide feedback on past conversations. | Agentic Configurability | Live |
| Help Center Search | Indexes customer help center content and surfaces it via agentic search, enabling the conversational interface to answer support questions alongside product queries. | — | Live |
| Agentic Configurability | Self-serve UI for customers to customize agentic behavior: store identity, personality/tone, search settings, conversation persistence, and product page features. | Agentic Configurability | In development |
Merchandising
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Query Configs | Per-query search configuration overrides stored in DDB and synced to Cloudflare KV. Looked up via XOR filter and shard-based caching for sub-millisecond warm-path latency. | Ecom API Docs | Live |
| Synonym Substitution | Replaces query terms with configured synonyms before executing search and composite search queries, broadening recall without requiring lexical expansion rules. | — | Live |
| Lexical Query Expansion | Appends additional terms to the lexical component of hybrid search queries for specific queries, improving recall for known shorthand or synonyms. | Lexical Expansion | Live |
| Query Quoting | Force-quotes search queries for exact lexical matching with multiple modes (phrase, token, tokens_except_first/last). Separates the execution query from the base query used for score modifier lookup. | Query Quoting | Rolling out |
| Rules-Based Query Matching | Pattern-based query config matching (contains, startswith, endswith, regex) evaluated before exact-match lookup. Supports redirect to existing configs or inline overrides, with priority-based ordering. | Rules-Based Matching | In development |
| Recency Boost | Per-index recency-field configuration that applies a linear score adjustment based on a Unix-timestamp field. Supports per-trigger and global days-before/after controls, ranking-phase application, and subquery propagation. | Default Search Config v2 | Live |
| Geolocation Personalisation | Boosts products popular in the searcher's region. Search requests accept an optional geoLocation (country + region); the analytics pipeline writes per-doc geo aggregate maps (_pixel_geo_*_counts) that resolve at search time via {{geoLocation}} score modifier placeholders. Location-blind callers are unaffected. | CP-2105 | Live |
| Reinforcement Learning | AI-driven ranking toggle that uses pixel interaction data (clicks, ATCs) as score modifiers. Can be enabled/disabled globally or per-context (search vs collections), with per-trigger overrides. When disabled, pixel-prefixed score modifiers are stripped before reaching Marqo. | — | Live |
| Search Profiles | Per-profile merchandising rule overrides, allowing different ranking rules for different user segments (e.g., new vs returning customers). Profile-scoped rules stored alongside default rules with automatic fallback to defaults when no profile override exists. | — | Rolling out |
| Rule Testing | A/B testing for merchandising rules, allowing side-by-side comparison of rule variants on a fraction of traffic to measure impact before full rollout. | — | Live |
| Rule Scheduling | Time-based activation and deactivation of merchandising rules for planned promotions and seasonal campaigns. | — | In development |
Event Tracking
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Pixel Tracking | Tracks end-user interactions (search, click, add-to-cart, purchase) on customer storefronts via multiple methods: Direct API, GTM, Shopify Web Pixel, or Custom JS (Pixel Platinum). | Ecommerce Pixel | Live |
| Pixel Account Management | CRUD endpoints for pixel tracking accounts (/pixels), linking pixel accounts to indexes and managing their configuration. | — | Live |
| Pixel Optimization | Aggregates Pixel click/ATC counts over 1/3/7-day windows (global and per-query/collection) into _pixel_*_count fields on docs, then applies optimized score modifiers at search time. | Ecommerce Platform | Live |
QA
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Canary Test Framework | Pre-deployment testing of ecom index config changes against real customer data, with a proposal/diff/test/deploy workflow in the Admin Console and a pytest-based test runner. | Canary Tests | In development |
| Monitoring & Alarms | CloudWatch metrics (request count, latency) and alarms (4XX/5XX error rates, success rate, queue backlog) for the ecom API search and indexing paths. | Ecommerce Monitoring | Live |
| Pixel Data Quality Monitoring | Monitors pixel event attribution rates per customer and fires Grafana alerts when rates drop below thresholds or change by more than expected, catching integration regressions before they impact search ranking. | — | Live |
| Metrics Webhooks | Customer-facing metrics about Marqo's performance for their account, pushed to registered HTTPS endpoints with HMAC-SHA256 signed payloads. Configurable metric sets (request latency, index stats, jobs) and cadence. | — | Live |
Platform Integrations
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Shopify App | Self-serve Shopify App that creates a Marqo index on install, bulk-indexes the product catalog via GraphQL Bulk Operations, keeps it fresh with webhooks, and swaps native search/collection UI. | Design Doc v3 | Live |
| Shopify Storefront Search | Custom search and collection UI elements injected into the Shopify storefront via Liquid templates and metafields, replacing native Shopify search. | Design Doc v3 | Live |
| Shopify Web Pixel | Event tracking integration where customers paste JS into their Shopify store's web pixel settings to capture search, click, ATC, and purchase events. | Ecommerce Pixel | Live |
| Subcollections | Marqo-powered subcollection navigation on parent collection pages, automatically generating child collection links based on indexed product data. | — | Live |
| Storefront Admin | Customer-facing UI (React Router on Cloudflare Workers) for customizing the Marqo search widget on their storefront. Covers 18 settings sections: layout, filters, sorting, product display, CTA, pagination, reviews, wishlist, stock display, swatches, instant search, promo messages, grid injections, subcollections, collection page, integrations, selectors, and custom CSS. | — | In development |
| Collection Page Overrides | Per-collection customization of storefront layout, allowing different page structures, headers, and widget configurations for specific collections. | — | Rolling out |
Operations
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Reindexing | Procedures for rebuilding an index from source data, including full reindex via Shopify bulk sync or ecom API replay. | Ecom Runbook | Live |
| Write Forking | Duplicates index write operations to a secondary index for migration, A/B testing, or model comparison without interrupting production traffic. | Ecom Runbook | Live |
| Sync Jobs API | List, monitor, and cancel async indexing jobs with status filtering, time range queries, and aggregated progress stats. Supports per-job detail views including error breakdowns. | — | Live |
| Queue Redrive | Replays failed or stuck SQS messages through the indexing pipeline after resolving the underlying issue. | Ecom Runbook | Live |
Admin
Internal staff dashboard (admin_worker — React Router on Cloudflare Workers) backed by an API layer (admin_lambda — FastAPI on AWS Lambda). Provides operational controls over the platform, exposing many features listed in other sections alongside admin-specific tooling.
| Feature | Summary | Details | Lifecycle |
|---|---|---|---|
| Search Testing | Multi-scenario search comparison UI for sending queries across indexes with side-by-side result inspection, configuration overrides, debug payloads, and tabs for search, collections, recommendations, and document retrieval. | — | Live |
| A/B Testing Dashboard | Analytics dashboard for merchandising experiments showing overview metrics, funnel analysis (searches → clicks → ATCs → purchases), time series charts, and statistical comparisons across variants. | — | Live |
| Onboarding | Workflow for creating and configuring new customer onboarding records, setting up initial index and account state. | — | Live |
| Index Export / Import | Exports full index metadata (configs, aliases, feature flags, pixel ID, query configs, redirects, merchandising, agentic config) to JSON and imports it to target indexes for cloning or migration. | — | Live |
| Index Infrastructure | View and manage per-index infrastructure resources, Lambda ESM concurrency limits, SQS queue depth, and deployment info (git SHAs per region). | — | Live |
| Monitoring Logs | CloudWatch log viewer scoped to ecommerce Lambdas with region-aware log retrieval. | — | Live |
| Query Config Management | Admin CRUD for merchandising query configs and recommendation configs, including batch operations and cached agentic query management. | — | Live |
| Agentic Config Management | Admin CRUD for default and channel-scoped agentic search configurations with effective config preview (default + channel merge). | — | Live |