--- title: "Configure XSearch Service" slug: "configure-xsearch" updated: 2025-05-13T20:41:00Z published: 2025-05-13T20:41:00Z canonical: "docs.xgen.ai/configure-xsearch" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xgen.ai/llms.txt > Use this file to discover all available pages before exploring further. # Configure XSearch Service > [!TIP] > Time Estimate > > 10 mins | (CSS/ HTML experience is helpful) ## 1. In XGEN Platform Your Search Bar experience will be driven by an XSearch Engine and an XSearch Experience. This is a two step process that requires navigating between two to four separate pages within the XGEN Platform. ### Create an XSearch Engine Log into the XGEN Platform and select Engines below the XSearch menu item. 1. Create a New Engine 2. Select Hybrid Parellel in the Models Section at the top of the page 3. Do not change the default settings below the Models section ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-13 at 2.37.50 PM.png) ### **Create an XSearch Experience** After you’ve created an [XSearch Engine](/v1/docs/engine-composer-v2) and a [Merchandising Rule](/v1/docs/introduction-to-merchandising), you can connect that engine and Merchandising Rule to an XSearch Experience. Navigate to the Experience page below the XSearch menu item. 1. Click New Experience in the top right corner of the page 2. Name the Experience 3. Choose API Version 4. Select the Hybrid Engine you just created 5. Assign a [Merchandising Rule](/v1/docs/merchandising-rules) 6. Click Save and wait for the page to reload ### Copy your **Experience ID** After saving your experience, the Experience Information section at the top of the page will refresh and display an Experience ID. Click the copy icon next to the Experience ID for use in the Shopify Admin Theme. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-13 at 2.05.49 PM.png) ## 2. In Shopify Theme Editor ### **Open Theme Editor** In your Shopify Admin dashboard, choose a theme to customize. It can be your public theme or an archived one. ### **Select App Embeds** On the left side menu, you will see three stacked menu icons. Select the bottom icon with three boxes and a plus sign. This is where you can control all your App Embeds. These App Embeds are controlled by a widget, similar to XRecommend and XProduct Listing, but these are universal across the site. In other words. because XSearch will appear on every page, it will be controlled with an App Embed instead of an App Block in a page’s Theme template. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-13 at 2.15.11 PM.png) ### Paste your **Experience ID** In the field at top of the side bar, paste the XSearch Experience ID you copied from the XGEN Platfom. ### Find the **CSS Selector** 1. Use your browser **Inspect Element** tool by right clicking on the search button or search input field on the page and select the “Inspect” option 2. Identify the CSS class or ID related to the Search Button or Search Input class. 3. Enter this selector (class or ID) in the CSS Selector field in the app settings so XSearch can attach correctly.