# Glood.AI: AI-Powered Commerce Solutions

- [Welcome to Glood.AI](https://docs.glood.ai/introduction.md): AI-powered commerce solutions for Shopify Plus stores
- [Release History](https://docs.glood.ai/releases.md): Track the evolution of Glood.AI through our release timeline
- [Introduction to Glood.AI](https://docs.glood.ai/get-started/introduction.md): Welcome to Glood.AI - The AI-powered Personalized Recommendation Engine for Shopify Plus stores
- [Activate Glood.AI](https://docs.glood.ai/get-started/activate-glood-store.md): Enable Glood.AI recommendations on your Shopify store
- [Personalized Recommendations](https://docs.glood.ai/features/ai-personalized-recommendations.md): Drive more sales with intelligent product recommendations tailored to each shopper
- [AI Upsell Bundles](https://docs.glood.ai/features/ai-upsell-bundles.md): Boost sales with intelligent product bundles and upsell recommendations
- [Upsell Promotions](https://docs.glood.ai/features/upsell-promotions.md): Drive AOV with two new promotion types — Product Upsell (Buy X Get Y) and Free Gift on cart value — surfaced on PDP and in the cart drawer.
- [Images and Embeds](https://docs.glood.ai/features/checkout-upsell.md): Add image, video, and other HTML elements
- [AI Search & Merchandising](https://docs.glood.ai/features/ai-search-merchandising.md): Optimize your store search and product placement with AI-powered merchandising
- [Navigation](https://docs.glood.ai/features/discounts.md): The navigation field in mint.json defines the pages that go in the navigation menu
- [Upsell Offers](https://docs.glood.ai/upsell-offers/introduction.md): Drive average order value with merchant-controlled upsell offers — pick offers (Buy X Get Y) and free-gift offers (cart-value tiers) — surfaced on PDP, in the cart drawer, and on the cart page.
- [Enable the Upsell Section](https://docs.glood.ai/upsell-offers/activate.md): Turn the Upsell Offers feature on in your Shopify theme — app embed activation, block placement on PDP and cart, and verifying the integration.
- [Guides Overview](https://docs.glood.ai/guides/introduction.md): Comprehensive guides for implementing and customizing Glood.AI in your Shopify store
- [How to enable glood integration v3](https://docs.glood.ai/guides/quick-start/how-to-enable-glood-integration-v3.md)
- [Create First Personalized Recommendations Section](https://docs.glood.ai/guides/quick-start/create-first-personalized-recommendations-section.md): Learn how to add AI-powered product recommendations to your Shopify store
- [Custom Web Pixel Events](https://docs.glood.ai/guides/quick-start/glood-custom-web-pixel-events.md): Learn about the custom Web Pixel events supported by Glood.AI
- [Table for Supported sections X Pages](https://docs.glood.ai/guides/create-sections/supported-sections-X-pages.md)
- [How to Create Frequently Bought Together Section](https://docs.glood.ai/guides/create-sections/how-to-create-fbt-section.md)
- [How to create Similar Products Section](https://docs.glood.ai/guides/create-sections/how-to-create-similar-products-section.md)
- [How to create Cross Sell section](https://docs.glood.ai/guides/create-sections/how-to-create-cross-sell-section.md)
- [How to create Recently Viewed section](https://docs.glood.ai/guides/create-sections/how-to-create-recently-viewed-section.md)
- [How to create Trending section](https://docs.glood.ai/guides/create-sections/how-to-create-trending-section.md)
- [How to create Bestsellers section](https://docs.glood.ai/guides/create-sections/how-to-create-bestsellers-section.md)
- [How to create Personalized for You section](https://docs.glood.ai/guides/create-sections/how-to-create-pfy-section.md)
- [How to create Recent Launch section](https://docs.glood.ai/guides/create-sections/how-to-create-recent-launch-section.md)
- [How to create Collections Widget section](https://docs.glood.ai/guides/create-sections/how-to-create-collection-widget-section.md)
- [How to create Slot Based Recommendation section](https://docs.glood.ai/guides/create-sections/how-to-create-slot-based-recommendation-section.md)
- [How to create Promoted Products section](https://docs.glood.ai/guides/create-sections/how-to-create-promoted-products-section.md)
- [Add Sections to Mini Cart](https://docs.glood.ai/guides/cart-upselling/add-sections-to-mini-cart.md): This guide walks you through the process of adding Glood.AI product recommendations to your store's mini cart (also known as AJAX cart).
- [Open Mini Cart on Add to Cart](https://docs.glood.ai/guides/cart-upselling/open-mini-cart-on-add-to-cart.md): Learn how to enable the mini cart to automatically open when clicking the add to cart button
- [Deep theme integration](https://docs.glood.ai/upsell-offers/deep-theme-integration.md): Wire the PDP upsell panel and the mini-cart carousel into a Shopify default-theme fork (Dawn / Sense / Studio). Covers deferred-render mode, variant-change re-anchoring, atomic add-to-cart commit, and mini-cart hydrate.
- [How to Create Bundles](https://docs.glood.ai/guides/bundles/how-to-create-bundle.md)
- [Add Checkout Upsell on Checkout Screen](https://docs.glood.ai/guides/checkout/add-checkout-upsell.md)
- [Add Checkout Upsell on Post Checkout Screen](https://docs.glood.ai/guides/checkout/add-checkout-upsell-post-checkout.md)
- [Editing Checkout Upsell Styling](https://docs.glood.ai/guides/checkout/edit-checkout-upsell-styling.md)
- [How to access additional metafields in V3 Template](https://docs.glood.ai/guides/customization/access-additional-metafields.md): Learn how to access and use additional metafields in your V3 Template implementation
- [Enable Custom Events in V3 Template](https://docs.glood.ai/guides/customization/enable-custom-events.md): Learn how to enable and configure custom events to control section visibility on your store
- [Enable Swatch in V3 Template](https://docs.glood.ai/guides/customization/enable-swatch-v3-template.md): Learn how to enable and configure swatch functionality in your v3 template
- [Enable Labels on Store](https://docs.glood.ai/guides/customization/enable-labels.md): Learn how to configure and enable product labels in your store
- [Set Default Variant in Variant Selector](https://docs.glood.ai/guides/customization/how-to-set-default-variant.md): Learn how to configure the default variant selection in your product templates
- [How to Exclude Products and Tags from Recommendations](https://docs.glood.ai/guides/product-filtering/how-to-exclude-products-and-tags.md)
- [How to Disable Products and Tags from Recommendations](https://docs.glood.ai/guides/product-filtering/how-to-disable-products-and-tags.md)
- [Filter by Sales Channel](https://docs.glood.ai/guides/product-filtering/filter-by-sales-channel.md): Return only products published on specific Shopify sales channels, such as Point of Sale or a headless storefront.
- [Recommendation Analytics](https://docs.glood.ai/guides/analytics/recommendation-analytics.md): Complete guide to understanding recommendation performance metrics and attribution
- [Checkout Analytics](https://docs.glood.ai/guides/analytics/checkout-analytics.md): Comprehensive guide to checkout upsell performance metrics and optimization
- [How Glood.AI Works](https://docs.glood.ai/how-it-works/introduction.md): Understanding the AI-powered recommendation engine architecture and data flow
- [How Personalization Works](https://docs.glood.ai/how-it-works/personalization.md): How Glood.AI turns everyday shopper behavior into personalized experiences across recommendations, search, collections, email, and checkout
- [Glood.AI's Recommendation Engine](https://docs.glood.ai/how-it-works/recommendations/introduction.md): Inside Glood.AI: How our proprietary algorithms and dashboard controls create perfect recommendations
- [Glood Personalized For You (PFY)](https://docs.glood.ai/how-it-works/recommendations/personalized-for-you.md): How Glood.AI creates hyper-personalized recommendations for each customer
- [Glood Frequently Bought Together (FBT)](https://docs.glood.ai/how-it-works/recommendations/bought-together.md): How Glood.AI discovers and manages product bundles to maximize cart value
- [Glood Similar Products](https://docs.glood.ai/how-it-works/recommendations/similar-products.md): How Glood.AI finds perfect alternatives with visual and semantic matching
- [Glood Trending Products](https://docs.glood.ai/how-it-works/recommendations/trending-products.md): How Glood.AI identifies and surfaces trending items in your store
- [Glood.AI's Bundle Engine](https://docs.glood.ai/how-it-works/bundles/introduction.md): Inside Glood.AI: How our AI creates intelligent product bundles that drive higher AOV
- [GDPR Compliance](https://docs.glood.ai/legal/gdpr-compliance.md): Understanding how Glood.AI protects European users' data and ensures GDPR compliance
- [CCPA Compliance](https://docs.glood.ai/legal/ccpa-compliance.md): Learn how Glood.AI protects your privacy while powering personalization in compliance with CCPA
- [Data Processing Agreement](https://docs.glood.ai/legal/data-processing-agreement.md): Standard Data Processing Agreement for Glood.AI services under GDPR
- [AI Search & Merchandising](https://docs.glood.ai/ai-search-merchandising/index.md): Intelligent search and merchandising for Shopify stores
- [Get Started](https://docs.glood.ai/ai-search-merchandising/get-started.md): Get started with Glood AI Search & Merchandising
- [Enable Edge Delivery](https://docs.glood.ai/ai-search-merchandising/enable-edge-delivery.md): Serve storefront search from an edge region close to your shoppers for faster results.
- [Filter by Sales Channel](https://docs.glood.ai/ai-search-merchandising/filter-by-sales-channel.md): Return only products published on specific Shopify sales channels, such as Point of Sale or a headless storefront.
- [Configure Collection-Level Default Sorting](https://docs.glood.ai/ai-search-merchandising/configure-collection-default-sorting.md): Override the shop-wide default sort order for individual collections.
- [FAQ](https://docs.glood.ai/ai-search-merchandising/faq.md): Frequently asked questions about Glood AI Search & Merchandising
- [Changelog](https://docs.glood.ai/ai-search-merchandising/changelog.md): Release notes and updates for Glood AI Search & Merchandising
- [AI Image & Video Editor](https://docs.glood.ai/ai-image-video-editor/index.md): Intelligent image and video editing for Shopify stores
- [Get Started](https://docs.glood.ai/ai-image-video-editor/get-started.md): Get started with Glood AI Image & Video Editor
- [FAQ](https://docs.glood.ai/ai-image-video-editor/faq.md): Frequently asked questions about Glood AI Image & Video Editor
- [Changelog](https://docs.glood.ai/ai-image-video-editor/changelog.md): Release notes and updates for Glood AI Image & Video Editor
- [AI Assistant](https://docs.glood.ai/platform/index.md): Drive your Glood dashboard from Claude, ChatGPT, or any MCP-capable AI assistant
- [Connect your assistant](https://docs.glood.ai/platform/connect.md): Add the Glood MCP server to Claude, ChatGPT, Codex, Gemini CLI, or opencode
- [Connect any MCP client](https://docs.glood.ai/platform/mcp-server.md): The Glood MCP endpoint, its transport, and how authorization works
- [Install the skills](https://docs.glood.ai/platform/skills.md): Two skills that teach your assistant how to operate Glood well
- [Tools reference](https://docs.glood.ai/platform/tools.md): Every tool the Glood MCP server exposes, what it answers, and what it needs
- [Using it](https://docs.glood.ai/platform/using.md): What to ask your assistant for, and how to read the answers it gives back
- [Access and privacy](https://docs.glood.ai/platform/access-and-privacy.md): What a connection can reach, what it refuses, and how to revoke it
- [Troubleshooting](https://docs.glood.ai/platform/troubleshooting.md): What went wrong, what it means, and what to do about it
- [Developer Guide](https://docs.glood.ai/for-developers/introduction.md): Advanced integration guide for developers implementing Glood.AI
- [Upsell Blocks — Theme Integration & JS Hooks](https://docs.glood.ai/for-developers/upsell-blocks-integration.md): Wire the Glood Upsell PDP and Cart blocks into custom themes, integrate native variant + quantity selectors, and react to selections via the window.Glood.upsell pub/sub bus.
- [Upsell Offers — JS Triggers](https://docs.glood.ai/for-developers/upsell-offers-js-triggers.md): Complete reference for the storefront JS surface — every event the upsell panel publishes, every callback you can register, and the patterns for driving the panel from theme code.
- [How to reload mini cart sections using javascript](https://docs.glood.ai/for-developers/how-to-reload-mini-cart-sections-using-javascript.md)
- [Load a Section into a Custom Location](https://docs.glood.ai/for-developers/how-to-load-a-section-into-a-custom-location.md): Use window.glood.loadSection to render a single recommendation section into any element — including DOM that does not exist when the page loads, such as a modal injected on trigger.
- [Introduction](https://docs.glood.ai/for-developers/section-template/introduction.md): Learn about section templates in Glood.AI
- [Schemas](https://docs.glood.ai/for-developers/section-template/schemas.md)
- [Code](https://docs.glood.ai/for-developers/section-template/code.md): Learn about the core components of a section template
- [Filters](https://docs.glood.ai/for-developers/section-template/filters.md): Reference for custom Liquid filters available in section templates
- [Tags](https://docs.glood.ai/for-developers/section-template/tags.md): Learn about available tags for extending section template functionality
- [Hooks](https://docs.glood.ai/for-developers/section-template/hooks.md): Complete guide to hooks in Glood.AI section templates
- [Introduction](https://docs.glood.ai/for-developers/bundles/introduction.md): Learn about bundle templates in Glood.AI
- [Default Template](https://docs.glood.ai/for-developers/bundles/default-template.md): Default bundle Liquid template code reference
- [Default CSS](https://docs.glood.ai/for-developers/bundles/default-css.md): Default bundle CSS template code reference
- [Default JavaScript](https://docs.glood.ai/for-developers/bundles/default-js.md): Default bundle JavaScript hooks code reference
- [Hooks](https://docs.glood.ai/for-developers/bundles/hooks.md): Complete guide to bundle hooks in Glood.AI
- [Settings](https://docs.glood.ai/for-developers/bundles/settings.md): Default bundle settings configuration reference
- [Translations](https://docs.glood.ai/for-developers/bundles/translations.md): Default bundle translations reference
- [Integrations](https://docs.glood.ai/for-developers/integrations/introduction.md): Learn about available integrations for Glood.AI recommendations
- [Wishlist Integration](https://docs.glood.ai/for-developers/integrations/wishlist.md): Learn how to integrate wishlist functionality with Glood.AI recommendations
- [Product Ratings Integration](https://docs.glood.ai/for-developers/integrations/product-ratings.md): Learn how to integrate product ratings and reviews with Glood.AI recommendations
- [Quick View Integration](https://docs.glood.ai/for-developers/integrations/quick-view.md): Learn how to integrate quick view functionality with Glood.AI recommendations
- [Default Translations](https://docs.glood.ai/for-developers/default-code/translations.md): Default translations object reference
- [Default Template Settings](https://docs.glood.ai/for-developers/default-code/settings-json.md): Default Template Settings configuration reference
- [Default Template liquid](https://docs.glood.ai/for-developers/default-code/section-liquid.md): Default Template liquid code reference
- [Default Template CSS](https://docs.glood.ai/for-developers/default-code/css-liquid.md): Default Template CSS code reference
- [Default Template Javascript](https://docs.glood.ai/for-developers/default-code/section-js.md): Default Template Javascript code reference
- [Glood Hydrogen SDK](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/index.md): Complete guide to integrating Glood with Shopify Hydrogen for e-commerce analytics and personalization
- [Installation Guide](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/installation.md): Step-by-step guide to install and set up the Glood Hydrogen SDK
- [Configuration Guide](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/configuration.md): Comprehensive guide to configuring the Glood Hydrogen SDK for different use cases and environments
- [Loading Recommendations](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/recommendations.md): Fetch and display Glood recommendation sections with full product data in your Hydrogen storefront
- [Search & Discovery](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/search.md): Fetch config, run instant + full search, render filters, do image search, and attribute interactions with the Glood Hydrogen Search SDK
- [Content Security Policy Setup](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/content-security-policy.md): Configure CSP to enable Glood pixel tracking and event transmission
- [Collection Page](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/guides/collection-page.md): Render a Shopify collection with facets, sort and pagination using the Glood Hydrogen Search SDK
- [Search Page](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/guides/search-page.md): Build a full search results page — query, facets, sort, pagination and attribution — with the Glood Hydrogen Search SDK
- [Instant Search](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/guides/instant-search.md): Add a type-ahead search box with suggestions, autocorrect and a trending empty state using the Glood Hydrogen Search SDK
- [Image Search](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/guides/image-search.md): Search by an uploaded photo or image URL using the Glood Hydrogen Search SDK
- [Client API](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/client.md): Complete reference for createGlood() function and GloodClient interface
- [React Components](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/components.md): Complete reference for GloodProvider and the useGloodAnalytics, useGloodInit, and useRecommendations hooks
- [App Modules](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/app-modules.md): Complete reference for the recommendations() and search() app modules
- [Recommendations API](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/recommendations-api.md): Complete reference for useRecommendations, the standalone headless functions, and the RecommendationsApp methods
- [Search API](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/search-api.md): Complete reference for useSearch / useInstantSearch / useSearchConfig, the standalone search fetchers, the SearchApp methods, and search attribution events
- [Event System](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/event-system.md): Complete guide to event tracking, transmission, and analytics integration
- [Signatures & Parameters](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/signatures.md): Argument structure for every hook, component, and function exported by @glood/hydrogen, in table form.
- [TypeScript Types](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/types.md): Complete TypeScript interface definitions for the Glood Hydrogen SDK
- [Utilities](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/api-reference/utilities.md): Utility functions for consent management, session bootstrap, the pixel queue, and constants
- [Basic Setup Example](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/examples/basic-setup.md): Complete example of basic Glood Hydrogen SDK setup with minimal configuration
- [Recommendations Example](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/examples/recommendations.md): Complete working example: client-side recommendation sections with attribution tracking
- [Search Example](https://docs.glood.ai/for-developers/glood-hydrogen-sdk/examples/search.md): Complete working example: a custom search page with instant search, results, filters, image search and attribution
- [API reference](https://docs.glood.ai/api-reference/introduction.md): Integrate Glood.AI recommendations and search into any storefront
- [Headless Init](https://docs.glood.ai/api-reference/recommendations/headless/init.md): Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.
- [Get Headless Sections](https://docs.glood.ai/api-reference/recommendations/headless/sections.md): Get recommendation sections with full product details for a given page context.
- [Send Headless Events](https://docs.glood.ai/api-reference/recommendations/headless/events.md): Send tracking events from headless, mobile, or hydrogen storefronts.
- [Get Headless Recommendations using Query](https://docs.glood.ai/api-reference/recommendations/headless/recommendations.md): Fetch recommendations for up to five queries in one call, personalized to the shopper you identify.
- [Get Automatic Recommendations](https://docs.glood.ai/api-reference/recommendations/headless/automatic-recommendations.md): Get automatic recommendations powered using LLMs
- [Get Top Recommendations](https://docs.glood.ai/api-reference/recommendations/headless/top-recommendations.md): Fetch products by a ranking strategy (bestsellers, new arrivals, trending) with rich criteria filters, full-text query, cursor pagination, and facet aggregations.
- [Partner APIs](https://docs.glood.ai/api-reference/recommendations/partners/introduction.md): APIs for third-party integrations and partner platforms
- [Search APIs](https://docs.glood.ai/api-reference/search/introduction.md): Versioned, Bearer-authenticated headless APIs for AI-powered search and discovery
- [Headless Search Init](https://docs.glood.ai/api-reference/search/headless/init.md): Session bootstrap for the search suite. Call once per session (the `@glood/hydrogen` GloodProvider runs it automatically on mount) before instant/full search. Resolves the visitor, returns their history (browsed / cart / purchased product ids), a lean feature-flag config (no filter definitions, no f…
- [Search Config](https://docs.glood.ai/api-reference/search/headless/config.md): Config for all three search features (instant, results page, image) plus filter definitions, filter tree, shop, analytics, translations and the Shopify storefront token. No Liquid templates and no widget css/js. Auth: `Authorization: Bearer <gl_sf_...>` + `x-shop`.
- [Instant Search](https://docs.glood.ai/api-reference/search/headless/instant-search.md): Type-ahead search in a single call: products / collections / pages / articles + keyword suggestions + autocorrect, plus an empty-state trending block. Auth: `Authorization: Bearer <gl_sf_...>` + `x-shop`.
- [Filters](https://docs.glood.ai/api-reference/search/headless/filters.md): DB-driven facet (filter) definitions for the resolved filter tree. No live counts (see filter-aggregations). Auth: `Authorization: Bearer <gl_sf_...>` + `x-shop`.
- [Filter Aggregations](https://docs.glood.ai/api-reference/search/headless/filter-aggregations.md): Live Elasticsearch facet counts for a given query + applied filters. Auth: `Authorization: Bearer <gl_sf_...>` + `x-shop`.
- [Search](https://docs.glood.ai/api-reference/search/headless/search.md): Full product search (hybrid text + vector) with applied facets, sort, page-based pagination and optional inline aggregations. Auth: `Authorization: Bearer <gl_sf_...>` + `x-shop`.
- [Image Search](https://docs.glood.ai/api-reference/search/headless/image-search.md): Visual (image) search. Accepts a multipart file OR a JSON base64 image / data: URL / http(s) image URL (exactly one source). Images are strictly validated before search. Auth: `Authorization: Bearer <gl_sf_...>` + `x-shop`.
- [Send Search Events](https://docs.glood.ai/api-reference/search/headless/events.md): Ingest storefront / personalization events (standard Shopify pixel events and custom `glood:search:*` attribution events). Shop is taken from `x-shop`. Auth: `Authorization: Bearer <gl_sf_...>` + `x-shop`.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

- [Home](https://glood.ai)
- [Install for Free](https://apps.shopify.com/recommendation-kit)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.