> ## Documentation Index
> Fetch the complete documentation index at: https://support.entegrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and solutions for user management in Entegrata

## Common Issues

This guide helps you resolve common problems encountered when managing users in Entegrata.

## Login and Access Issues

### User Cannot Log In

<AccordionGroup>
  <Accordion title="Recently Created User Cannot Access System">
    **Symptoms:**

    * User receives "Invalid credentials" error
    * User account exists in admin panel
    * Status shows as Active

    **Possible Causes & Solutions:**

    1. **Password not set**
       * Verify password setup process was completed
       * Send password reset instructions
       * Check if SSO/Azure Entra ID is properly configured
    2. **Wrong email used**
       * Confirm user is using Account Email, not Contact Email
       * Check for typos in email address
       * Verify no extra spaces in email field
    3. **Browser cache issues**
       * Clear browser cache and cookies
       * Try incognito/private browsing mode
       * Test with different browser
  </Accordion>

  <Accordion title="User Lost Access After Email Change">
    **Symptoms:**

    * User could log in before
    * Account email was recently changed
    * Old credentials no longer work

    **Solutions:**

    1. Verify new email address is correct
    2. Ensure user was notified of email change
    3. User must log in with new account email
    4. Clear saved passwords in browser
    5. Update any SSO configurations
  </Accordion>

  <Accordion title="Deleted User Trying to Access">
    **Symptoms:**

    * User status shows as Deleted
    * All login attempts fail
    * User not visible in active list

    **Resolution:**

    * Soft-deleted users cannot log in
    * Requires database admin to restore
    * Contact support for user recovery
    * Consider creating new user if appropriate
  </Accordion>
</AccordionGroup>

## Search and Display Issues

### Users Not Appearing in List

<AccordionGroup>
  <Accordion title="Recently Created User Not Visible">
    **Possible Causes:**

    1. **Page not refreshed**
       * Refresh browser (F5 or Cmd+R)
       * Navigate away and back to user list
    2. **Pagination issue**
       * Check if on correct page
       * New user might be on different page
       * Sort by creation date to find recent users
    3. **Search filter active**
       * Clear search box
       * Remove any active filters
       * Check URL for query parameters
  </Accordion>

  <Accordion title="Search Not Finding Users">
    **Troubleshooting Steps:**

    1. **Check search syntax**
       * Remove special characters
       * Try partial name matches
       * Search by email domain
    2. **Timing issues**
       * Wait for 500ms debounce
       * Don't type too quickly
       * Let search complete
    3. **Case sensitivity**
       * Search is case-insensitive
       * Try different capitalizations anyway
       * Remove accents from names
  </Accordion>
</AccordionGroup>

## Form and Validation Errors

### Cannot Save User Changes

<AccordionGroup>
  <Accordion title="Create/Edit Button Disabled">
    **Check for:**

    * All required fields filled
    * Valid email format
    * No trailing spaces
    * Name field not empty
    * Network connectivity

    **Solutions:**

    * Tab through all fields to trigger validation
    * Copy/paste to remove hidden characters
    * Check browser console for errors
  </Accordion>

  <Accordion title="Email Validation Failing">
    **Common Issues:**

    1. **Invalid format**
       * Must be `user@domain.com` format
       * No spaces allowed
       * Special characters limited to `.` `-` `_`
    2. **Duplicate email**
       * Email already in use
       * Check deleted users (via database)
       * Try different email
    3. **Copy/paste problems**
       * Remove any invisible characters
       * Type email manually
       * Check for extra spaces
  </Accordion>
</AccordionGroup>

## Performance Issues

### Slow Loading Times

<AccordionGroup>
  <Accordion title="User List Takes Long to Load">
    **Optimization Steps:**

    1. **Reduce page size**
       * Currently fixed at 20 users/page
       * Cannot be changed in UI
       * Use search to filter results
    2. **Network optimization**
       * Check internet connection speed
       * Try wired connection
       * Reduce concurrent browser tabs
    3. **Browser performance**
       * Clear browser cache
       * Update to latest browser version
       * Disable unnecessary extensions
  </Accordion>

  <Accordion title="Search Response Delays">
    **Improvements:**

    * Be more specific with search terms
    * Wait for debounce (500ms) to complete
    * Avoid rapid consecutive searches
    * Use exact email if known
  </Accordion>
</AccordionGroup>

## Data Integrity Issues

### Inconsistent User Data

<AccordionGroup>
  <Accordion title="Changes Not Persisting">
    **Diagnostic Steps:**

    1. **Verify save completed**
       * Look for success toast
       * Check for error messages
       * Refresh page to confirm
    2. **Concurrent editing**
       * Another admin might be editing
       * Changes might be overwritten
       * Coordinate with team
    3. **Cache issues**
       * Hard refresh (Ctrl+Shift+R)
       * Clear browser data
       * Try incognito mode
  </Accordion>

  <Accordion title="Duplicate Users Appearing">
    **Resolution Process:**

    1. **Identify duplicates**
       * Compare email addresses
       * Check creation dates
       * Review user IDs
    2. **Clean up**
       * Delete duplicate entries
       * Keep most recent/complete record
       * Transfer any unique data
    3. **Prevention**
       * Search before creating
       * Establish naming conventions
       * Document user creation
  </Accordion>
</AccordionGroup>

## Integration Problems

### Azure Entra ID Issues

<AccordionGroup>
  <Accordion title="SSO Not Working">
    **Check:**

    * Entra ID field populated
    * Correct tenant configuration
    * User exists in Azure AD
    * Proper permissions granted

    **Actions:**

    * Verify Azure configuration
    * Check authentication logs
    * Test with different user
    * Contact identity team
  </Accordion>

  <Accordion title="Sync Problems">
    **Common Causes:**

    * Manual process (no auto-sync)
    * Field mapping issues
    * Permission problems
    * Network connectivity

    **Solutions:**

    * Manually update user records
    * Verify API permissions
    * Check Azure audit logs
    * Plan manual sync schedule
  </Accordion>
</AccordionGroup>

## Error Messages Reference

### Common Error Messages and Solutions

| Error Message             | Cause                         | Solution                                                |
| ------------------------- | ----------------------------- | ------------------------------------------------------- |
| "User not found"          | User deleted or doesn't exist | Verify user ID, check if deleted                        |
| "Email already exists"    | Duplicate email address       | Use different email or find existing user               |
| "Invalid email format"    | Malformed email address       | Check format: [user@domain.com](mailto:user@domain.com) |
| "Required field missing"  | Empty required field          | Fill in all required fields                             |
| "Network error"           | Connection issue              | Check internet, retry operation                         |
| "Permission denied"       | Insufficient privileges       | Verify admin access rights                              |
| "Session expired"         | Login timeout                 | Log in again                                            |
| "Concurrent modification" | Another user editing          | Refresh and retry                                       |

## Browser-Specific Issues

### Supported Browsers

<Tip>
  For best experience, use latest versions of these officially supported browsers:

  * Chrome (recommended)
  * Edge (Chromium-based)
</Tip>

Support for Firefox & Safari will come soon. Admin App features *may* work in Firefox & Safari, but those are not officially supported browsers as of March 2026.

### Browser Troubleshooting

<Tabs>
  <Tab title="Chrome">
    **Common Fixes:**

    * Clear cache: Settings → Privacy → Clear browsing data
    * Disable extensions: chrome://extensions
    * Reset settings: Settings → Advanced → Reset
  </Tab>

  <Tab title="Edge">
    **Common Fixes:**

    * Clear cache: Settings → Privacy → Clear browsing data
    * InPrivate mode: Ctrl+Shift+N
    * Reset Edge: Settings → Reset settings
  </Tab>

  <Tab title="Firefox">
    **Common Fixes:**

    * Clear cache: Settings → Privacy & Security → Clear Data
    * Safe mode: Help → Restart with Add-ons Disabled
    * Refresh Firefox: about:support → Refresh Firefox
  </Tab>

  <Tab title="Safari">
    **Common Fixes:**

    * Clear cache: Develop → Empty Caches
    * Disable extensions: Preferences → Extensions
    * Reset Safari: Safari → Clear History
  </Tab>
</Tabs>

## Getting Help

### When to Contact Support

Contact support if you encounter:

* Database errors or corruption
* Unable to access admin panel
* Bulk operation failures
* Data loss or recovery needs
* Integration failures
* Security concerns

### Information to Provide

When contacting support, include:

<Card>
  **Essential Information:**

  * User email/ID affected
  * Error messages (exact text)
  * Steps to reproduce
  * Browser and version
  * Screenshots if applicable
  * Time of occurrence
  * Recent changes made
</Card>

### Self-Service Resources

Before contacting support:

1. Check this troubleshooting guide
2. Review related documentation
3. Clear browser cache
4. Try different browser
5. Verify network connectivity
6. Check with other administrators

## Prevention Best Practices

### Regular Maintenance

<Note>
  **Recommended routine:**

  * Weekly: Review user list for anomalies
  * Monthly: Audit deleted users
  * Quarterly: Clean up duplicates
  * Annually: Full user audit
</Note>

### Documentation

Maintain records of:

* User creation/deletion reasons
* Email change justifications
* Access issues and resolutions
* Common problems in your organization

## Related Documentation

<CardGroup cols={2}>
  <Card href="/administration/user/overview" title="User Overview">
    Understanding user management basics in the platform
  </Card>

  <Card href="/administration/user/user-management" title="User Management">
    Learn how to view, add, edit, deactivate, and delete users
  </Card>
</CardGroup>