Update onedrive-sharepoint.mdx

docs/tutorials/integrations/onedrive-sharepoint.mdx

@@ -5,7 +5,7 @@ title: "Integrate with OneDrive & SharePoint"
 
 :::info
 
-This tutorial provides a step-by-step guide for integrating Open WebUI with **Microsoft OneDrive for Business & SharePoint**, as well as the separate, optional integration for **Personal Microsoft OneDrive** accounts. You can enable one or both integrations. This documentation is up to date as of Open WebUI v0.6.32.
+This tutorial provides a step-by-step guide for integrating Open WebUI with **Microsoft OneDrive for Business & SharePoint**, as well as the separate, optional integration for **Personal Microsoft OneDrive** accounts. You can enable one or both integrations. This documentation is up to date as of Open WebUI v0.6.37.
 
 :::
 
@@ -133,9 +133,25 @@ ONEDRIVE_CLIENT_ID_PERSONAL="zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz"
 
 ---
 
-## Final Step: Browser Configuration and Verification
+## Final Step: Enable OneDrive Integration in Admin Settings
 
-After setting your environment variables and restarting your Open WebUI instance, verify the integration.
+After setting your environment variables and restarting your Open WebUI instance, you must explicitly enable the feature in the admin panel. **The environment variables alone do not activate the integration.**
+
+1. Navigate to **Settings → Admin → Documents**.
+2. Toggle on the **"OneDrive"** switch.
+3. Refresh your browser or log out and log back in.
+
+:::warning
+
+Admin Toggle is Required
+
+This step is mandatory even though you've set `ENABLE_ONEDRIVE_INTEGRATION=true` in your environment. Some configuration options in Open WebUI are persistent database settings that are initialized on first startup but must be activated through the admin interface.
+
+:::
+
+## Verifying the Integration
+
+After enabling the admin toggle and refreshing, verify the integration is working:
 
 1. In Open WebUI, open the attachment menu (+) in the chat input. You should see menu items for **"Microsoft OneDrive (work/school)"** and/or **"Microsoft OneDrive (personal)"**, depending on your configuration.
 2. Clicking either option should trigger a pop-up window for Microsoft authentication.
@@ -143,8 +159,27 @@ After setting your environment variables and restarting your Open WebUI instance
 :::caution
 
 Disable Pop-up Blockers!
-The OneDrive file picker and authentication flow happen in a pop-up window. If nothing happens when you click a OneDrive option, it is almost certainly because your browser is blocking pop-ups. **You must disable the pop-up blocker for your Open WebUI domain** for the integration to work.
+
+The OneDrive file picker and authentication flow happen in a pop-up window. If nothing happens when you click a OneDrive option, your browser is almost certainly blocking pop-ups. **You must disable the pop-up blocker for your Open WebUI domain** for the integration to work. Note that some browsers (like Chrome) may have additional restrictions compared to others (like Edge).
 
 :::
 
+## Troubleshooting
+
+**OneDrive option not appearing in the attachment menu:**
+- Verify the admin toggle is enabled in Settings → Admin → Documents
+- Refresh your browser after enabling the toggle
+- Check that your environment variables are correctly set and the container has been restarted
+
+**Files not loading or folders not clickable:**
+- Log out of Open WebUI completely and log back in to refresh your authentication tokens
+- Verify the Azure App Registration permissions are correctly configured and admin consent is granted
+- Check browser console for any authentication errors
+
+**Authentication pop-up not appearing:**
+- Disable pop-up blockers for your Open WebUI domain
+- Try a different browser (Edge tends to work more reliably than Chrome for Microsoft authentication flows)
+
+---
+
 You have now successfully configured OneDrive integration, providing seamless file access for your users.