Product Browser

Last updated

This is the most important Ecwid widget. It shows and includes a full-featured shopping cart with products, categories, catalog, checkout pages, etc. You can add the store to your site by adding a few lines of this widget to the source code of your site.

Product Browser

Ecwid can display products in three modes:

  • grid (default mode for the products in categories)
  • list (default mode for search. It shows the list of products with an abstract from the product description)
  • table (useful if your products don't have thumbnails. In this mode Ecwid shows all products in the list without product images)

You can always change the default modes by altering the product browser's settings.

Generate your code

Where to get your store ID?

<div id="my-store-"></div><div> <script type="text/javascript" data-cfasync="false" src="" charset="utf-8"></script><script type="text/javascript"> xProductBrowser("categoriesPerRow=3","views=grid(3,3) list(10) table(20)","categoryView=grid","searchView=list","id=my-store-");</script></div>

​Advanced Settings

You can adjust product browser layout styles and behavior according to your needs. For that, you will need to slightly modify the widget integration code as described below.

​Products/categories listing layout

Find the following code in the widget code:

"categoriesPerRow=3","views=grid(20,3) list(60) table(60)","categoryView=grid","searchView=list"

The code defines products and categories listing styles. Let's see its parts:

  • "categoriesPerRow=3" -- defines the number of categories per row
  • "views=grid(20,3) list(60) table(60)" - defines the available views and their settings. If you want to remove any view, just remove the "grid(20,3)" or "list(60)" or "table(60)" text from the settings.

The number in braces is number of products in the particular view. I.e.:

  • grid(K,L) - K is a number of products in a column, L -- number of products in a row. 
  • list(M) - M is number of products on one page
  • table(N) - N is number of products on one page

Default view mode:

  • "categoryView=grid" - defines the default view for products in categories. Possible values: list, grid, table
  • "searchView=list" - defines the default view for search results. Possible values: list, grid, table.

Default category for product browser

By default, the Product Browser widget opens with a list of root categories. But you can configure it to show a different category when user opens it for the first time. You can do it by adding the 'defaultCategoryId' option to the widget integration code. Please refer to this article for the details: Default category for product browser.

Responsive design

Ecwid supports responsive layout. It means that the store pages can adapt to the visitor's screen width on the fly and keep the layout clean and nice. Your products and categories lists will be fit for any window's size, as Ecwid will calculate the most suitable number of products or categories in row automatically. 

If you have noticed that responsive design works incorrectly in your store, please, inform us about it on our forums.


Related Articles

Was this article helpful?
21 out of 47 found this helpful
Get help
  • Forums

    Join the Ecwid community. Discuss support topics and store ideas with other Ecwid users.

  • Contact us

    Still have questions about Ecwid? Let us know! We will be glad to help you with your Ecwid store.

  • Status Monitor

    Get real time status updates on Ecwid services here, 24/7