diff --git a/docs/_templates/sdk_template_reference.j2 b/docs/_templates/sdk_template_reference.j2
index dcd59d78..7b7148db 100644
--- a/docs/_templates/sdk_template_reference.j2
+++ b/docs/_templates/sdk_template_reference.j2
@@ -25,3 +25,15 @@ The following Jinja2 filters from <a href="https://netutils.readthedocs.io">Netu
 | {{ filter.name }} | {% if filter.trusted %}✅{% else %}❌{% endif %} |
 {% endfor %}
 <!-- vale on -->
+
+## Known issues
+
+### Unable to combine the map and sort filters (https://github.com/pallets/jinja/issues/2081)
+
+When using the `map` filter with the `sort` filter, you may encounter the following error:
+
+```python
+TypeError: 'async_generator' object is not iterable
+```
+
+**As a workaround you can use the `list` filter between `map` and `sort` filter.**
diff --git a/docs/docs/python-sdk/reference/templating.mdx b/docs/docs/python-sdk/reference/templating.mdx
index 62f1b8aa..043d8dcc 100644
--- a/docs/docs/python-sdk/reference/templating.mdx
+++ b/docs/docs/python-sdk/reference/templating.mdx
@@ -150,4 +150,16 @@ The following Jinja2 filters from <a href="https://netutils.readthedocs.io">Netu
 | vlanconfig_to_list | ✅ |
 | vlanlist_to_config | ✅ |
 | wildcardmask_to_netmask | ✅ |
-<!-- vale on -->
\ No newline at end of file
+<!-- vale on -->
+
+## Known issues
+
+### Unable to combine the map and sort filters (https://github.com/pallets/jinja/issues/2081)
+
+When using the `map` filter with the `sort` filter, you may encounter the following error:
+
+```python
+TypeError: 'async_generator' object is not iterable
+```
+
+**As a workaround you can use the `list` filter between `map` and `sort` filter.**
\ No newline at end of file