Troubleshooting
Fix sign-in problems, the Outlook add-in, pages that look wrong after an update, disconnected integrations, emails that didn't send and permission messages.
Most problems in XODASH have a quick fix. Find the section that matches what you're seeing. If nothing here helps, contact support with the exact message you saw.
Sign-in problems
You don't know your workspace address
Each workspace has its own address, such as https://yourcompany.xodash.io.
- Open
https://xodash.io/login. Without a workspace in the address, it shows Find your workspace. - Type the email you use for XODASH and choose Email my workspace links.
- Open the email. XODASH sends a sign-in link for each of your workspaces. The page looks the same whether or not the address has an account.
If no email arrives, check that you typed the address you were invited with. Links are sent only to active users, at most three emails an hour per address. After several searches you see "Too many workspace searches for this email" with how long to wait.
"Too many sign-in attempts for this account"
After many wrong passwords in a short time, sign-in pauses for that account. The message says how long to wait. Signing in successfully never counts against you. If you've forgotten your password, choose Forgot password? on the sign-in page and then Send reset link. Reset emails are limited too, so wait before asking for another.
"Too many incorrect codes"
After five wrong two-factor codes, backup codes included, sign-in is locked for 15 minutes. Wait, then sign in again with your password and a fresh code from your authenticator app. Check that your phone's clock is set automatically, since codes depend on the time.
If you've lost your authenticator, enter one of your backup codes on the two-factor step. See I lost the phone with my authenticator app in the FAQ.
Single sign-on doesn't start
Continue with SSO works only from your workspace's own address. If you see "Please access your
workspace via your subdomain", go to https://yourcompany.xodash.io/login and try again. If your
identity provider refuses you, ask your workspace admin to check the SSO settings.
You're signed out sooner than expected
You stay signed in for the Session Duration set in Settings → Profile, and a session with no activity for 24 hours ends. A new duration applies the next time you sign in.
A page looks wrong after an update
When XODASH is updated while your tab is open, the page notices and reloads once by itself. You may briefly see "Loading the latest version of XODASH…".
If a page still looks broken, has no styling or shows Something went wrong:
- Choose Try again if it's offered.
- Reload the page in your browser.
- If the problem stays, note the Ref code shown under the message and contact support.
The Outlook add-in
The add-in doesn't appear in Outlook
The add-in has to be deployed by your Microsoft 365 admin from the Microsoft 365 admin center. It can take 24 to 72 hours to appear after deployment, and restarting Outlook helps. Your CRM Admin can find the install steps and the manifest address in Settings → CRM → Outlook.
"The Outlook add-in is turned off for your workspace"
A CRM Admin has switched the add-in off. They can turn it back on in Settings → CRM → Outlook.
"CRM is not enabled for you" or "Your XODASH role cannot view people and companies"
The add-in shows CRM records, so you need a CRM role. Ask your workspace admin to give you one in Settings → Team.
The add-in looks out of date or a new feature is missing
The pane's footer shows its version, for example XODASH - Outlook · v1.2.0.0. Most changes reach the pane on their own. When a release announces a new add-in version, your Microsoft 365 admin updates it once: Microsoft 365 admin center → Settings → Integrated apps → XODASH → Update, giving the manifest address or file again. Custom add-ins don't update on their own.
The add-in asks you to sign in again
The pane stays signed in for up to 12 hours after you sign in. After that, choose Sign in to XODASH again.
You can't use a shared mailbox
Shared mailboxes are off until a CRM Admin turns them on in Settings → CRM → Outlook. Then each person chooses Reconnect for shared mailboxes once in Settings → Integrations → Outlook. Shared mailboxes work in Outlook on the web, new Outlook and classic Outlook, not on phones.
An integration is disconnected
When a connection's sign-in stops working, XODASH shows a notice such as "Outlook needs to be reconnected", and its owner is told once.
Open your integrations
Choose Reconnect on the notice, or go to Settings → Integrations.
Reconnect the connection
Find the connection and choose Reconnect. Sign in to the other service when it asks.
Check that it syncs
The notice clears once the connection is healthy again.
On the Files page, a folder that can't load because of an expired sign-in says "This connection needs to be reconnected", with a Reconnect button.
An email didn't send
Campaign emails
Campaigns send from a connected Microsoft Outlook mailbox, so the sender's Outlook connection must be working. A campaign's results list sends that failed as Not sent (Microsoft refused it, or the mailbox couldn't be used) or Outcome unknown (Microsoft didn't confirm it). Failed sends are never resent on their own.
To send it to the people who missed it:
- If the Outlook connection needs to be reconnected, reconnect it first.
- On the campaign, choose Resend to failed. Tick the extra box only if you also want to resend to Outcome unknown recipients, who may get the email twice.
People who unsubscribed never receive marketing email, so they won't get a campaign however it's sent.
Follow-ups and Agent drafts
Follow-up emails and drafts the Agent plans don't send until someone approves them. Look for them in Approvals.
Permission messages
When your role doesn't allow something, XODASH says so in plain words, for example "Only CRM admins can import folder links." Some buttons are hidden or disabled instead.
- Workspace roles (such as Admin, Member and Viewer) decide what you can do across XODASH. Some Settings tabs, such as Team, SSO, Branding and API, are for workspace Admins.
- CRM roles (CRM Admin, CRM Editor, CRM Viewer) decide what you can do with deals, quotes, contracts and other CRM records. CRM Viewers can read but not change them, and don't see prices and totals. Creating and editing companies and contacts follows your workspace role instead.
- QuickBooks roles (QuickBooks Admin, QuickBooks View, No QuickBooks) are separate from your workspace role.
- Private records belong to one person. Even admins can't open someone else's private record.
To change your access, ask your workspace admin. They set roles in Settings → Team. See Users and roles.