diff --git a/docs/user-guide/img/button/generate_permalink.jpg b/docs/user-guide/img/button/generate_permalink.jpg
new file mode 100644
index 0000000000..ef872474b3
Binary files /dev/null and b/docs/user-guide/img/button/generate_permalink.jpg differ
diff --git a/docs/user-guide/img/share/embed-dash.jpg b/docs/user-guide/img/share/embed-dash.jpg
index 3452841eba..cbb06c86f0 100644
Binary files a/docs/user-guide/img/share/embed-dash.jpg and b/docs/user-guide/img/share/embed-dash.jpg differ
diff --git a/docs/user-guide/img/share/embed.jpg b/docs/user-guide/img/share/embed.jpg
index 6e66a9f709..bdd382ccd3 100644
Binary files a/docs/user-guide/img/share/embed.jpg and b/docs/user-guide/img/share/embed.jpg differ
diff --git a/docs/user-guide/img/share/embed_maps_size.jpg b/docs/user-guide/img/share/embed_maps_size.jpg
index 09e5849889..3f6ff97306 100644
Binary files a/docs/user-guide/img/share/embed_maps_size.jpg and b/docs/user-guide/img/share/embed_maps_size.jpg differ
diff --git a/docs/user-guide/img/share/embed_maps_toc.jpg b/docs/user-guide/img/share/embed_maps_toc.jpg
index 0f51247263..4fdc9d5a6f 100644
Binary files a/docs/user-guide/img/share/embed_maps_toc.jpg and b/docs/user-guide/img/share/embed_maps_toc.jpg differ
diff --git a/docs/user-guide/img/share/permalink.jpg b/docs/user-guide/img/share/permalink.jpg
new file mode 100644
index 0000000000..edb3ef1655
Binary files /dev/null and b/docs/user-guide/img/share/permalink.jpg differ
diff --git a/docs/user-guide/img/share/permalink_generated.jpg b/docs/user-guide/img/share/permalink_generated.jpg
new file mode 100644
index 0000000000..5052372e4e
Binary files /dev/null and b/docs/user-guide/img/share/permalink_generated.jpg differ
diff --git a/docs/user-guide/img/share/share_options.jpg b/docs/user-guide/img/share/share_options.jpg
new file mode 100644
index 0000000000..343bcabdc5
Binary files /dev/null and b/docs/user-guide/img/share/share_options.jpg differ
diff --git a/docs/user-guide/img/share/share_window.jpg b/docs/user-guide/img/share/share_window.jpg
index 1c15423706..113146553f 100644
Binary files a/docs/user-guide/img/share/share_window.jpg and b/docs/user-guide/img/share/share_window.jpg differ
diff --git a/docs/user-guide/img/share/share_window_3d_map_options.jpg b/docs/user-guide/img/share/share_window_3d_map_options.jpg
index b046c5582d..2e7f6867d9 100644
Binary files a/docs/user-guide/img/share/share_window_3d_map_options.jpg and b/docs/user-guide/img/share/share_window_3d_map_options.jpg differ
diff --git a/docs/user-guide/img/share/share_window_center_zoom.jpg b/docs/user-guide/img/share/share_window_center_zoom.jpg
index 78eb125b9d..5b2dcb592b 100644
Binary files a/docs/user-guide/img/share/share_window_center_zoom.jpg and b/docs/user-guide/img/share/share_window_center_zoom.jpg differ
diff --git a/docs/user-guide/img/share/share_window_map_options.jpg b/docs/user-guide/img/share/share_window_map_options.jpg
index aa0f889aff..866aa94431 100644
Binary files a/docs/user-guide/img/share/share_window_map_options.jpg and b/docs/user-guide/img/share/share_window_map_options.jpg differ
diff --git a/docs/user-guide/img/share/social.jpg b/docs/user-guide/img/share/social.jpg
index 7b4eb21e56..eab14d86ca 100644
Binary files a/docs/user-guide/img/share/social.jpg and b/docs/user-guide/img/share/social.jpg differ
diff --git a/docs/user-guide/share.md b/docs/user-guide/share.md
index 01c0eb6d43..fc293f85bc 100644
--- a/docs/user-guide/share.md
+++ b/docs/user-guide/share.md
@@ -12,11 +12,13 @@
From the *Share panel* the user is allowed to share a resource in different ways:
-* With a **direct link**
+* With a **Direct Link**
-* Through a **social network**
+* Through a **Social Network**
-* With **embedded code** or **APIs** (only available for *maps*)
+* Through a **Permalink** to shares current user session (only available from the [Side Toolbar](mapstore-toolbars.md#side-toolbar))
+
+* With **Embedded code** or **APIs** (only available for *maps*)
## Link
@@ -32,6 +34,21 @@ The **Social** section allows the user to share the resource on the most common
+## Permalink
+
+The **Permalink** section allows to save the current overall viewer state of the resource and share it as a permalink.
+
+
+
+A permalink is a new resource belonging to a dedicated category in [MapStore](https://mapstore.geosolutionsgroup.com/mapstore/#/) for which the user must enter the **Title** and **Description** (the last one is not mandatory) and choose whether the resource will be public by checking the **Public** option (this will generate a public map permalink so that everyone can access it).
+
+!!! Warning
+ [Map Details](resources-properties.md#details) as well as other resources connected to a map or context, if present, will not be available in the final permalink resource.
+
+When all options are filled, the user can **Generate permalink** through the button to get the **Permalink URL** or the **QR code** to share it.
+
+
+
## Embed
The **Embed** section provides to the user the needed snippets, **embedded code** or the **MS APIs** (only available for *maps*) to embed MapStore in a third party web page.
@@ -99,7 +116,7 @@ The related available options allow the user to:
In case of GeoStories, enabling the **Advanced options** in the *Share tool* the user can include the following to the share URL:
-
+
* The **Home button** to allow the possibility to bring the user to the MapStore Home Page if needed: that button will be automatically included in view mode inside the story toolbar just beside the navigation bar.