diff --git a/code_samples/recommendations/events/category_parameter.html.twig b/code_samples/recommendations/events/category_parameter.html.twig
new file mode 100644
index 0000000000..16d67a06f1
--- /dev/null
+++ b/code_samples/recommendations/events/category_parameter.html.twig
@@ -0,0 +1,11 @@
+{% block content %}
+
+
{{ product.name }}
+ {# ... product content ... #}
+
+
+ {# Track with category identifier - automatic loading and formatting #}
+ {{ ibexa_tracking_track_event('visit', product, {
+ 'categoryIdentifier': 'electronics'
+ }) }}
+{% endblock %}
diff --git a/docs/recommendations/raptor_integration/tracking_php_api.md b/docs/recommendations/raptor_integration/tracking_php_api.md
index 961dc73d42..6f82e2c189 100644
--- a/docs/recommendations/raptor_integration/tracking_php_api.md
+++ b/docs/recommendations/raptor_integration/tracking_php_api.md
@@ -9,7 +9,7 @@ You can interact directly with the [Raptor connector](raptor_connector.md)'s ser
## Advanced usage – direct interaction with the service
-The [`ServerSideTrackingDispatcherInterface::dispatch()`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorRaptor-Tracking-ServerSideTrackingDispatcherInterface.html#method_dispatch) method allows to send tracking data from the server side.
+The [`ServerSideTrackingDispatcherInterface::dispatch()`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorRaptor-Tracking-ServerSideTrackingDispatcherInterface.html#method_dispatch) method allows sending tracking data from the server side.
It can be used in controllers, event subscribers, or any other part of the application.
This method receives an [`EventDataInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorRaptor-Tracking-Event-EventDataInterface.html).
For more information, see the available events in the [tracking event namespace](/api/php_api/php_api_reference/namespaces/ibexa-contracts-connectorraptor-tracking-event.html).
@@ -38,9 +38,34 @@ Check the following example:
[[= include_file('code_samples/recommendations/EventMapper.php', 20, 27, remove_indent=True) =]]
```
+### Category parameter for product events
+
+In [[= product_name =]], products can be assigned to multiple categories.
+However, Raptor accepts only a single category value in tracking events.
+
+By default, the connector uses the first category from the list of categories assigned to the product.
+You can override this behavior and define which category is sent in tracking events.
+
+To do this:
+
+1. Open the product page in the back office.
+2. Check the categories assigned to the product and select the one you want to use.
+3. Copy the identifier.
+4. Pass this identifier as the category parameter in the tracking event.
+
+!!! note
+
+ This option applies only to product-related tracking events.
+
+Example:
+
+``` twig+html
+[[= include_file('code_samples/recommendations/events/category_parameter.html.twig') =]]
+```
+
### Manual `EventData` creation
-Manual creation of EventData allows precise control over the events sent to the service.
+Manual creation of `EventData` allows precise control over the events sent to the service.
It enables you to define custom event parameters, track specific user interactions, and tailor data collection to advanced use cases.
Check the following example:
diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md
index f37346e224..02469e686b 100644
--- a/docs/release_notes/ibexa_dxp_v5.0.md
+++ b/docs/release_notes/ibexa_dxp_v5.0.md
@@ -50,6 +50,15 @@ Four new recommendation blocks are available in Page Builder:
For more information, see [recommendation blocks](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/recommendation_blocks/).
+#### Category parameter for product events
+
+You can now configure which product category is sent in tracking events.
+
+Raptor accepts only a single category value.
+By default, the connector uses the first category assigned to a product, but you can override this behavior and select a different category to be included in tracking events.
+
+To learn more, see [category parameter for product events](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/tracking_php_api/#category-parameter-for-product-events).
+
#### Cookie lifetime configuration
A new `cookie_id_lifetime_days` configuration option controls the lifetime in days of the server-side tracking identifier cookie.