diff --git a/docs/user-guide/img/widgets/table-attribute.gif b/docs/user-guide/img/widgets/table-attribute.gif
new file mode 100644
index 0000000000..851aaf627b
Binary files /dev/null and b/docs/user-guide/img/widgets/table-attribute.gif differ
diff --git a/docs/user-guide/img/widgets/table-description.gif b/docs/user-guide/img/widgets/table-description.gif
new file mode 100644
index 0000000000..22aa969cba
Binary files /dev/null and b/docs/user-guide/img/widgets/table-description.gif differ
diff --git a/docs/user-guide/img/widgets/table-ex.jpg b/docs/user-guide/img/widgets/table-ex.jpg
index dad05d5cc9..02173540fc 100644
Binary files a/docs/user-guide/img/widgets/table-ex.jpg and b/docs/user-guide/img/widgets/table-ex.jpg differ
diff --git a/docs/user-guide/img/widgets/table-panel.jpg b/docs/user-guide/img/widgets/table-panel.jpg
index c6d0eef6ee..fa7f43e675 100644
Binary files a/docs/user-guide/img/widgets/table-panel.jpg and b/docs/user-guide/img/widgets/table-panel.jpg differ
diff --git a/docs/user-guide/img/widgets/table-title.gif b/docs/user-guide/img/widgets/table-title.gif
new file mode 100644
index 0000000000..f272f2afe2
Binary files /dev/null and b/docs/user-guide/img/widgets/table-title.gif differ
diff --git a/docs/user-guide/widgets.md b/docs/user-guide/widgets.md
index fa0e4c79ff..0b7f75c0de 100644
--- a/docs/user-guide/widgets.md
+++ b/docs/user-guide/widgets.md
@@ -263,11 +263,23 @@ Adding a table widget to the map, a panel like the following opens:
-The toolbar on the top of this panel is similar to the one present in [Chart section](#chart). Here the user is allowed to select the layer fields that will be displayed in the widget.
+The toolbar on the top of this panel is similar to the one present in [Chart section](#chart). Here the user is allowed to:
+
+* **Enable/Disable** the layer fields that will be displayed in the widget as columns.
+
+
!!!warning
At least one field must be selected in order to move to the next configuration step.
+* Enter a **Title** for each column to be displayed as the table header in place of the *Name* of the layer field
+
+
+
+* Enter a **Description** for each field to be displayed as a tooltip, visible moving the mouse on the column header.
+
+
+
Once the desired fields are selected, a click on the button opens the following panel: