Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Error codes

This page lists the error messages Fresco BI shows, what each one means and what to do.

  • Code is the short name of the error. The app shows it in a few places, for example Error code: … in the refresh history, or The connection failed (error code …) after a connection test. Quote the code when you contact support.
  • Message is the text the app shows, in English. The app shows the same message in Vietnamese when you use Vietnamese.
  • A dash (—) means the message has no code.
Code Message Meaning What to do
— Something went wrong, please try again An unexpected error. Try again. If it keeps happening, contact support.
forbidden You do not have permission to do this Your role or share does not allow this action. Ask an admin of the organization or workspace for access.
— Not found The item does not exist, was deleted, or you cannot see it. Check the link. Look in the Trash.
unauthenticated Your session has expired, please sign in again You were signed out, for example after a time without activity. Sign in again.
rate-limited Too many requests, try again in N s You did the same action too often in a short time. Wait the time shown, then try again.
csrf The request was refused, reload the page The page is out of date. Reload the page.
validation-error Some fields are not valid A field is empty or has a wrong value. Fix the marked fields.
not-ready The service is starting, try again later Fresco BI is starting up. Wait a minute, then try again.
reauth-required Please sign in again to confirm A sensitive action needs a fresh sign-in. Sign in again, then repeat the action.
Code Message Meaning What to do
— Sign-in did not complete. Please try again. The sign-in page returned an error. Click Sign in again.
— Sign-in was cancelled. Press “Sign in” when you want to continue. You left the sign-in page. Click Sign in when ready.
— Verify your e-mail to get started Your e-mail is not verified yet. Open the verification e-mail, click its link, then click I have verified it, sign in again.
— You do not belong to any organization yet Nobody has invited you, and you have no personal organization. Ask an administrator of your organization to invite your e-mail.
email-not-verified Verify your e-mail first The action needs a verified e-mail. Verify your e-mail, then try again.
keycloak-unavailable The sign-in service is unavailable, try again later The sign-in service does not answer. Try again in a few minutes.
org-auth-method-not-allowed This organization does not accept the way you signed in The organization allows only some sign-in methods. Sign out and sign in again with a method the screen lists.
org-mfa-required This organization requires two-step verification Your account has no two-step verification. Set up two-step verification in Account › Security, then sign out and sign in again. See Account security.
org-auth-lockout This policy would lock you or the Owner out of the organization The sign-in policy you chose would block you or the Owner. Allow a method that you and the Owner use.
sso-not-configured Company SSO is not set up SSO is not ready for this organization. Sign in with another method. SSO is coming soon.
mfa-required Re-authentication required The action needs your two-step code. Enter your MFA code.
mfa-invalid Wrong MFA code The code is wrong or too old. Enter the current code from your app.
— Your organization requires two-step verification. Add another method first. You tried to remove your last two-step method. Add another method before you remove this one.
— You already have 10 active keys You reached the API key limit. Revoke a key you no longer use.
— This organization does not allow personal API keys. The organization turned API keys off. Ask an organization admin.

These messages show when you save a data source or click Test connection. See Connect data.

Code Message Meaning What to do
invalid-config The connection settings are not valid A setting is missing or wrong. Check the marked fields.
datasource-not-found Data source not found The data source was deleted. Look in the Trash, or create it again.
datasource-name-taken A data source with this name exists The name is already used. Choose another name.
datasource-in-use A data table uses this data source; remove its tables from the data table first Data Tables still read from this source. Delete those Data Tables first.
datasource-incomplete The data source has no saved credential The password or key was never saved. Edit the data source and enter the password again.
source-error The data source returned an error The database refused the request. Check the account’s rights on the database.
source-timeout The data source answered too slowly The database took too long. Try again later. Check the load on the database.
runner-unavailable The connector service is not available, try again in a few minutes The Fresco BI service that talks to sources is busy or restarting. Try again in a few minutes.
network-mode-unsupported This source type does not support that network mode This source type cannot use the connection type you chose. Choose the other connection type.
feature-not-in-plan This feature needs the Fresco Enterprise plan This is an Enterprise connector. See Plans.
— Account can write: blocked The database account can write data. Fresco BI only reads, so it refuses to save. Use a database account with read-only access.

After a failed Test connection, the app shows one of these codes.

Code Message What to do
invalid_config The connection settings are not valid: check the marked fields. Fix the marked fields.
blocked_address The host is in a blocked range (private, loopback or metadata). A database inside a private network needs an On-premises connection through a Gateway. Use On-premises (via Gateway). See Gateway Agent.
dns_failure The host name could not be resolved (DNS). Check the Host field. Check the spelling of the host.
network_unreachable No connection could be opened to this host and port. Check the host, the port, and that the firewall allows Fresco BI’s IP. Check host and port. Allow Fresco BI’s IP addresses on the firewall.
timeout The server did not answer in time. Usually a firewall that drops packets, or a wrong host or port. Check the firewall, host and port.
tls_error The SSL connection could not be set up with the chosen mode. Check the SSL mode and the CA certificate. Pick another SSL mode or paste the right CA certificate.
ssh_host_key_mismatch The SSH server’s host key differs from the pinned fingerprint. Ask the bastion’s administrator before pinning it again. Confirm with the bastion’s administrator before you trust the new key.
ssh_host_key_unknown The SSH host key is not confirmed yet. Confirm the fingerprint and test again. Compare the fingerprint, click Trust this key, then test again.
auth_failed The server rejected the user name or password. Fix the user or password.
permission_denied The database user cannot read this object. Grant the account read access to the object.
not_found The database or object was not found on the server. Check the database, schema and table names.
schema_drift The source table no longer matches the data table. The columns changed on the source. Load the table again.
unsupported The source returned a data type this connector does not support. Leave out that column, or convert it in a view on the source.
limit_exceeded A size or concurrent-connection limit was exceeded. Try again later, or load less data.
cancelled The operation was cancelled. Start it again.
internal The connector failed unexpectedly while talking to the source. Try again. If it keeps happening, contact support.
any other The connection failed (error code …). Contact support with the code.

Some codes come with a more precise reason:

Code Message
tls_error.server_no_tls The server does not support SSL but the chosen mode requires encryption. Enable SSL on the server or pick a mode that does not require it.
tls_error.certificate_untrusted The server certificate is not signed by a trusted CA. Paste the right CA into the CA certificate field.
tls_error.hostname_mismatch The server certificate was not issued for the host name entered. Use the name in the certificate or a mode that checks the CA only.
tls_error.server_requires_tls The server requires encryption but the chosen mode does not encrypt. Pick an encrypting SSL mode.
auth_failed.tls_required_for_auth This MySQL account needs an SSL connection to send its password. Pick SSL mode required or stronger.
network_unreachable.connection_refused The server refused the connection on this port: nothing listens there or a firewall rejects it.
network_unreachable.no_route There is no network route to the host. A database inside a private network needs an On-premises connection through a Gateway.
invalid_config.ca_required The verify-ca mode needs a CA certificate.

Errors that the Gateway Agent prints on the agent machine are listed in Gateway Agent.

Code Message Meaning What to do
gateway-unavailable No Gateway Agent of this cluster is online. Check the Agent machine and the Gateways page. No member of the gateway is online. Check the agent service and outbound port 443 on the agent machine.
gateway-offline The gateway is offline; the connection cannot be tested Same, during Test connection. As above.
gateway-cluster-required Choose a gateway cluster for an On-premises source You chose On-premises without a gateway. Pick a gateway cluster.
gateway-required Choose a gateway cluster Same as above. Pick a gateway cluster.
gateway-not-supported This source type connects as Cloud only, not through a gateway This source type cannot use a gateway. Use Cloud.
gateway-not-found Gateway not found The gateway was deleted. Choose another gateway, or restore it from the Trash.
enrollment-expired The token has expired The enrollment token is older than 1 hour. Click Create a new token.
fingerprint-mismatch The fingerprint changed; compare it again The agent’s fingerprint changed during approval. Compare the fingerprint again before you approve.
member-not-found This member no longer exists The member was removed. Reload the page.
member-already-revoked This member is already revoked Someone revoked it already. Nothing to do.
— Another gateway already has this name The name is taken. Choose another name.
gateway-in-use These data sources use the gateway Data sources still use the gateway, so it cannot be deleted. Move those data sources to another gateway or delete them first.
gateway-members-connected Agent machines may still be connected A member is not fully disconnected. Uninstall the agent, revoke the member, or wait until it has no heartbeat for 24 hours.
— Only organization admins can manage gateways You are not an organization admin. Ask an organization admin.

The Gateways page can also show these alerts:

Code Message
no_member_online No member is online
version_below_minimum A member runs below the minimum version
policy_mismatch A member policy does not match
second_session_suspended A second session was suspended

These messages show when you upload an Excel or CSV file. See Connect data.

Code Message What to do
upload-too-large The file is larger than 100 MB. Split the file, or load it from a database.
upload-type-invalid Only CSV (UTF-8) or Excel .xlsx files without macros or encryption. Save the file as .xlsx without macros or a password, or as CSV.
upload-encoding-invalid The file is not UTF-8. Save it as UTF-8 text. Save the CSV as UTF-8.
upload-too-many-columns The file has more than 200 columns. Remove columns.
upload-too-many-rows The file has more than 5,000,000 rows. Split the file.
upload-parse-failed The file content could not be read. Open the file, check it, save it again. The message can name the line.
upload-too-many-sheets The workbook has more than 100 sheets. Remove sheets.
upload-too-many-sheets-picked You can pick at most 20 sheets at a time. Load the sheets in several steps.
upload-sheets-required Pick at least one sheet. Pick a sheet.
upload-sheet-not-found The file has no such sheet. Pick a sheet from the list.
upload-sheet-duplicate A sheet is picked twice. Pick each sheet once.
upload-not-ready The file is not read yet. Wait until reading ends.
upload-already-loaded This file is already loaded. Open the Data Tables it created.
upload-not-found The uploaded file was not found. Upload the file again.
upload-replace-invalid Only a loaded file can be replaced. Pick a file that finished loading.
upload-replace-kind-mismatch Replace a file with one of the same type (CSV for CSV, Excel for Excel). Use a file of the same type.
upload-replace-sheet-missing The new file lacks a sheet a data table reads Add the missing sheet to the new file.
upload-replace-columns-missing The new file lacks a column a data table reads in sheet Add the missing columns to the new file.
data-table-name-taken That data table name is already used. Choose another name.
data-table-name-invalid A data table name needs 1 to 120 visible characters. Change the name.
quota-exceeded The organization has no room for another data table. See Plans and limits.
— The upload failed. Try again. Try again.
Code Message Meaning What to do
data-table-not-found Data Table not found The Data Table was deleted. Look in the Trash.
data-table-name-taken A data table with this name exists The name is taken. Choose another name.
data-table-single-table A data table holds one table. Create another data table for another table, then combine them in a data model. Each Data Table holds one table. Load the other table as its own Data Table.
data-table-table-exists The data table already has this source table The table is already loaded. Nothing to do.
table-not-found The table is no longer on the source The table was dropped or renamed on the source. Pick the table again.
table-name-taken Table name already used The name is taken. Choose another name.
column-name-taken Column name already used The name is taken. Choose another name.
table-unsupported No column of this table can be loaded Every column has a data type Fresco BI cannot load. Convert the columns in a view on the source.
limit-exceeded The data table would exceed 10,000 columns Too many columns. Load fewer columns.
invalid-type-override The data type cannot be used for this column The data type you picked does not fit the values. Pick another data type.
storage-mode-unsupported This source does not support Realtime yet This source type cannot use Realtime. Use Import.
storage-mode-mixed A data table uses only one mode Import and Realtime were mixed. Use one mode.
sql-disabled-for-source Custom SQL is not enabled for this data source Custom SQL is off for this source. Pick a table instead.
sql-too-long The SQL is too long (64 KB at most) The statement is too long. Shorten the SQL.
table-not-loaded The table has no data yet; refresh the data table The Data Table was never refreshed. Refresh its data model. See Refresh.
profile-timeout The column profile took too long; try again The column profile is slow. Click Retry.
invalid-cursor The browsing session expired; reloading You paged through data for a long time. Wait for the reload.
data-table-in-use A report in another workspace uses this data table. Delete or move those reports first. You tried to delete a Data Table that another workspace uses. Delete or move those reports first.

Explore checks your SQL before running it.

Code Message
multiple-statements Only one statement is allowed
not-select Only SELECT statements are allowed
comment-not-allowed Comments are not allowed
function-not-allowed This function is not allowed
table-not-allowed This table is not allowed
too-long The SQL is too long
parse-error The SQL could not be parsed
unsupported-construct This construct is not supported
parameters-not-allowed Parameters are not allowed
— The SQL is not valid
Code Message What to do
explore-rls-blocked Row security on an input applies to you, so a derived data table cannot be created Ask someone who is not limited by row-level security on that input.
explore-cycle The derived data table forms a dependency cycle Do not build a Data Table from itself, even through others.
explore-depth A derived data table chain has at most 3 levels Build from fewer levels.
explore-changed Someone else saved this SQL meanwhile. Reload to see the latest version Reload, then make your change again.
explore-not-found This data table was not made from SQL Open a Data Table made with Explore.
data-table-has-dependents Other data tables are built from this data table. Delete or change them first. Delete or change the Explore Data Tables that use it.

Refresh errors show in the refresh progress and in the refresh history. See Refresh.

Code Message What to do
refresh-in-progress The data table is already refreshing Wait until it ends.
model-refresh-in-progress The data model is already refreshing Wait until it ends.
data-model-empty Add data tables to the data model before refreshing Add a Data Table.
data-table-empty Add tables to the data table before refreshing Add a table.
data-table-refresh-removed A data table refreshes only from its data model Click Refresh on the data model.
data-table-schedule-removed The refresh schedule belongs to the data model Set the schedule on the data model.
data-table-live A DirectQuery table reads its source live; nothing to refresh This is a Realtime Data Table. Nothing to do.
datasource-incomplete The data source has no saved password Edit the data source and enter the password.
datasource-not-found The data source was deleted Restore the data source from the Trash.
source-error The data source returned an error Test the data source connection.
runner-unavailable The connection service is busy or not running Try again in a few minutes.
gate-failed The new data failed the quality checks; the previous data is kept Open Refresh details and read the Quality report.
import-timeout Loading took too long Load less data, or refresh at a quieter time.
model-refresh-timeout The data model refresh took too long Same as above.
model-refresh-failed No data table of the data model was refreshed Open each Data Table’s refresh history for the cause.
input-failed A data table it is built from was not refreshed Fix the input Data Table first.
plan-limit-exceeded Your plan limit is reached Data storage is full. See Plans.
feature-not-in-plan The data source needs the Fresco Enterprise plan See Plans.
stream-rejected The source sent invalid data Check the source table. Contact support if it keeps happening.
disk-low The server is low on disk space Try again later.
job-abandoned The task was interrupted Start the refresh again.
model-refresh-abandoned The data model refresh was interrupted Start the refresh again.
superseded A newer refresh replaced this one Nothing to do.
cancelled The refresh was cancelled Start it again if needed.
refresh-not-started The refresh could not start Try again.
refresh-failed The refresh failed Try again. Contact support with the code if it keeps failing.
internal Internal error Contact support.

The Quality report of a refresh can list these findings:

Code Finding
schema-mismatch Schema mismatch
table-empty Empty table
row-count-drop Large row-count drop
conversion-errors Conversion errors
lossy-column Lossy column conversion
relationship-key-not-unique Relationship key is not unique
relationship-key-has-blanks Relationship key has blanks
orphan-rate High orphan rate
sort-by-ambiguous Ambiguous sort-by column
table-not-loaded Table not loaded
new-source-columns New source columns
Message What to do
Unknown time zone Pick a time zone from the list.
Pick 1–7 different days Pick at least one day.
Invalid times: too many, or closer together than your plan allows Remove times, or space them further apart. See Plans.
You need Build to change the schedule Ask for Build on the data model.
Code Message What to do
model-not-found Data model not found The data model was deleted. Look in the Trash.
edit-conflict The draft changed; reload it Someone saved the draft elsewhere. Reload, then repeat your change.
precondition-required The draft version is missing; reload the page Reload the page.
if-match-invalid The draft version is not valid; reload the page Reload the page.
physical-readonly Tables and columns are managed by the data table and cannot change here Change the table in its Data Table.
model-invalid The model has errors; validate it Open the issue list and fix each item.
relationship-key-not-unique The key on the one side repeats values or has blanks Pick a key column with unique, non-blank values, or change the cardinality.
model-has-no-data The data table has no data yet; refresh it, then check relationships Refresh the data model first.
too-many-checks Too many relationships to check; save in smaller steps Save fewer relationship changes at a time.
publish-blocked Cannot publish yet; fix the listed issues Fix the issues listed, then publish.
model-not-published The model is not published yet Publish the data model.
payload-too-large The model is too large to save at once Save in smaller steps.
row-null-value A column used in a row calculation has a blank value Handle blanks in the formula, or fix the data.
— You cannot edit this model You need Build on the data model.

The issue list of a data model can show these items:

Code Message
unknown-table Refers to a table that is no longer in the model
unknown-column Refers to a column that is no longer in the model
duplicate-measure-name Two measures have the same name
measure-name-conflicts-column A measure has the same name as a column
measure-invalid A measure formula has errors
relationship-column-table-mismatch A relationship column is not in its declared table
relationship-key-type-unsupported This data type cannot be a relationship key
relationship-same-table A relationship joins a table to itself
relationship-type-mismatch The two relationship columns have different data types
relationship-unsupported This kind of relationship is not used in queries yet
relationship-ambiguous Two filter paths join the same tables
relationship-key-not-unique The key on the one side repeats values
relationship-key-has-blanks The key on the one side has blanks
sort-by-chain A sort-by column is itself sorted by another column
sort-by-ambiguous A sort-by column has several values for one shown value
too-many-checks Too many relationships to check at once
security-filter-ignored Apply security filter in both directions works only with Cross filter direction Both
security-path-ambiguous A security role reaches a table through several relationship paths; make one inactive
other Another issue in the model

When you create a relationship, the form can also say: Pick a column in the from table, Pick a column in the to table, The two columns must be in different tables, These two columns are already related, The column is not in the model or The two columns have different data types.

The measure editor checks the formula while you type and shows the line and column of each error. See Measures.

Code Message
syntax-error Syntax error
unknown-table Table not found
unknown-column Column not found
unknown-measure Measure not found
unknown-function Function not found
expected-column A column is expected
expected-table A table is expected
column-outside-aggregate A column must be inside an aggregate function
aggregation-not-allowed An aggregation cannot be used here
keepfilters-outside-calculate This function only works inside CALCULATE
filter-not-simple The filter is too complex
invalid-measure-reference The measure reference is not valid
measure-cycle Measures reference each other in a loop
type-mismatch The data types do not match
literal-type-mismatch The value type does not match
literal-out-of-range The value is out of range
number-out-of-range The number is out of range
nonblank-constant The value cannot be blank
too-complex The expression is too complex
too-deep The expression is nested too deeply
too-long The expression is too long
unterminated-name A name is missing its closing bracket
unterminated-string A string is not closed
— Expression is limited to 8000 characters
Message What to do
A security role with this name exists or the model already has 100 roles Choose another name, or delete a role you no longer need.
This security role was just deleted Reload the page.
The member list changed, reload it Reload, then make your change again.
Security roles are not published yet Publish the data model.
View only; Build permission is needed to edit security roles. Ask for Build on the data model.
Code Message What to do
report-not-found Report not found The report was deleted. Look in the Trash.
report-name-taken A report with this name already exists Choose another name.
edit-conflict The draft changed somewhere else Click Reload. Unsaved changes in this tab are lost.
report-invalid The draft is not valid Fix the items listed under Cannot publish yet.
precondition-required, if-match-invalid Reload the draft before saving Reload, then save.
payload-too-large The report is too large to save Remove pages or visuals.
model-not-published The data model is not published yet Publish the data model first.
publish-blocked Cannot publish yet; fix the listed issues Fix the issues listed.
forbidden You need Build on the report and data table to publish Ask for Build.
invalid-state The report has changed, reload the page Reload the page.
report-file-invalid This file is not a Fresco BI report file (format or version) Import a report JSON file exported from Fresco BI.
payload-too-large The file is larger than 4 MB Use a smaller report file.

Cannot publish yet lists these items: A field is no longer in the model (unknown-field), A measure is invalid (measure-invalid), A filter has an invalid value (filter-value-invalid) and The data model is not published yet (model-not-published).

A visual shows these messages in place of its chart.

Code Message What to do
query-timeout The query took too long Filter the data, or use fewer fields.
source-timeout, directquery-timeout The data source answered too slowly Try again later.
source-unavailable, source-error, runner-unavailable, gateway-unavailable The data source is unavailable Check the data source. For a gateway, check the agent.
dq-too-busy, directquery-busy, too-many-queries, rate-limited The source is busy, try again in N s Wait, then click Retry.
dq-result-too-large, directquery-too-large The query result is too large Filter the data.
dq-source-credentials The source needs updated credentials Edit the data source and enter the password again.
dq-schema-drift The source schema has changed Load the table again.
directquery-not-supported This visual is not available for Realtime data yet Use another visual, or Import mode.
table-not-loaded, snapshot-unavailable The data is not ready yet; refresh the data table Refresh the data model.
model-has-no-data The data model has no data yet; refresh the data model Refresh the data model.
version-expired The data was just updated; reload the report Reload the report.
report-not-found, data-table-not-found This data is no longer available The item was deleted.
invalid-query The query is not valid Remove and add the fields again.
result-too-large The result is too large, filter the data first Filter the data.
— This visual cannot be shown Check the visual’s fields.
— Could not refresh, showing older data Wait for the next refresh, or click Retry.

A matrix has its own limits (code query-unsupported):

Message What to do
The matrix has more than 2,000 rows. Filter the data or remove a field from Rows Filter, or remove a field from Rows.
The matrix has more than 100 columns. Filter the data or remove a field from Columns Filter, or remove a field from Columns.
The matrix has more than 10,000 cells. Filter the data or remove a field Filter, or remove a field.
There are too many total rows. Filter the data or turn off subtotals Filter, or turn off subtotals.

In a filter value box you can see: Type a number, >n, <n or a-b, A range a-b cannot go with other values and At most 20 values.

Code Message
apr-disabled Auto refresh is turned off
apr-budget-exceeded The auto-refresh budget is exhausted
interval-too-small The refresh interval is below the minimum
limits-version-conflict Someone else changed these values
Code Message What to do
export-underlying-forbidden Needs Build permission on the data model to export underlying data Ask for Build, or export summarized data.
export-busy Another export is running, try again later Wait until the other export ends.
result-too-large The result is too large, filter the data first Filter the data.
— The data was truncated because it exceeded the export limit. Filter the data, then export again.
— This visual could not be exported as an image Try again.
Code Message What to do
share-target-not-in-workspace This person has no access in the workspace. Ask a workspace admin to add them first Add the person to the workspace first.
grant-target-not-member This person is no longer a member of the organization Invite the person again.
grant-target-cannot-build Viewers can only receive Read access, never Build Give Read, or change their workspace role.
plan-viewer-only On this plan the people you add can only view reports On Free and Pro, give Read. See Plans.
role-ceiling You cannot give a role higher than your own Ask someone with a higher role.
— You do not have permission to share this item Ask for Build on the item, or an admin role.
— This person is already invited Nothing to do.
— This person is already a member Nothing to do.
— Too many invites, try again in N seconds Wait, then try again.
— A Free organization is for you only, so it takes no other members. For teamwork, request the Enterprise plan. See Plans.
— The owner must transfer ownership before changing role or leaving Use Transfer ownership first.
— The new owner must verify their e-mail first Ask the person to verify their e-mail.
— The organization has no free seat: nobody can be restored Free a seat, or ask for more seats.
— The organization has reached its workspace limit See Plans.
— Name is already taken Choose another workspace name.
— A report in another workspace uses a data table of this workspace. Delete or move those reports first. Delete or move those reports first.
— A refresh is running in this workspace, try again when it finishes Wait until the refresh ends.
personal-org-name-fixed A personal organization cannot be renamed Nothing to do.
confirm-name-mismatch The organization name does not match Type the exact organization name.
org-enterprise-contact-support Contact support to delete an Enterprise organization Contact support.
Message What to do
The name is taken; restore it from the Trash with a new name Restore it with another name.
No longer in the Trash The item was deleted for good after 30 days.
The workspace was deleted Restore the workspace first.
A refresh is running, try again when it finishes Wait until the refresh ends.
Code Message What to do
embed-token-invalid This embed link is not valid or was revoked. Create a new link.
embed-token-expired The embed session has expired. Your server must get a new embed token.
public-embed-disabled The organization turned public sharing off. An admin turns on Allow publish to web.
embed-origin-not-allowed This website may not show the report. Add the website to Allowed websites of the app token.
public-embed-rls This report cannot be viewed publicly. The data model has row-level security. Use Secure embed (app token).
— Publish the report before embedding it. Save (publish) the report first.
— The report already has 5 active public links. Revoke a link you no longer use.
— Only workspace admins manage app tokens. Ask a workspace admin.
— The report could not be loaded. Try again.

These errors show a link to the plans. See Plans.

Code Message Meaning
quota-exceeded Your plan allows at most N data sources (or data tables, workspaces, members (open invites included)) You reached a count limit of the plan.
quota-exceeded Your organization has reached a limit of its plan Same, when the limit is not named.
seat-limit-reached The license has no free seat Every seat is used.
feature-not-licensed This feature is not part of your organization’s plan The plan does not include it.
feature-not-in-plan This feature needs the Fresco Enterprise plan Enterprise only.
refresh-interval-too-short Your plan allows at most N scheduled refreshes a day The schedule has too many times.
refresh-interval-too-short Your plan keeps scheduled refreshes at least N minutes apart Two times are too close. On Free: Your plan refreshes on a schedule at most once a day.
plan-limit-exceeded Your plan limit is reached For example, data storage is full.
plan-trial-ended Your Pro trial has ended. Your data stays; upgrade to Pro to do this again. You are back on Free.
trial-used You have already used your Pro trial: one trial per person. One trial per person.
trial-not-eligible This organization cannot start a Pro trial. The trial is not available for this organization.
plan-already-active Your organization is on Pro already Nothing to do.
no-personal-org You have no personal organization to upgrade Pro is for a personal organization.
enterprise-request-pending You already have a pending request Wait for our answer in My requests.
Code Message What to do
— Match every required table and column. Map each required table and column.
— A column holds another kind of data than the template expects. Pick a column of the expected type.
— The matching is not valid (each of your tables can serve one template table). Use each of your tables once.
— Using templates needs a paid plan. See Plans.
— This report name is already used in the workspace. Choose another name.
— The template is no longer published. Pick another template.
— The report could not be created from the template. Try again.
migration-file-too-large The file is larger than 100 MB. Use a smaller file.
migration-unsupported-file This file format is not supported yet. See Migration.
migration-file-invalid The file could not be read. Export it again and retry. Export the file again.
migration-file-encrypted The file is protected (encrypted or sensitivity labelled). Remove the protection and export it again. Remove the protection, then export again.
migration-file-unsafe The file holds executable or macro content and was refused. Remove that content.
migration-mapping-incomplete Some required tables or columns are not mapped. Map them.
migration-mapping-invalid The mapping is not valid. Check it again. Check the mapping.
migration-mapping-type A column is mapped to a column of another type. Map a column of the same type.
migration-table-empty A mapped Data Table holds no data yet. Load its data first. Refresh that Data Table’s data model first.
report-name-taken That report name is already used. Choose another name.
Code Message
favorite-limit You can have up to 200 favorites
pin-limit Home holds up to 8 pinned metrics
pin-visual-invalid Only a card, KPI or gauge of a published report can be pinned
subscription-limit You can have up to 20 e-mail subscriptions
subscription-exists You already subscribe to this page
subscription-invalid The schedule is not valid (day of month 1 to 28)
unsubscribe-token-invalid This unsubscribe link is not valid or was used