Troubleshooting Organizations & Teams
If you encounter issues when creating, accessing, or managing organizations, use this guide to resolve common problems.
Troubleshooting guide showing common issues and solutions
"Loading your workspace..." Stuck Issue
If you get stuck on a "Loading your workspace..." screen when trying to access your organization, you can resolve this by forcing a logout and re-authenticating.
In your browser, navigate directly to [portal.pieces.app/auth/logout](https://portal.pieces.app/auth/logout). This will forcefully sign you out of your current session.
Wait for the logout process to complete. You should be redirected to a sign-in page or see a confirmation that you've been logged out.
Navigate to [portal.pieces.app/auth/login](https://portal.pieces.app/auth/login) and sign back in with your account credentials.
After signing back in, you should be able to access your Personal Workspace and organizations without the loading issue.
Cannot Access Organization After Creation
If you've created an organization but cannot access it:
Verify that you received a success email confirming your organization creation. Check your spam folder if you don't see it.
Ensure you're signed in to the correct account that was used to create the organization.
Use the logout/login process described above to refresh your session.
In your Personal Workspace, check the *organization dropdown* in the sidebar to see if your organization appears in the list.
Cannot Accept Organization Invitation
If you're having trouble accepting an organization invitation:
Make sure you're clicking the invitation link from the email sent by the organization owner or admin.
Ensure you're signed in to the account that matches the email address the invitation was sent to.
If the invitation link doesn't work, try logging in directly at [portal.pieces.app/auth/login](https://portal.pieces.app/auth/login), then check your Personal Workspace for the organization.
If you still cannot accept the invitation, contact the organization owner or admin to verify the invitation status and resend if needed.
Cannot Use Pieces After Joining Organization
If you've joined a new organization but cannot use Pieces until you configure models:
In Pieces Desktop, navigate to *Settings* by clicking your profile picture in the top left and selecting `Settings`, or use the keyboard shortcut `⌘+,` (macOS) or `ctrl+,` (Windows/Linux).
In the *Settings* sidebar, click on the `Models` tab or category.
Toggle all models on, or select the specific models you want to use from the available options.
Click the `Save` button to save your model selections. After saving, you should be able to use Pieces with your organization.
Organization Not Appearing in Dropdown
If your organization doesn't appear in the organization dropdown:
Try refreshing your browser page to reload the organization list.
If you belong to multiple organizations, scroll through the *dropdown* list to find the one you're looking for.
Confirm that you're still a member of the organization. Contact the organization owner or admin if you believe you should have access.
Use the logout/login process to refresh your session and organization list.
Settings Not Syncing to Desktop
If organization settings aren't appearing in your Pieces Desktop installation:
Confirm that you're a member of the organization and that settings have been configured by an Owner or Admin.
Ensure your Pieces Desktop is connected to your account and signed in.
Try restarting your Pieces Desktop application to allow settings to sync.
In Pieces Desktop, check if there's an *organization settings* section that shows synced settings.
If settings still don't sync, contact support for assistance with organization settings synchronization.
Getting Additional Help
If you continue to experience issues after trying the solutions above, here are additional resources:
Next Steps
If you've resolved your issue, learn about managing organizations to explore admin features, or check out creating and joining organizations if you're setting up a new organization.
