1. Help Center
  2. Brilliant - AI Assistant
  3. Initial setup

How to Install Brilliant

Created
Updated
Follow

In this article, you will learn how to install Brilliant in your store, activate the initial connection, and verify that all elements work correctly before you start selling with AI.

 

1. Prerequisites

Before starting, make sure you meet the following to avoid errors during the process:

  • Have an active store on the Shopify platform.
  • Have administrator permissions or sufficient permissions to install apps within your control panel.

 

 

2. Installation from the Marketplace

To add Brilliant to your ecommerce, follow these steps:

 

  • App location:

    Access your Shopify panel, go to the Apps section, and select Shopify App Store.

 

  • Search:

    Type "Brilliant AI assistant" in the app store search bar.

    Captura de pantalla 2026-03-26 a las 10.48.41.png

 

  • Installation:

    Click the Install button. Shopify will redirect you to a screen detailing the required permissions. Click Install again to accept and complete the connection.

 

 

3. Initial Setup After Installation

Once the installation is confirmed, access Brilliant from your list of apps in Shopify to enter the backoffice.

 

 

Recommended First Steps

  • Agent creation:

    Start creating the agent so the AI can analyze your catalog. This process is automatic but may take several hours depending on the number of products. You can continue using your store normally in the meantime.

 

  • Agent activation:

    Once the catalog is processed, make sure to mark the agent as Active in the control panel.

 

  • Enable the widget in the theme:

    To make the assistant visible, go to Online Store / Themes / Customize. In the App Embeds section, activate the Brilliant toggle and save the changes.

 

  • Show Brilliant contextual action buttons on product cards:

    Once you have activated the Brilliant widget in the theme, besides displaying the main Brilliant button in the bottom corner of the screen, contextual action buttons should also start appearing on the product cards of your website. 



    If this does not happen, it is because one of the following cases applies:

     

    1. You are using a public Shopify theme without code modifications. If you do not see the contextual action buttons on your product cards and you are using a public Shopify theme, it is because Brilliant has not yet added support for that theme. If this is the case, please contact us at support@getbrilliant.ai indicating your ecommerce domain and the name of the public theme you are using. Our developers will update Brilliant's support for your theme with top priority.

       

    2. You're using a public Shopify theme with code modifications, or you're using a custom private theme. If this is the case, you'll need to add a small piece of HTML code to your theme so that Brilliant can display the context-sensitive action buttons on the product cards. The code you need to add to each product card is `data-bri-product-card data-bri-product-id=“product ID”`. In Shopify Liquid code, you’ll typically need to write something like this: `data-bri-product-card data-bri-product-id=“{{ product.id }}”`.
    3. You’ll need to add this to every product card where you want to display the Brilliant context menu button. Typically, you’ll have a file named `product-card.liquid` or similar, and this component is reused across various page types—such as the homepage, products in a collection, search results, etc.—so you’ll only need to add this code to that file, and it will automatically apply to your entire theme. The code above is an HTML attribute that you need to add to the parent DOM element that contains each product card.
    4. Except in very rare cases, you should be able to place this code within an existing HTML element in your theme; in other words, you shouldn’t need to create a new element with this attribute to wrap the entire product card.


 

  1. Translated with DeepL.com (free version)

  2. The goal is to generate code similar to the following:

    <body>
...
    <div class="my-theme-product-card" data-bri-product-card data-bri-product-id="86461581684">
    ... inner html of this product card
    </div>
...
    <div class="my-theme-product-card" data-bri-product-card data-bri-product-id="95168765168">
    ... inner html of this product card
    </div>
...
    <div class="my-theme-product-card" data-bri-product-card data-bri-product-id="21564846848">
    ... inner html of this product card
    </div>
</body>

 

 

  • Style customization:

    On the Brilliant management page, go to Settings / General Styles and adjust the colors and typography so the assistant resembles your store as closely as possible:
     

 

 

4. Functionality Checks

To verify that the installation was successful, browse your store and check the following elements:

 

  • Floating button: The Brilliant activation button should appear in the corner of your website.

 

  • Product Cards: You should see the smart chips or tags integrated into the product cards.

 

  • Interaction: Ask the assistant a question and verify that the answers are correctly generated based on your catalog.

 

Want to know more?