--- title: "Customize PLP Widget" slug: "customize-plp" updated: 2025-07-25T14:48:20Z published: 2025-07-25T14:48:20Z canonical: "docs.xgen.ai/customize-plp" --- > ## 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. # Customize PLP Widget > [!WARNING] > Before You Start > > At this point, you have already [configured your PLP Service](/v1/docs/configure-plp) in the XGEN platform This page will cover two steps taken within your Shopify Storefront 1. [Shopify App Widget Customization](/v1/docs/customize-plp#shopify-app-widget-customization-page) 2. [Shopify Theme App Block](/v1/docs/customize-plp#shopify-theme-page-app-block) ## Shopify App Widget Customization Page > [!TIP] > Time Estimate > > 5 mins ### Page Layout Choose overarching styles like heading font, body font, page padding and page background color. Properly adjusting these settings helps keep product grids visually organized and easy to browse. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-09 at 10.46.11 AM.png) ### Filter Layout & Styles Customize the look of the filtering sidebar or dropdowns. You can set a background color for the filter area, choose heading font and size for filters, and control padding, alignment, and colors. Style individual filter groups as either pills or checkboxes. Update the label styling including padding and font size. You can set specific font and color choices to match the filters to your store’s typography system. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-09 at 10.45.40 AM.png) ### Filter Customization To further customize the way your filters appear within your PLP Widget, you can assign images to filters and change the individual filter styling displayed on your PLP. You can find the Filter Customization page in the main XGEN app menu below Widgets. ![XGEN AI app interface showing options for catalog, widgets, and filters customization.](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-07-23 at 1.30.58 PM.png) #### Filter Image Mapping In Filter Image Mapping, you can assign images or colors to your Pill and Swatch style filters. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-07-25 at 8.46.01 AM.png) #### Filter Style In Filter Style, you can configure the styling of each individual filter you are passing from [XGEN’s Merchandising Rules](/v1/docs/merchandising-rules). There are three styles to choose from: Checkbox, Pill, and Swatches. > [!WARNING] > Checkbox Style Limitations > > Checkbox styles currently do not support images or colors. If you are using images in swatch or pill styles, you can add images and colors to your filter items. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-07-23 at 1.43.01 PM.png) ### Sort Button Layout Control the appearance of the "Sort By" dropdown that lets customers re-order results (e.g., by Newest, Price: Low to High, Best Selling). You can customize the font, text transform (like Uppercase), and spacing within the sort bar. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-09 at 10.44.42 AM.png) ### Navigation Layout Customize how page navigation or pagination looks at the bottom of product listings. Define the label for navigation (such as "View More Products"), font styles, padding, and the styling for navigation buttons. Good navigation design ensures customers always know how to load or explore more results without getting stuck or confused. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-09 at 10.46.53 AM.png) ### Global Custom CSS Add any additional CSS code to fine-tune your PLP and Filter styling beyond the built-in controls. This is ideal for matching precise brand styles, campaign designs, or making mobile-specific adjustments for better usability. Learn more about using Custom CSS on your widgets and app blocks [here](/v1/docs/customizing-widgets-app-blocks-with-css) ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-09 at 10.47.32 AM.png) ## Shopify Theme App Block > [!TIP] > Time Estimate > > 3 mins Go to your Themes section of your Shopify Storefront and select a theme to Customize. ### Navigate to a Collection Page Inside your theme editor, use the top nav bar to select a collection page to edit. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/image(72).png) ### Insert an App Block On the left sidebar, choose a section to add an App Block. Click the + button between sections or click the “Add Section” button at the bottom of your Template layer list. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-13 at 12.52.40 PM.png) ### Paste in Your PLP Experience ID Once the XProduct Listing App Block is added to your Template, you can paste your XSearch Experience ID into the field at the top of the side bar. Continue to adjust you product card column count on desktop and mobile and show/hide options like Vendor Name, Variant Selector, or the Add To Cart Button. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/image(73).png) Custom CSS can be added to this App Block at the bottom of the side bar to further customize the display of the PLP.