diff --git a/README.md b/README.md
index 5e88ffb..6c1c8ef 100644
--- a/README.md
+++ b/README.md
@@ -264,7 +264,13 @@ sections = {
     {
       'mode',
       icon = nil, -- displays icon in front of the component
-      separator = nil, -- overwrites component_separators for component
+      separator = nil, -- Determines what separator to use for the component.
+                       -- when a string is given it's treated as component_separator.
+                       -- When a table is given it's treated as section_separator.
+                       -- This options can be used to set colored separators
+                       -- arround component. Option need to be set like `separator = {'', ''}`.
+                       -- Where first element is left_separator and 2nd element is right separator.
+                       -- Passing empty string disables that separator
       condition = nil, -- condition function, component is loaded when function returns true
       -- custom color for component in format
       -- color = {fg = '#rrggbb', bg= '#rrggbb', gui='style'}
diff --git a/doc/lualine.txt b/doc/lualine.txt
index c1a3a31..bed0cf1 100644
--- a/doc/lualine.txt
+++ b/doc/lualine.txt
@@ -203,7 +203,13 @@ Local options~
       {
         'mode',
         icon = nil, -- displays icon in front of the component
-        separator = nil, -- overwrites component_separators for component
+      separator = nil, -- Determines what separator to use for the component.
+                       -- when a string is given it's treated as component_separator.
+                       -- When a table is given it's treated as section_separator.
+                       -- This options can be used to set colored separators
+                       -- arround component. Option need to be set like `separator = {'', ''}`.
+                       -- Where first element is left_separator and 2nd element is right separator.
+                       -- Passing empty string disables that separator
         condition = nil, -- condition function, component is loaded when function returns true
         -- custom color for component in format
         -- color = {fg = '#rrggbb', bg= '#rrggbb', gui='style'}