diff --git a/docs/docs/features/img/partner-sharing-1.png b/docs/docs/features/img/partner-sharing-1.png
index 49ab3aa402..48785a353c 100644
Binary files a/docs/docs/features/img/partner-sharing-1.png and b/docs/docs/features/img/partner-sharing-1.png differ
diff --git a/docs/docs/features/img/partner-sharing-2.png b/docs/docs/features/img/partner-sharing-2.png
index 8cfc8e39c1..086795b232 100644
Binary files a/docs/docs/features/img/partner-sharing-2.png and b/docs/docs/features/img/partner-sharing-2.png differ
diff --git a/docs/docs/features/img/partner-sharing-3.png b/docs/docs/features/img/partner-sharing-3.png
index 7aa2590f68..a8627cf859 100644
Binary files a/docs/docs/features/img/partner-sharing-3.png and b/docs/docs/features/img/partner-sharing-3.png differ
diff --git a/docs/docs/features/img/partner-sharing-4.png b/docs/docs/features/img/partner-sharing-4.png
new file mode 100644
index 0000000000..eca121ff78
Binary files /dev/null and b/docs/docs/features/img/partner-sharing-4.png differ
diff --git a/docs/docs/features/img/partner-sharing-5.png b/docs/docs/features/img/partner-sharing-5.png
new file mode 100644
index 0000000000..3759e13d9a
Binary files /dev/null and b/docs/docs/features/img/partner-sharing-5.png differ
diff --git a/docs/docs/features/img/partner-sharing-6.png b/docs/docs/features/img/partner-sharing-6.png
new file mode 100644
index 0000000000..b9aee5143a
Binary files /dev/null and b/docs/docs/features/img/partner-sharing-6.png differ
diff --git a/docs/docs/features/img/partner-sharing-7.png b/docs/docs/features/img/partner-sharing-7.png
new file mode 100644
index 0000000000..4cd4be60b5
Binary files /dev/null and b/docs/docs/features/img/partner-sharing-7.png differ
diff --git a/docs/docs/features/partner-sharing.md b/docs/docs/features/partner-sharing.md
index fa9367fbda..c80ff384f3 100644
--- a/docs/docs/features/partner-sharing.md
+++ b/docs/docs/features/partner-sharing.md
@@ -1,17 +1,57 @@
 # Partner Sharing
 
-Immich allows you to share your library with other users. They can then view your library and download the assets.
-
-You can manage one or multiple users to have access to your library from the [User Settings](docs/features/user-settings.md) page.
-
-<img src={require('./img/partner-sharing-1.png').default} title='Partner Sharing 1' />
-
-<img src={require('./img/partner-sharing-2.png').default} title='Partner Sharing 2' />
-
-Accessing the shared library can be done from the Sharing page.
-
-<img src={require('./img/partner-sharing-3.png').default} title='Partner Sharing 3' />
-
 :::tip Sharing specific assets
 For sharing a specific set of assets, you can use the shared album feature of Immich.
 :::
+
+Immich allows you to share your library with other users. They can then view your library and download the assets. You can manage Partner Sharing from the [User Settings](docs/features/user-settings.md) page on the web.
+
+Partner Sharing includes:
+
+- Access to all non-archived and trashed photos and videos.
+- Access to all metadata, including GPS information.
+- Access to share assets via shared links, albums, etc.
+
+:::info
+Partner sharing is one-way. To view your partner's assets, they must also share them with you.
+:::
+
+## Sharing with a Partner
+
+:::note Duplicates
+Partner sharing may result in displaying duplicate assets on the main timeline.
+:::
+
+<img src={require('./img/partner-sharing-1.png').default} width="70%" title='Add Partner 1' />
+
+<img src={require('./img/partner-sharing-2.png').default} width="70%" title='Add Partner 2' />
+
+<img src={require('./img/partner-sharing-4.png').default} width="70%" title='Add Partner 4' />
+
+## Viewing Partner Assets
+
+Access partner assets via the Sharing page.
+
+<img src={require('./img/partner-sharing-3.png').default} width="70%" title='Access to the Shared Library' />
+
+## Timeline Integration
+
+Partner shared photos can be displayed in the main timeline. This feature can be enabled on a per-partner basis and can be viewed and updated on both the web and mobile app.
+
+### Web:
+
+Account Settings -> Sharing -> Show in timeline
+
+<img src={require('./img/partner-sharing-5.png').default} width="70%" title='Partner Sharing for the web interface' />
+
+### Mobile App:
+
+From the partner’s view, on the top right corner of the app bar
+
+<img src={require('./img/partner-sharing-6.png').default} width="30%" title='Partner Sharing for the mobile app' />
+
+## Removing Access
+
+In order to remove a partner, you can go to User -> Account Settings -> Sharing and click on the X button.
+
+<img src={require('./img/partner-sharing-7.png').default} width="70%" title='Remove Partner' />