Brilliant is the AI sales expert for eCommerce that accompanies your customers throughout the purchasing process to help them find products, answer questions, compare options, and discover related recommendations. It is available in different areas of your website and uses information from your catalog and business to provide assistance tailored to each customer.
In this article, you will learn how to install Brilliant on your Shopify website, complete its initial setup, activate it for your customers, and verify that it works correctly.
Implementation time: 30 min.
Difficulty: Intermediate.
When should you use it?: When installing Brilliant for the first time in your Shopify online store.
Before you begin: prerequisites
To install Brilliant on your Shopify website, you will need:
- An active online store on the Shopify platform.
- Administrator permissions or sufficient permissions to install apps and edit your online store’s theme.
- A theme compatible with Shopify app extensions, such as Online Store 2.0 themes (for example, Dawn).
STEP 1. Installing Brilliant
1. From your Shopify website’s admin panel, go to “Apps > Shopify App Store”.
2. Enter “Brilliant: AI Sales Expert” in the search bar and access the app.
3. Click Install to install it on your Shopify website.
4. Review the permissions Brilliant needs to function and click Install again to accept and complete the installation.
Brilliant uses these permissions to access the information it needs from your store, such as your catalog, languages, markets, content, and orders. See Frequently asked questions about Brilliant for more details about the app’s permissions.
STEP 2. Initial Brilliant setup
(In this section, you will learn how to complete Brilliant’s initial setup and activate it in your Shopify website’s theme.)
5. Once installed, Shopify will redirect you to the Brilliant dashboard. Click Get started to begin the setup.
6. Click Activate in Shopify .
7. When Brilliant detects the activation and enables the button, click Continue installation .
STEP 3. Catalog processing
(In this section, you will learn how to check the progress of your website’s catalog processing and preview Brilliant before activating it for your customers.)
8. After clicking Continue installation , Brilliant will begin processing your catalog.
This process can take anywhere from a few minutes to several hours, depending on the size of your catalog.
If your catalog exceeds the number of products included in your plan, Brilliant will let you know, and you can request priority access to a higher-tier plan.
9. Click Preview to view the preview.
During the preview, only you will be able to see Brilliant. Use it to check its appearance and functionality before activating it for your customers.
STEP 4. Configuring Brilliant in your eCommerce theme
(In this section, you will learn how to configure how Brilliant is displayed in your Shopify website’s theme.)
10. From the Shopify admin panel, go to "Online store > Themes".
11. Find the published theme and click Edit theme.
12. In the top bar, on the left side, go to the App embeds tab.
13. Activate the Brilliant app and configure the following options:
- “Main bubble > Enabled”: activates or deactivates Brilliant’s main bubble on your website.
- “Horizontal position”: selects whether the bubble appears on the left or right.
- “Horizontal margin”: defines the bubble’s horizontal margin.
- “Vertical margin”: defines the bubble’s vertical margin.
- “Z-index”: sets the bubble’s display priority relative to the rest of the website’s elements.
- “Show welcome message”: activates or deactivates the welcome message.
- “Different settings on mobile?”: defines whether you will use different settings for mobile devices.
- “Bubble on product cards > Enabled”: activates or deactivates Brilliant’s bubble on product cards.
- “Horizontal margin”: defines the bubble’s horizontal margin on product cards.
- “Vertical margin”: defines the bubble’s vertical margin on product cards.
14. Click Save to apply the changes.
STEP 5. Recommended Brilliant customization
5.1. Configuring Brilliant’s design
(In this step, you will learn how to customize Brilliant’s design to adapt it to your business’s visual identity.)
15. From the Brilliant dashboard, click Design.
16. In the right sidebar, configure the following options:
- “Colors”: defines your business’s primary color to generate the color palette that Brilliant will use.
- “Buttons”: defines the buttons’ border radius and font transformation (default or uppercase).
- “Fonts”: defines your brand’s font. On your website, it will use the font configured on your website. Modifications do not apply.
-
“Logo”: attaches your brand’s logo.
- “Icons”: defines the icon that will represent Brilliant on your website.
- “Product card”: customizes the style of the product cards displayed by Brilliant.
“Full-screen window”: adjusts the size and corners of the assistant on desktop.
17. Once you have configured the design, click Save to apply the changes.
5.2. Configuring your business profile
(In this section, you will learn how to review the information about your business that Brilliant will use to provide answers and recommendations tailored to your eCommerce store.)
18. From the Brilliant dashboard, go to “Train your AI > Business profile”.
19. Review the description and industry that Brilliant has suggested for your business and complete the information.
20. Click Save to apply the changes.
5.3. Configuring the knowledge base and behavior
(In this section, you will learn how to configure the information and guidelines that Brilliant will use to respond to your customers.)
21. From the Brilliant dashboard, go to “Train your AI > Knowledge base”.
22. Select your website’s blogs and pages or add content that Brilliant can use as an information source.
23. Once configured, go to “Train your AI > Behavior” from the right sidebar.
24. Under Guidelines, define Brilliant’s tone, style, and response format so that they reflect your website’s identity.
The settings must be in your language. Brilliant will adapt its responses to the language of each conversation.
25. Under Response style, define how much detail the response includes and how it is presented in your website’s chat.
26. Click Save to apply the changes.
5.4. Configuring product management
(In this section, you will learn how to define which products from your catalog you want to highlight or exclude in Brilliant.)
27. From the Brilliant dashboard, go to “Catalog > Product management”.
28. Use Shopify tags to configure the products you want to:
- Identify as new arrivals.
- Highlight in searches.
- Exclude from Brilliant so they do not appear in its results and recommendations.
29. Click Save to apply the changes.
5.5. Configuring skills
(In this section, you will learn how to review the Brilliant skills that will be available to your customers.)
30. From the Brilliant dashboard, go to Skills.
31. Under How Brilliant appears in your store , review how Brilliant will be displayed to your customers and configure the available elements:
- “Main bubble”: allows your customers to access the assistant from anywhere on your website to resolve questions and receive help during the purchasing process.
- “Similar products carousel”: displays related alternatives to the product being viewed on the product page, helping customers find other options.
- “Products that go well together carousel”: displays complementary products to the one being viewed on the product page, making it easier to discover related products and helping increase the average cart value.
- “Suggested questions”: displays frequently asked questions about the product being viewed to make it easier to start a conversation with Brilliant.
32. Under Customize your assistant’s skills, review the available capabilities and activate or deactivate the ones you want to use:
- “Smart search”: interprets the customer’s natural language and displays the most relevant products from the catalog.
- “Product analysis”: answers questions about product features, materials, and uses.
- “Similar products”: displays alternatives with a similar style or similar features to the product being viewed.
- “Products that go well together”: recommends complementary items that go well with the product being viewed.
- “Product bundles”: suggests product combinations in a bundle to make it easier to purchase them together.
- “Comparison”: compares several products to help customers choose the option that best suits their needs.
- “Ask about my order”: allows customers to check the status, tracking, and details of their orders.
- “Products in catalog images”: allows customers to select visible elements in catalog images to find similar products or combinations.
- “Search by image”: allows customers to upload an image, select visible elements, and find similar products or combinations.
Learn more about all the available features and how Brilliant can help your customers during the purchasing process in this article.
STEP 6. Activating Brilliant for customers
(In this section, you will learn how to activate Brilliant so that it is available to your eCommerce customers.)
33. Go to Home in Brilliant and click Make visible in your store.
34. Click Show Brilliant to enable it in your eCommerce store.
STEP 7. Verifying functionality
(In this section, you will learn how to verify that Brilliant is installed and working correctly in your eCommerce store.)
35. Go to your website and verify that Brilliant’s main bubble appears.
36. Click the bubble and verify that the assistant opens.
37. In the conversation box, submit a query and verify that Brilliant responds using information from your catalog.
38. Close the assistant and navigate to a page displaying product cards to verify that Brilliant’s bubble appears on them.
Frequently asked questions
1. The “Start installation” button is disabled
Brilliant has not yet detected that “Brilliant Control Center” is active in your website’s theme. Verify that you activated it and clicked Save in the Shopify theme editor.
Then return to Brilliant. The status will update automatically when it detects the configuration.
2. The “Preview” button is disabled
The preview will be available once Brilliant has finished processing the catalog.
You can check the progress from Home.
3. Brilliant does not appear on my website. What should I do?
Verify that:
- “Brilliant Control Center” is activated and saved in the published theme.
- You clicked Make visible in your store and then Show Brilliant under Home in the Brilliant dashboard.
- The catalog has finished processing.
- You have not reached your plan’s monthly conversation limit.
- The customer is browsing from an active market in your eCommerce store.
4. Brilliant is requesting new permissions
Some features may require additional Shopify permissions.
Click Continue in Shopify, review the requested permissions, and accept them to continue.
Success!
Brilliant is now installed, configured, and available in your eCommerce store.
Do you still have unanswered questions?
Remember that our Support team is available to help you. You can contact them by writing to support@getbrilliant.ai.
Keep learning!
To make the most of your Brilliant account, we recommend continuing with the following articles:
Brilliant features, to learn about the capabilities available in Brilliant.
Add Brilliant’s products that go well together carousel, to display complementary products on product pages.
Frequently asked questions about Brilliant, to resolve the most common questions about its functionality and configuration.
Add Brilliant’s similar products carousel, to display similar alternatives on product pages