Checkout Comment - Add an order comment in Magento 2
Magento Modules: Clear Guidelines
You purchase the module once, with no domain restrictions
Free installation and updates via Composer
Affiliate Program
Technical support for Magento
Clear guidelines for licensing Magento modules
Magento Module Code Security
The Checkout Comment module for Magento 2 lets you add a customer comment field during order placement. The comment is saved in the database, displayed in the admin panel, and available in the order history.
Key features
- Add a comment field on the payment page in Magento 2.
- Automatically save the comment to the database.
- Display the comment in the order details in the admin panel.
- Checkout Comment column in the order grid in Magento Admin.
- Option to enable and disable the module in the Magento configuration.
- SEO optimization - improved customer service quality and better order management.
Use cases
The module is useful for Magento stores that want to allow customers to provide additional information with their order, such as:
- Delivery information, e.g. Please deliver after 6:00 PM
- Packaging notes, e.g. Pack as a gift
- Special order notes
Configuration and management
The module allows you to fully manage customer comments through the Magento 2 admin panel. You can:
- Enable or disable the comment field in the Magento configuration.
- View comments on the order list in the admin panel.
- Search and sort orders by comment content.
Magento 2 compatibility
The module has been designed in accordance with the official Magento 2 guidelines. It does not interfere with the core sales process code and does not require cart modifications. As a result, it provides full compatibility with future Magento updates and other modules extending checkout.
Installation and implementation
To install the module, simply:
- Install the module: - Add the composer repository to the configuration by running
composer config repositories.project.checkout.comment vcs https://gitlab.com/magento2ext/magento-2-checkout-comment
Add an access token to the private GitLab repositorycomposer config --auth gitlab-token.gitlab.com <YOUR_TOKEN>
Install the composer module by runningcomposer require kowal/module-checkoutcomment
Enable the module by runningphp bin/magento module:enable Kowal_CheckoutComment
- Run the commands:
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush bin/magento indexer:reindex sales_order_grid
- Go to Kowal.co → Checkout Comment → Settings and enable the module.
Version: 1.0.1
28.01.2025
Fix
Improved saving of the comment in the order comment history
Version: 1.0.7
12.08.2025
Fix
We expanded the module so that a comment can be generated in the order confirmation sent to the customer. Now, by adding this code to the template:
{{if order_comment}} Komentarz do zamówienia:
{{var order_comment|escape|nl2br}}
{{/if}}The customer comment will be added to the order confirmation.
Version: 1.0.15
03.03.2026
Fix
- Fixed synchronization of the checkout_comment field with the sales_order_grid table.
- The checkout comment is now correctly visible in the order grid column in the admin panel.
Added
- Added saving the customer comment to the order comment history (Comments History) in the order view.
- The comment is added automatically during order placement and marked as not notifying the customer.
Technical
- Added mapping for the checkout_comment column in the Order Grid configuration (di.xml), so that the grid retrieves data from sales_order.checkout_comment.
- Extended the sales_model_service_quote_submit_before observer to add an entry to the order status history.













