Skip to main content

Troubleshooting Common Issues

This page collects the problems users encounter most often and walks you through how to resolve them.

Login and Authentication​

I cannot sign in​

  1. Verify you are using the correct organization URL.
  2. Check that your Azure AD / SSO credentials are valid. Password resets are handled by your identity provider, not inside Booga Enterprise.
  3. Clear your browser cookies and cache, then try again.
  4. If your account was recently created, confirm with your administrator that provisioning is complete.

I am signed out unexpectedly​

Session tokens expire after a period of inactivity. Sign in again and your previous work is preserved. If you are logged out repeatedly within minutes, check whether your browser is blocking third-party cookies required for the authentication flow.

Multi-factor authentication is failing​

MFA is managed by your organization's identity provider. Ensure your authenticator app is synchronized and that you are entering the code before it expires. Contact your IT team if the issue persists.

Dashboard and Navigation​

The dashboard shows "Setup Your Workspace"​

This means your tenant does not yet have AI infrastructure stacks provisioned. A tenant administrator needs to go to the Admin Portal and configure at least one stack before plugins become available.

Plugins are missing from the sidebar​

  • Your product plan may not include the plugin. Ask your administrator to check the product configuration.
  • Your role may not have the required permission. Administrators can adjust role permissions in Admin Portal > Permissions.
  • If the tenant is a Corporate Signup, only the base dashboard is available until full provisioning.

Tabs are missing or out of order​

Dashboard tabs are configured per product. If a tab has disappeared, click the + button in the tab bar to add it back. To restore the original order, use the Restore Defaults option.

Files and Uploads​

File upload fails​

  • Check that the file does not exceed the maximum size allowed by your tenant's quota.
  • Verify you have remaining storage quota (visible in the Files interface or via Admin Portal > Usage).
  • Try a different browser or disable browser extensions that may interfere with uploads.
  • If the upload stalls, refresh the page and retry. Partially uploaded files are cleaned up automatically.

I cannot preview a file​

Preview is available for common file types (PDF, images, Office documents, plain text). If the preview panel shows an error:

  • Confirm the file finished uploading successfully (check for a progress indicator).
  • Try downloading the file instead and opening it locally.
  • Very large files may take a moment to render; wait a few seconds.

Chat and AI​

Chat responses are slow or empty​

  • Verify that at least one AI infrastructure stack is active (shown in the Stack selector in the header).
  • Check your internet connection; responses stream in real time.
  • If knowledge search is enabled, the AI may take longer while scanning documents. This is normal for large knowledge bases.

Citations show "source not found"​

The cited document may have been deleted or its knowledge index may need refreshing. Try searching for the document in the Knowledge plugin. If it has been re-uploaded, the index updates automatically within a short time.

Performance​

Pages load slowly​

  1. Refresh the page — a single slow load is often a transient network issue.
  2. Close unused browser tabs; each open tab consumes memory.
  3. Check your internet connection speed.
  4. If the problem is consistent, ask your administrator to review the infrastructure health in Admin Portal > Infrastructure.

The interface feels unresponsive​

  • Make sure you are using a supported, up-to-date browser (Chrome, Edge, Firefox, Safari).
  • Disable browser extensions that inject scripts into every page (ad blockers, translation tools).
  • On mobile, ensure your device has enough free memory.

Help System​

Contextual help does not appear​

  • The floating ? button should be visible in the bottom-right corner of every page. If it is missing, try refreshing.
  • If help loads but shows no content, the documentation for that specific page may not be published yet. Use the search bar inside the help panel to find related topics.

Guided tour does not start​

  • Tours require the help content to be synced. If a tour refuses to start, the tour data may still be loading.
  • Ensure pop-up blockers are not preventing the tour overlay from rendering.

Still Stuck?​

If none of the above resolves your issue:

  1. Search the help center — click the ? button and use the search bar.
  2. Contact your administrator — they can review audit logs and system health.
  3. Submit a support request — administrators can create tickets through Admin Portal > Support Requests.

⏱️ Read time: 8 minutes | 📊 Difficulty: beginner | 🔄 Last updated: 2026-03-28