[IMP] website/ecommerce: update catalog page #15569

lman-odoo · 2025-12-03T12:41:51Z

task-5136241

robodoo · 2025-12-03T12:41:54Z

auva-odoo

(This is only the first of two comment batches for this review! But thank you so much already for your tremendous work in this PR 🤯 🙏 !!!)

I think it might better (and easier) to structure the beginning of the doc a bit differently to have something that's maybe a bit closer to the options available in the Style tab. I think it would make things easier to understand, and also, for example, the search field/option also controls whether the search field is displayed at the top of the filters so it's not limited tot the "top bar". I would also rename "top bar" into "toolbar" and would maybe have something like this: (h2) Toolbar and filters (let's see if this works!) and then h3s: Categories, Filters, Toolbar. Let's maybe discuss this!
As discussed, let's also add a seealso for the Gelato documentation saying something like: Configure the Gelato connector in Odoo to synchronize product catalogs and automate order fulfilment with Gelato.

auva-odoo · 2025-12-04T13:32:27Z

content/applications/sales/sales/products_prices/products/variants.rst


 .. seealso::
-   :ref:`ecommerce/products/product-variants`
+   :ref:`Product variants in the eCommerce shop <ecommerce/categories_variants/product-variants>`


eCommerce shop is a bit redundant I think so I'd change this to eCommerce or online shop.

auva-odoo · 2025-12-04T13:35:26Z

content/applications/sales/sales/products_prices/products/variants.rst

+To use product variants, the :guilabel:`Variants` setting **must** be activated in the Odoo *Sales*
 application.

 To do that, go to :menuselection:`Sales app --> Configuration --> Settings`, and locate the
 :guilabel:`Product Catalog` section at the top of the page.

 In that section, check the box to enable the :guilabel:`Variants` feature.


Since we're changing this part anyways, I'd suggest to improve it even further to avoid repetitions 🙈

Suggested change

To use product variants, go to :menuselection:`Sales --> Configuration --> Settings`, then enable the :guilabel:`Variants` feature in the :guilabel:`Product Catalog` section at the top of the page.

And I would even remove the screenshot right after this

auva-odoo · 2025-12-04T13:36:30Z

content/applications/sales/sales/products_prices/products/variants.rst

 *Product Configurator*.

-The :guilabel:`Display Type` options are:
+The following :guilabel:`Display Type` options are available.


Suggested change

The following :guilabel:`Display Type` options are available.

The following :guilabel:`Display Type` options are available:

nitpick

auva-odoo · 2025-12-04T13:37:38Z

content/applications/sales/sales/products_prices/products/variants.rst

- :guilabel:`Multi-checkbox (option)`: options appear as selectable checkboxes on the product page
-  of the online store. This allows customers to choose options for themselves and is good choice for
-  highly customizable products.
+.. tabs::


I think using tabs and adding an example screenshot for each type is a great idea, well done!

auva-odoo · 2025-12-04T13:40:33Z

content/applications/sales/sales/products_prices/products/variants.rst

+
+   .. tab:: :guilabel:`Color`
+
+      Options appear as small, colored circles, which reflect any HTML color codes.


Suggested change

Options appear as small, colored circles, which reflect any HTML color codes.

Options appear as small, colored circles; the colors can be defined using any HTML color code.

auva-odoo · 2025-12-05T14:21:37Z

content/applications/websites/ecommerce/products/catalog.rst

+   .. image:: catalog/catalog-product-block.png
+      :alt: Example of a catalog block for specific products


I'd crop this screenshot so we don't see the website editor at all (it doesn't add much value, especially since it's so small AND it's going to be outdated really soon for sure)

auva-odoo · 2025-12-05T14:24:15Z

content/applications/websites/ecommerce/products/catalog.rst

+your e-commerce shop. You can showcase your categories, a specific product selection, or a banner
+with general information or promotions.
+
+Depending on the selected layout, you can customize the blocks in the :guilabel:`Style` tab.


Suggested change

Depending on the selected layout, you can customize the blocks in the :guilabel:`Style` tab.

Depending on the selected template, you can customize the blocks in the :guilabel:`Style` tab.

and i'd move this after the example actually

auva-odoo · 2025-12-05T14:48:43Z

content/applications/websites/ecommerce/products/catalog.rst

+   By default, the block displays the :guilabel:`Newest Products`. To change which products are
+   shown, go to the :guilabel:`Style` tab's :guilabel:`Products` section and set the
+   :guilabel:`Filter` field to :guilabel:`Recently Sold Products` or :guilabel:`Recently Viewed
+   Products (per user)`. In addition, it is possible to display products from a specific category
+   only using the :guilabel:`Category` field.
+
+   You can also filter products by :guilabel:`Tags`, :guilabel:`Show variants`, and adjust the
+   display by selecting a different :guilabel:`Cards Design`.


I think a lot of this changed actually and I would also rephrase and make sure we mention all the relevant options here (in a list form so it's easier for users to read) (add the following directly after the sentence "you can customize the blocks in the :guilabel:Style tab.")

Suggested change

By default, the block displays the :guilabel:`Newest Products`. To change which products are

shown, go to the :guilabel:`Style` tab's :guilabel:`Products` section and set the

:guilabel:`Filter` field to :guilabel:`Recently Sold Products` or :guilabel:`Recently Viewed

Products (per user)`. In addition, it is possible to display products from a specific category

only using the :guilabel:`Category` field.

You can also filter products by :guilabel:`Tags`, :guilabel:`Show variants`, and adjust the

display by selecting a different :guilabel:`Cards Design`.

For example, you can:

- Adapt the block's design (add a link to this: https://www.odoo.com/documentation/19.0/applications/websites/website/web_design/building_blocks.html#edit-a-building-block)

- Define which items are shown in the block by selecting the relevant :guilabel:`Filter` option. Set the field to :guilabel:`Category list` to show product categories. (add link to relevant section/doc)

- Select a specific product category in the :guilabel:`Filters` dropdown list.

- Toggle the :guilabel:`Clickable items` switch on to make the product/category cards clickable or toggle it off to display a button on the cards, then define the :guilabel:`Button`'s label. (this can probably be improved)

auva-odoo · 2025-12-05T15:04:42Z

content/applications/websites/ecommerce/products/catalog.rst

+Footer block
+~~~~~~~~~~~~
+
+There is a :guilabel:`eCommerce` footer block that features all the available payment methods in the
+footer.
+Click the footer and select the :guilabel:`eCommerce` template in the :guilabel:`Template` field.
+Click the payment method section, and choose a :guilabel:`Limit` and the :guilabel:`Height` in the
+:guilabel:`Supported Payment Methods` section.
+
+.. note::
+   It is not possible to create a customized footer per category.


I think we should change the header since it's not a block, and also add links to the relevant docs

Suggested change

Footer block

~~~~~~~~~~~~

There is a :guilabel:`eCommerce` footer block that features all the available payment methods in the

footer.

Click the footer and select the :guilabel:`eCommerce` template in the :guilabel:`Template` field.

Click the payment method section, and choose a :guilabel:`Limit` and the :guilabel:`Height` in the

:guilabel:`Supported Payment Methods` section.

.. note::

It is not possible to create a customized footer per category.

Ecommerce-specific website footer

~~~~~~~~~~~~

The :ref:`website footer <add link to this: https://www.odoo.com/documentation/master/applications/websites/website/structure/header_footer.html#footer-design>

can also be configured to use the ecommerce-specific template. Select the template, then add the

relevant :ref:`links <add link to this: https://www.odoo.com/documentation/19.0/applications/websites/website/web_design/elements.html#links>`

and adapt the footer's text and layout as needed in the website editor. The :doc:`available payment

methods <add link to this: https://www.odoo.com/documentation/master/applications/finance/payment_providers.html>`

are also shown in this footer. To adapt their display, go to the :guilabel:`Supported Payment

Methods` section in the website editor.

auva-odoo · 2025-12-05T15:08:32Z

content/applications/websites/ecommerce/products/catalog.rst

-.. seealso::
-   - :doc:`Products <../products>`
-   - :doc:`additional_features`
+Catalog blocks


I think I would add a h2 before this heading describing the purpose
For example: Catalog quick access from other website pages
or something similar?

auva-odoo

EDIT: sorry it seems I have posted the same comment twice and I can no longer delete my own comments (thank you GitHub ...), I can only edit it. Please ignore this one!

auva-odoo · 2025-12-05T15:22:56Z

content/applications/sales/sales/products_prices/products/variants.rst

+         :alt: Pills display type
+
+The :guilabel:`Variant Creation` field informs Odoo when to automatically create a new variant
 once an attribute is added to a product.


Sorry, I know you didn't write this but I think we can really improve this sentence as follows:

Suggested change

once an attribute is added to a product.

The :guilabel:`Variant Creation` field determines if/when a new variant is automatically created

once an attribute is added to a product.

[IMP] website/ecommerce: update catalog page

b497ea4

task-5136241

C3POdoo requested review from a team December 3, 2025 12:45

lman-odoo requested review from auva-odoo and removed request for a team December 3, 2025 13:10

auva-odoo requested changes Dec 5, 2025

View reviewed changes

auva-odoo reviewed Dec 5, 2025

View reviewed changes


	To use product variants, go to :menuselection:`Sales --> Configuration --> Settings`, then enable the :guilabel:`Variants` feature in the :guilabel:`Product Catalog` section at the top of the page.

	The following :guilabel:`Display Type` options are available.
	The following :guilabel:`Display Type` options are available:


		.. tab:: :guilabel:`Color`

		Options appear as small, colored circles, which reflect any HTML color codes.

		.. image:: catalog/catalog-product-block.png
		:alt: Example of a catalog block for specific products

	Depending on the selected layout, you can customize the blocks in the :guilabel:`Style` tab.
	Depending on the selected template, you can customize the blocks in the :guilabel:`Style` tab.

	once an attribute is added to a product.
	The :guilabel:`Variant Creation` field determines if/when a new variant is automatically created
	once an attribute is added to a product.

[IMP] website/ecommerce: update catalog page #15569

Are you sure you want to change the base?

[IMP] website/ecommerce: update catalog page #15569

Uh oh!

Conversation

lman-odoo commented Dec 3, 2025

Uh oh!

robodoo commented Dec 3, 2025

Uh oh!

auva-odoo left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

auva-odoo Dec 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

auva-odoo left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

auva-odoo Dec 5, 2025 •

edited

Loading

auva-odoo left a comment •

edited

Loading