diff --git a/docs/pages/components/nested-list.md b/docs/pages/components/nested-list.md
index a66131f249..f338e38eda 100644
--- a/docs/pages/components/nested-list.md
+++ b/docs/pages/components/nested-list.md
@@ -12,7 +12,9 @@ summary:
{: .docs-intro}
Nested List represents a nested structure with up to 10 levels.
-# Nested List Without Icons
+## Nested List Without Icons
+Use the `fd-nested-list--text-only` modifier class for a nested list with items that have only title.
+
{% capture example-1 %}
-
@@ -135,7 +137,10 @@ Nested List represents a nested structure with up to 10 levels.
-# Nested List With Icons
+## Nested List With Icons and Borderless Design
+For a nested list with icon (default) you don't need to add a modifier class.
+For a Borderless Design use the `fd-nested-list--no-border` modifier class.
+
{% capture example-2 %}
-
@@ -240,7 +245,7 @@ Nested List represents a nested structure with up to 10 levels.
-# Nested List With Icons Only in First-Level Items
+## Nested List With Icons Only in First-Level Items
{% capture example-3 %}
-
@@ -337,7 +342,7 @@ Nested List represents a nested structure with up to 10 levels.
-# Nested List With Group Headers
+## Nested List With Group Headers
{% capture example-4 %}