FAQ and troubleshooting
How to fix the most common problems when uploading Excel, connecting sources, reviewing, building, asking Si, linking Slack or Telegram, using MCP and hitting plan limits.
Data and sources
My Excel file was rejected. Check that it is really .xlsx (not .xls or .csv), no larger than 50 MB, at most 200,000 rows per sheet, with no blank cells in row 1 and no two columns with the same name. The error message names the sheet. See Excel files.
Is it a problem if the data_dictionary sheet is missing? No. DataxLand still reads the file and infers column types and meanings from the data; Si will just ask more questions. If you do include the sheet, it must have the table_name, column_name, data_type and description columns.
I can't pick PostgreSQL, BigQuery or a connector. The Free plan only accepts one Excel file. Upgrade to Starter or above. See Plans and quotas.
A marketplace shows "Contact us to enable" (the server has no app keys for it). That marketplace connection is not set up on this server. In the meantime, use the marketplace's export with Excel files.
Test connection says "Couldn't connect". Check the host, port, user, password and SSL; whether the database blocks our IP; and, for connectors, that the API key is still valid and has enough permissions.
CDC shows "Not passed". Fix each item using the table on the PostgreSQL page, then click Check CDC requirements again.
My 15- or 30-minute schedule doesn't run. These two frequencies need the Small Business plan or above, and every source must sync incrementally or with CDC. A schedule your plan doesn't include is skipped, with the reason shown.
Review and build
I can't see the Approve button. Approving needs the Admin or Owner role.
I can't approve: "Every row needs a standard status before approval". Open Review proposal → Statuses and pick a standard status for every status value in your source.
The build is "Blocked". A blocking check failed, or the built numbers don't match the source. Dashboards keep showing the previously published version. See Checked numbers, fix the source data and refresh.
A metric is missing from the dashboard. Look at the Metrics not available yet section in the Approve and build step: usually data is missing (for example no cost of goods yet) or an implausible number has been hidden for now.
Asking Si
Si says "Couldn't answer this question". The metric it needs doesn't exist yet, or the question is unclear. Be more specific (metric, period, breakdown), check the metric handbook, or create a workspace metric.
Si misunderstands a term your business uses. Add a Term entry on the Knowledge page and approve it.
I can't see Ask Si. The Viewer role cannot ask Si; ask the Owner to change your role to Analyst.
"This month's Si questions are used up". Wait for the next period, buy 500 more questions, or upgrade. Dashboards and reports keep running.
Slack, Telegram, MCP
The bot doesn't answer in a group. In groups, the bot only reads /ask, messages that mention it and replies to its own messages. The group must be bound to a workspace with /ws, and the person asking must have linked their account. See Telegram and Slack.
My link code is rejected. Codes are single-use, expire after 10 minutes and are only accepted in a private chat with the bot. Create a new code.
I can't create an MCP token. MCP needs the Small Business plan or above and the Admin role. A token is shown only once; if you lose it, revoke it and create a new one. See MCP server.
Account
I lost the phone with my 2FA app. Sign in with one of your 10 recovery codes, then set up 2FA again. See Two-factor authentication.
I deleted a workspace by mistake. The Owner can restore it within 7 days from Account → Workspaces pending deletion → Restore.
Related
Offline license
The license file of a self-hosted installation - what it contains, how to mount it as a Secret, the states and what they mean, the grace period, a read-only mode that never locks your data, renewal, the license-status command and the dx_license_days_left metric.
Glossary
What the terms used in DataxLand mean — workspace, Si, proposal, mapping, semantic layer, confirmation level, build, publish, CDC, PII, MCP and more.