From 35bdb291485540a44429cdabf07f321389fd3ca7 Mon Sep 17 00:00:00 2001
From: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com>
Date: Wed, 30 Oct 2024 10:37:06 +0100
Subject: [PATCH] IBX-9124: Dynamic attribute submodels described in User
 Documentation (#318)

* Dynamic attribute submodels

* fix

* fix

* fix after doc review
---
 docs/personalization/recommendation_models.md | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/personalization/recommendation_models.md b/docs/personalization/recommendation_models.md
index 70cd2391..da522838 100644
--- a/docs/personalization/recommendation_models.md
+++ b/docs/personalization/recommendation_models.md
@@ -214,6 +214,36 @@ The logic used for resolving a submodel is as follows:
     Recommendation are fetched from all the submodels and merged based on the weight (relevance).
     If one of the submodels delivers recommendations with better relevance, the results of other models can disappear from the list.
 
+### Dynamic attributes
+
+Dynamic attribute submodels eliminate the need for manual grouping and simplify configuration.
+They allow for simpler, faster, and less demanding recommendation models building using different attributes, because all you need to do is make one request and rebuild the model.
+
+They work best in straightforward cases when you filter by the value of the attribute.
+
+Dynamic attribute submodels:
+
+- operate only on [nominal attributes](recommendation_models#nominal-attributes) (numeric attributes are not supported)
+- can be used for [popularity](recommendation_models#popularity-models) and [collaborative](recommendation_models#collaborative-models) types of models (as they support submodels)
+- have limitation of max. 50 attribute values (if more, you need to follow the procedure of manual configuration by [[= product_name_base =]] Team)
+- operate on scenarios with the selected `Submodels` data type option
+- require sending a request and building a model
+- are calculated for all new attribute values after import
+- are always up-to-date with the imported items
+- still add new values ​​when attributes are only partially grouped manually
+- aren't added if all attributes are manually grouped (full manual intervention)
+- cannot be calculated if there is any submodel manually configured for provided attribute
+- don't operate on the values which are no longer present
+
+!!! note "Enable dynamic attribute"
+
+    Dynamic attribute must be enabled by [[= product_name_base =]] Team.
+    To start using this functionality, contact customer support (support@ibexa.co).
+
+!!! caution "Unused attributes"
+
+    If an attribute is not used for at least 5 days, all related submodels are removed.
+
 ## Time-slot based models
 
 Time-slot based models consider only a particular range of time rather than the full day when calculating recommendations.