odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/websites/ecommerce/checkout.md

@@ -0,0 +1,171 @@
+---
+title: "Checkout"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/ecommerce/checkout.html"
+---
+
+========
+# Checkout
+
+Once customers have added their desired products to the cart, they can access it by clicking the
+:icon:`fa-shopping-cart` button in the header to start the checkout process. In Odoo eCommerce, this
+process consists of sequential :ref:`steps <ecommerce/checkout/steps>`, some of which support
+additional features. The related checkout pages can be :ref:`customized
+<ecommerce/checkout/customize_steps>` using the website editor.
+
+.. _ecommerce/checkout/policy:
+
+# Checkout policy
+
+To allow customers to checkout as guests or force them to sign in/create an account, go to
+:menuselection:`Website --> Configuration --> Settings`, scroll down to the
+:guilabel:`Shop - Checkout Process` section, and configure the :guilabel:`Sign in/up at checkout`
+setting. The following options are available:
+
+- :guilabel:`Optional`: Customers can check out as guests and register later via the order
+  confirmation email to track their order.
+- :guilabel:`Disabled (buy as guest)`: Customers can checkout as guests without creating an account.
+- :guilabel:`Mandatory (no guest checkout)`: Customers must sign in or create an account at
+  the :ref:`Review Order <ecommerce/checkout/review_order>` step to complete their purchase.
+
+## B2B access management
+
+To restrict checkout to selected B2B customers, follow these steps:
+
+#. Go to :menuselection:`Website --> Configuration --> Settings`, and in the
+   :guilabel:`Shop - Checkout Process` section, enable the
+   :ref:`Mandatory (no guest checkout) <ecommerce/checkout/policy>` option.
+#. Scroll down to the :guilabel:`Privacy` section, go to :guilabel:`Customer Account`, and select
+   :guilabel:`On invitation`.
+#. Go to :menuselection:`Website --> eCommerce --> Customers`, switch to the :guilabel:`List` view,
+   and select the customers you wish to grant access to your
+   :doc:`portal </applications/general/users/portal>`.
+#. Click the :icon:`fa-cog` :guilabel:`Actions` button, then :guilabel:`Grant portal access`.
+#. Review the selected customers in the :guilabel:`Portal Access Management` pop-up and click
+   :guilabel:`Grant Access`.
+
+Once done, the relevant customers receive an email confirming their account creation, including
+instructions on setting a password and activating their account.
+
+> **note**:
+>    - You can revoke access or re-invite a customer using the related buttons in the
+     :guilabel:`Portal Access Management` pop-up.
+   - Users can only have one :doc:`portal access </applications/general/users/portal>` per email.
+   - Settings are website-specific, so you could set up a B2C website that allows guest checkout and
+     B2B website with mandatory sign-in.
+
+.. seealso::
+   - :doc:`Customer accounts <customer_accounts>`
+   - :doc:`Portal access </applications/general/users/portal>`
+
+.. _ecommerce/checkout/steps:
+
+# Checkout steps
+
+During the checkout process, customers are taken through the following steps:
+
+- :ref:`Review order <ecommerce/checkout/review_order>`
+- :ref:`Delivery <ecommerce/checkout/delivery>`
+- :ref:`Extra info (if enabled) <ecommerce/checkout/extra_step>`
+- :ref:`Payment <ecommerce/checkout/payment>`
+- :ref:`Order confirmation <ecommerce/checkout/order_confirmation>`
+
+.. _ecommerce/checkout/customize_steps:
+
+Each step can be customized using the website editor: Click :guilabel:`Edit` to add
+:doc:`building blocks <../website/web_design/building_blocks>` from the :guilabel:`Blocks` tab or
+open to the :guilabel:`Customize` tab to enable various checkout options.
+
+> **note**:
+>    Content added through building blocks is **specific** to each step.
+
+.. _ecommerce/checkout/review_order:
+
+## Review order
+
+The :guilabel:`Review Order` step allows customers to see the items they added to their cart, adjust
+quantities, or :guilabel:`Remove` products. Information related to the product prices and taxes
+applied are also displayed. Customers can then click the :guilabel:`Checkout` button to continue to
+the :ref:`Delivery <ecommerce/checkout/delivery>` step.
+
+Open the website editor to :ref:`enable <ecommerce/checkout/customize_steps>` checkout options such
+as:
+
+- :guilabel:`Suggested Accessories`: to showcase :ref:`accessory products
+  <ecommerce/cross_upselling/accessory>`;
+- :guilabel:`Promo Code`: to allow customers to redeem :ref:`gift cards <ewallet_gift/gift-cards>`
+  or apply :doc:`discount codes </applications/sales/sales/products_prices/loyalty_discount>`;
+- :guilabel:`Add to Wishlist`: To allow signed-in users to remove a product from their cart and add
+  it to their wishlist, go to :menuselection:`Website --> Configuration --> Settings`, scroll to
+  the :guilabel:`Shop - Products` section, and enable :guilabel:`Wishlists`. The :guilabel:`Add to
+  Wishlist` option is then enabled by default in the website editor.
+
+> **note**:
+>    - If a :doc:`fiscal position </applications/finance/fiscal_localizations>` is detected automatically,
+     the product tax is determined based on the customer's IP address.
+   - If the installed :doc:`payment provider </applications/finance/payment_providers>` supports
+     :ref:`express checkout <payment_providers/express_checkout>`, a dedicated button is displayed,
+     allowing customers to go straight from the cart to the confirmation page without filling out
+     the contact form.
+
+.. _ecommerce/checkout/delivery:
+
+## Delivery
+
+Once they have reviewed their order:
+
+- Unsigned-in customers are prompted to :guilabel:`Sign in` or enter their
+  :guilabel:`Email address`, along with their delivery address and phone details;
+- Signed-in customers can select the appropriate :guilabel:`Delivery address`.
+
+They can then :doc:`choose a delivery method <shipping>`, select or enter their :guilabel:`Billing
+Address` (or toggle the :guilabel:`Same as delivery address` switch if the billing and delivery
+addresses are identical), and click :guilabel:`Confirm` to proceed to the next step.
+
+> **tip**:
+>    For B2B customers, you can also :ref:`enable <ecommerce/checkout/customize_steps>` optional
+   :guilabel:`VAT` and :guilabel:`Company name` fields by toggling the :guilabel:`Show B2B Fields`
+   option in the website editor.
+
+.. _ecommerce/checkout/extra_step:
+
+## Extra info
+
+You can add an :guilabel:`Extra Info` step in the checkout process to collect additional
+customer information through an online form, which is then included in the :ref:`sales order
+<handling/sales>`. To do so :ref:`enable <ecommerce/checkout/customize_steps>` the :guilabel:`Extra
+Step` option in the website editor. The form can be :ref:`customized <website/dynamic_content/form>`
+as needed.
+
+> **tip**:
+>    Alternatively, go to :menuselection:`Website --> Configuration --> Settings`, scroll to the
+   :guilabel:`Shop - Checkout Process` section, enable :guilabel:`Extra Step During Checkout`, and
+   click :guilabel:`Save`. Click :icon:`fa-arrow-right` :guilabel:`Configure Form` to customize the
+   form.
+
+.. _ecommerce/checkout/payment:
+
+## Payment
+
+At the :guilabel:`Payment` step, customers :guilabel:`Choose a payment method`, enter their
+payment details, and click :guilabel:`Pay now`.
+
+You can require customers to agree to your :doc:`terms and conditions
+</applications/finance/accounting/customer_invoices/terms_conditions>` before payment. To
+:ref:`enable <ecommerce/checkout/customize_steps>` this option, go to the website editor and toggle
+the :guilabel:`Accept Terms & Conditions` feature.
+
+> **tip**:
+>    Enable the :ref:`developer mode <developer-mode>` and click the :icon:`fa-bug` :guilabel:`bug`
+   icon to display an :ref:`availability <payment_providers/availability>` report for payment
+   providers and payment methods, which helps diagnose potential availability issues on the payment
+   form.
+
+.. _ecommerce/checkout/order_confirmation:
+
+## Order confirmation
+
+The final step of the checkout process is the :guilabel:`Order confirmation`, which provides a
+summary of the customer's purchase details.
+
+.. seealso::
+   :doc:`Order handling <order_handling>`

package/payload/skills/odoo18-docs/references/docs/applications/websites/ecommerce/customer_accounts.md

@@ -0,0 +1,45 @@
+---
+title: "Customer accounts"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/ecommerce/customer_accounts.html"
+---
+
+=================
+# Customer accounts
+
+Having customer accounts on an eCommerce allows customers to access all their documents from a
+single place. To access their account, customers must be **logged-in** on the eCommerce website,
+click on their **username** in the top-right corner of the screen, and click :guilabel:`My Account`.
+From there, customers can access their :guilabel:`quotations`, :guilabel:`orders`,
+:guilabel:`invoices`, etc.
+
+.. image:: customer_accounts/account-log.png
+   :align: center
+   :alt: Customer account log-in
+
+> **note**:
+>    Customers can only have an account if the
+   :ref:`sign in/up at checkout <ecommerce/checkout/policy>` option allows for account creation.
+
+> **tip**:
+>    Similarly to the rest of the website, the customer account page can be customized with **content
+   blocks** and other features through the **website builder**.
+
+.. seealso::
+   :doc:`/applications/general/users/portal`
+
+# Access restriction
+
+It is possible to allow or restrict the documents to which customers have access through the website
+builder. Log in your **own** account with your Odoo database credentials, and go to
+:menuselection:`Edit --> Customize`. From the website builder menu, enable or disable the documents
+customers can have access to.
+
+.. image:: customer_accounts/account-documents.png
+   :align: center
+   :alt: Documents to which customers have access to from their account
+
+# Multi-website account
+
+If you own multiple websites, you can make customer accounts available across **all** websites.
+Then, the customer only needs one account. To do so, go to :menuselection:`Website --> Configuration
+--> Settings --> Privacy section`, and enable :guilabel:`Shared Customer Accounts`.

package/payload/skills/odoo18-docs/references/docs/applications/websites/ecommerce/order_handling.md

@@ -0,0 +1,109 @@
+---
+title: "Order handling"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/ecommerce/order_handling.html"
+---
+
+==============
+# Order handling
+
+When a customer orders on your eCommerce, there are **three** record types required to be handle in
+Odoo:
+
+- :ref:`Sales orders <handling/sales>`;
+- :ref:`Delivery orders <handling/delivery>`;
+- :ref:`Invoices & legal requirements <handling/legal>`.
+
+.. _handling/sales:
+
+# Sales orders
+
+## Order and payment status
+
+The first step when a customer adds a product to his cart is the creation of a quotation. Orders can
+be managed either from the **Website** or :doc:`Sales </applications/sales/sales>` app. eCommerce
+orders can automatically be assigned to a specific sales team by going to :menuselection:`Website
+--> Configuration --> Settings`. In the **Shop - Checkout Process** section, select a
+:guilabel:`Sales Team` or :guilabel:`Salesperson` to handle eCommerce orders.
+
+.. image:: order_handling/handling-salesteam.png
+   :align: center
+   :alt: Assignment of online orders to a sales team or salesperson
+
+Orders can be found under :menuselection:`Website --> eCommerce --> Orders/Unpaid Orders`. Each
+order goes through a different status:
+
+- **Quotation**: a new product is added to the cart, but the customer has *not* gone through the
+  checkout process yet;
+- **Quotation sent**: the customer has gone through the checkout process and confirmed the order,
+  but the payment is not yet confirmed;
+- **Order**: the customer has gone through the checkout process, confirmed the order, and the
+  payment is received.
+
+.. image:: order_handling/handling-status.png
+   :align: center
+   :alt: Statuses of eCommerce orders
+
+## Abandoned cart
+
+An **abandoned cart** represents an order for which the customer did **not finish** the checkout
+confirmation process. For these orders, it is possible to send an **email reminder** to the
+customer automatically. To enable that feature, go to :menuselection:`Website --> Configuration -->
+Settings` and in the :guilabel:`Email & Marketing` section, enable :guilabel:`Automatically send
+abandoned checkout emails`. Once enabled, you can set the **time-lapse** after which the email is
+sent and customize the **email template** used.
+
+> **note**:
+>    For abandoned cart emails, the customer must either have entered their contact details during the
+   checkout process; or be logged-in when they added the product to their cart.
+
+.. _handling/delivery:
+
+# Delivery orders
+
+## Delivery flow
+
+Once a quotation has been confirmed, a delivery order is automatically created. The next step is to
+process this delivery.
+
+Packing eCommerce orders usually requires picking the product, preparing the packaging, printing the
+shipping label(s) and shipping to the customer. Depending on the number of orders, strategy, or
+resources, those steps can be considered as one or multiple actions in Odoo.
+
+An automatic email can be sent to the customer when the transfer status in Odoo is “done”. To do so,
+enable the feature in the settings of the
+:doc:`Inventory </applications/inventory_and_mrp/inventory>` app.
+
+> **note**:
+>    If customers are allowed to pay when picking up their order in stores or by wire transfer, the
+   quotation is **not** be confirmed and the stock is **not** be reserved. Orders must be confirmed
+   manually to reserve products in stock.
+
+.. seealso::
+   - :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/invoicing`
+   - :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels`
+   - :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/multipack`
+
+## Returns and refunds
+
+Customers can only return an order through an online form. It may not be possible to return products
+depending on the return strategy or type of product.
+
+Full refunds can be directly sent to customers from within the order interface. A refund-compatible
+payment provider needs to be enabled first.
+
+.. seealso::
+   - :doc:`/applications/sales/sales/products_prices/returns`
+   - :doc:`/applications/services/helpdesk/advanced/after_sales`
+   - :doc:`/applications/finance/payment_providers`
+
+.. _handling/legal:
+
+# Invoice and legal requirements
+
+The final step of an ecommerce order is to generate the invoice and send it to the customer.
+Depending on the type of business (B2B or B2C), an invoice can either be generated automatically
+(B2B) or on demand of the customer (B2C). This process can be automated if (and when) the online
+payment is :ref:`confirmed <handling/sales>`.
+
+To automate invoicing, go to :menuselection:`Website --> Configuration --> Settings` and in the
+:guilabel:`Invoicing` section, enable :guilabel:`Automatic Invoice`.

package/payload/skills/odoo18-docs/references/docs/applications/websites/ecommerce/payments.md

@@ -0,0 +1,55 @@
+---
+title: "Payment providers"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/ecommerce/payments.html"
+---
+
+=================
+# Payment providers
+
+Odoo supports a multitude of online
+:doc:`payment providers </applications/finance/payment_providers>` for your website, allowing your
+customers to pay with their preferred payment methods.
+
+.. seealso::
+   - :doc:`/applications/sales/sales/products_prices/ewallets_giftcards`
+   - :doc:`checkout`
+
+# Configuration
+
+To set up payment providers on the eCommerce app, go to :menuselection:`Website --> Configuration
+--> Payment Providers`. From here, :guilabel:`Activate` the payment providers you wish to have
+available on your shop, and configure them according to your needs.
+
+Alternatively, you can access **payment providers** via :menuselection:`Website --> Configuration
+--> Settings`. In the :guilabel:`Shop - Payment` section, you can :guilabel:`Configure SEPA Direct
+Debit` if you wish to use it, as well as :guilabel:`View other providers`. If you use the
+:guilabel:`Authorize.net` payment provider, the
+:ref:`Payment Capture Method <payment_providers/manual_capture>` can be configured in that same menu.
+
+If you are using :doc:`/applications/finance/payment_providers/paypal`, you can also enable and
+configure it here.
+
+## Checkout payment options
+
+Once activated, customers can choose the payment provider of their choice during the **checkout
+process**, at the :guilabel:`Confirm Order` step.
+
+.. image:: payments/payments-checkout.png
+   :align: center
+   :alt: Payment provider selection at checkout
+
+# eWallets and gift cards
+
+When checking out, customers can pay with an eWallet or gift cards. To enable these, go to
+:menuselection:`Website --> Configuration --> Settings`, and in the :guilabel:`Shop-Products`
+section, enable :menuselection:`Discounts, Loyalty & Gift Card`.
+
+Once enabled, customers can enter their gift card **code** or pay with their eWallet at the checkout
+step.
+
+.. image:: payments/payments-ewallets-giftcards.png
+   :align: center
+   :alt: Enter gift card code to process checkout
+
+.. seealso::
+   :doc:`/applications/sales/sales/products_prices/ewallets_giftcards`

package/payload/skills/odoo18-docs/references/docs/applications/websites/ecommerce/performance.md

@@ -0,0 +1,63 @@
+---
+title: "Performance management"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/ecommerce/performance.html"
+---
+
+======================
+# Performance management
+
+Odoo integrates a variety of tools to analyze and improve the performance of your eCommerce
+website.
+
+# Data monitoring
+
+**Website** allows monitoring and analysis of the sales performance of your eCommerce. To access the
+**reporting view**, go to :menuselection:`Website --> Reporting --> eCommerce`. This dashboard helps
+you monitor everything related to sales, such as sales performance per product, category, day, etc.
+
+.. image:: performance/reporting.png
+   :align: center
+   :alt: Performance reporting of eCommerce
+
+By clicking :guilabel:`Measures`, you can select the type of measurement used, such as:
+
+- :guilabel:`Margin`;
+- :guilabel:`Qty Invoiced`;
+- :guilabel:`Untaxed Total`;
+- :guilabel:`Volume`;
+- ...
+
+Other options include **multiple views (Pivot, etc.), comparison** by periods or years, and directly
+:guilabel:`insert in spreadsheet`, etc.
+
+# Analytics
+
+It is possible to link your Odoo website with :ref:`analytics/plausible` and
+:ref:`analytics/google-analytics`.
+
+.. _ecommerce/performance/email_queue:
+
+# Email queue optimization
+
+For websites handling flash sales (e.g., event ticket sales) or experiencing high traffic spikes,
+order confirmation emails can become a performance bottleneck, potentially slowing down the checkout
+process for other customers.
+
+To improve performance, these emails can be queued and processed separately from the order
+confirmation flow. This is managed by the :guilabel:`Sales: Send pending emails` scheduled action,
+which sends queued emails as soon as possible.
+
+To enable asynchronous email sending:
+
+#. Enable the :doc:`developer mode </applications/general/developer_mode>`.
+#. Go to :menuselection:`Apps`, remove the :guilabel:`Apps` filter, and install the :guilabel:`Sales
+   - Async Emails` module.
+#. Go to :menuselection:`Settings --> Technical --> System Parameters` and set the
+   :guilabel:`sale.async_emails` system parameter to `True`.
+#. Go to :menuselection:`Settings --> Technical --> Scheduled Actions` and ensure that the
+   :guilabel:`Sales: Send pending emails` scheduled action is enabled.
+
+.. caution::
+   Enabling this feature may delay order confirmation and invoice emails by a few minutes. It is
+   recommended only for high-traffic websites, as it can introduce unnecessary delays for e-commerce
+   websites with moderate traffic.

package/payload/skills/odoo18-docs/references/docs/applications/websites/ecommerce/products/catalog.md

@@ -0,0 +1,200 @@
+---
+title: "Catalog"
+source_url: "https://docs.odoo.sbggai.top/applications/websites/ecommerce/products/catalog.html"
+---
+
+=======
+# Catalog
+
+The eCommerce catalog is the equivalent of your physical store shelves: it allows customers to see
+what you have to offer. Clear categories, available options, sorting, and navigation threads help
+you structure it efficiently.
+
+> **tip**:
+>    Go to :menuselection:`Website --> Configuration --> Settings`, scroll down to the
+   :guilabel:`Privacy` section to restrict :guilabel:`Ecommerce Access` to logged-in users and/or
+   enable :guilabel:`Shared Customer Accounts` to allow access to all websites with a single
+   account.
+
+# Categorize the product catalog
+
+In Odoo, there is a **specific category model** for your eCommerce. Using eCommerce categories for
+your products allows you to add a navigation menu on your eCommerce page. Visitors can then use it
+to view all products under the category they select.
+
+To do so, go to :menuselection:`Website --> eCommerce --> Products`, select the product you wish to
+modify, click on the :guilabel:`Sales` tab, and select the :guilabel:`Categories` you want under
+:guilabel:`eCommerce Shop`.
+
+.. image:: catalog/catalog-categories.png
+   :align: center
+   :alt: eCommerce categories under the "Sales" tab
+
+> **note**:
+>    A single product can appear under multiple eCommerce categories.
+
+When your product's categories are configured, go to your **main shop page** and click on
+:menuselection:`Edit --> Customize tab`. In the :guilabel:`Categories` option, you can either enable
+a menu on the :guilabel:`Left`, on the :guilabel:`Top`, or both. If you select the :guilabel:`Left`
+category, the option :guilabel:`Collapsable Category Recursive` appears and allows to render the
+:guilabel:`Left` category menu collapsable.
+
+.. image:: catalog/catalog-panel-categories.png
+   :align: center
+   :alt: Categories options for your eCommerce website
+
+.. seealso::
+   :doc:`../products`
+
+.. _ecommerce-browsing:
+
+## Browsing
+
+The eCommerce category is the first tool to organize and split your products. However, if you need
+an extra level of categorization in your catalog, you can activate various **filters** such as
+attributes or sort-by search.
+
+### Attributes
+
+Attributes refer to **characteristics** of a product, such as **color** or **material**, whereas
+variants are the different combinations of attributes. :guilabel:`Attributes and Variants` can be
+found under :menuselection:`Website --> eCommerce --> Products`, select your product, and
+:guilabel:`Attributes & Variants` tab.
+
+.. seealso::
+   - :doc:`../../../sales/sales/products_prices/products/variants`
+
+.. image:: catalog/catalog-attributes.png
+   :align: center
+   :alt: Attributes and variants of your product
+
+To enable **attribute filtering**, go to your **main shop page**, click on :menuselection:`Edit -->
+Customize tab` and select either :guilabel:`Left`, :guilabel:`Top`, or both. Additionally, you can
+also enable :guilabel:`Price Filtering` to enable price filters.
+
+> **note**:
+>    :guilabel:`Price Filter` works independently from **attributes** and, therefore, can be enabled
+   on its own if desired.
+
+> **tip**:
+>    You can use **attribute filters** even if you do not work with product variants. When adding
+   attributes to your products, make sure only to specify *one* value per attribute. Odoo does not
+   create variants if no combination is possible.
+
+### Sort-by search
+
+It is possible to allow the user to manually **sort the catalog** using the search bar. From
+your **main shop page**, click on :menuselection:`Edit --> Customize tab`; you can enable or disable
+the :guilabel:`Sort-By` option as well as the :guilabel:`Layout` button. You can also select the
+:guilabel:`Default Sort` of the :guilabel:`Sort-By` button. The default sort applies to *all*
+categories.
+
+The **sorting** options are:
+
+- Featured
+- Newest Arrivals
+- Name (A-Z)
+- Price - Low to High
+- Price - High to Low
+
+In addition, you can **manually edit** the catalog's order of a product by going to **the main shop
+page** and clicking on the product. Under the :guilabel:`Product` section of the
+:guilabel:`Customize` section, you can rearrange the order by clicking on the arrows. `<<` `>>` move
+the product to the **extreme** right or left, and `<` `>` move the product by **one** row to the
+right or left. It is also possible to change the catalog's order of products in
+:menuselection:`Website --> eCommerce --> Products` and drag-and-dropping the products within the
+list.
+
+.. image:: catalog/catalog-reorder.png
+   :align: center
+   :alt: Product rearrangement in the catalog
+
+# Page design
+
+## Category page
+
+You can customize the layout of the category page using the website builder.
+
+> **important**:
+>    Editing the layout of the category page is global; editing one category layout affects *all*
+   category pages.
+
+To do so, go on to your :menuselection:`Category page --> Edit --> Customize`. Here, you can choose
+the layout, the number of columns to display the products, etc. The :guilabel:`Product Description`
+button makes the product description visible from the category page, underneath the product picture.
+
+.. image:: catalog/catalog-category-layout.png
+   :align: center
+   :alt: Layout options of the category pages.
+
+> **tip**:
+>    You can choose the size of the grid, but be aware that displaying too many products may affect
+   performance and page loading speed.
+
+## Product highlight
+
+You can highlight products to make them more visible on the category or product page. On the page of
+your choice, go to :menuselection:`Edit --> Customize` and click on the product to highlight. In the
+:guilabel:`Product` section, you can choose the size of the product image by clicking on the grid,
+and you can also add a **ribbon** or :guilabel:`Badge`. This displays a banner across the product's
+image, such as:
+
+- Sale;
+- Sold out;
+- Out of stock;
+- New.
+
+Alternatively, you can activate the :doc:`developer mode <../../../general/developer_mode>` on the
+**product's template**, and under the :guilabel:`Sales` tab, change or create the ribbon from the
+:guilabel:`Ribbon` field.
+
+> **note**:
+>    The :doc:`developer mode <../../../general/developer_mode>` is only intended for experienced
+   users who wish to have access to advanced tools. Using the **developer mode** is *not*
+   recommended for regular users.
+
+.. image:: catalog/catalog-product-highlight.png
+   :align: center
+   :alt: Ribbon highlight
+
+# Additional features
+
+You can access and enable additional feature buttons such as **add to cart**, **comparison list**,
+or a **wishlist**. To do so, go to your **main shop page**, and at the end of the
+:guilabel:`Products Page` category, click on the feature buttons you wish to use. All three buttons
+appear when hovering the mouse over a product's image.
+
+- :guilabel:`Add to Cart`: adds a button to
+  :doc:`add the product to the cart <../cart>`;
+- :guilabel:`Comparison List`: adds a button to **compare** products based on their price, variant,
+  etc.;
+- :guilabel:`Wishlist Button`: adds a button to **wishlist** the product.
+
+.. image:: catalog/catalog-buttons.png
+   :align: center
+   :alt: Feature buttons for add to cart, comparison list, and wishlist
+
+.. image:: catalog/catalog-features.png
+   :align: center
+   :alt: Appearance of buttons when hoovering over the mouse
+
+# Add content
+
+You can use **building blocks** to add content on the category page, with a variety of blocks
+ranging from :guilabel:`Structure` to :guilabel:`Dynamic Content`. Specific areas are defined to use
+blocks are defined and highlighted on the page when **dragging-and-dropping** a block.
+
+.. image:: catalog/catalog-content.png
+   :align: center
+   :alt: Building blocks areas
+
+- If you drop a building block **on top** of the product list, it creates a new category header
+  specific to *that* category.
+- If you drop a building **on the top** or **bottom** of the page, it becomes visible on *all*
+  category pages.
+
+> **tip**:
+>    Adding content to an eCommerce category page is beneficial in terms of **SEO** strategy. Using
+   **keywords** linked to the products or the eCommerce categories improves organic traffic.
+   Additionally, each category has its own specific URL that can be pointed to and is indexed by
+   search engines.