diff --git a/docs/docs/manuals/troubleshooting.md b/docs/docs/manuals/troubleshooting.md
new file mode 100644
index 000000000..33cd8d271
--- /dev/null
+++ b/docs/docs/manuals/troubleshooting.md
@@ -0,0 +1,28 @@
+---
+title: Troubleshoot
+---
+
+You will find some possible error messages here, what the problem is and what some possible solutions can be.
+
+## User Agent does not correspond
+
+This error appeared for some users as soon as they were redirected to the login page of ZITADEL.
+ZITADEL uses some cookies to identify the browser/user agent of the user, so it is able to store the active user sessions. By blocking the cookies the functions of ZITADEL will be affected.
+
+We only found this issue with iPhone users, and it was dependent on the settings of the device.
+
+### Solution
+
+Go to the settings of the app Safari and check in the "Experimental WebKit Features" if SameSite strict enforcement (ITP) is disabled
+Also check if "block all cookies" is active. If so please disable this setting.
+
+To make sure, that your new settings will trigger, please restart your mobile phone and try it again.
+
+**Settings > Safari > Advanced > Experimental Features > disable: „SameSite strict enforcement (ITP)“**
+
+![Same Site Strict Enforvement](/img/manuals/errors/same-site-strict.png)
+
+**Settings > Safari > disable: "Block All cookies"** 
+![Block all cookies](/img/manuals/errors/block-cookies.png)
+
+Do you still face this issue? Please contact us, and we will help you find out what the problem is.
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 81d3320b6..0f3dc94b8 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -242,6 +242,7 @@ module.exports = {
             items: ['manuals/user-register', 'manuals/user-login', 'manuals/user-passwordless', 'manuals/user-password', 'manuals/user-factors', 'manuals/user-email', 'manuals/user-phone', 'manuals/user-social-login',],
             collapsed: false,
         },
+        'manuals/troubleshooting'
     ],
     legal: [
         'legal/introduction',
diff --git a/docs/static/img/manuals/errors/block-cookies.png b/docs/static/img/manuals/errors/block-cookies.png
new file mode 100644
index 000000000..be3657956
Binary files /dev/null and b/docs/static/img/manuals/errors/block-cookies.png differ
diff --git a/docs/static/img/manuals/errors/same-site-strict.png b/docs/static/img/manuals/errors/same-site-strict.png
new file mode 100644
index 000000000..aa77fa1af
Binary files /dev/null and b/docs/static/img/manuals/errors/same-site-strict.png differ