{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["callout","faq","faq-item","partial"]},"type":"markdown"},"seo":{"title":"Ensure reliable data sync from spreadsheets in Databox","description":"Learn how spreadsheet column and structure changes affect data sync and metrics in Databox, and how to keep datasets stable over time.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ensure-reliable-data-sync-from-spreadsheets-in-databox","__idx":0},"children":["Ensure reliable data sync from spreadsheets in Databox"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Metrics built on datasets connected to Google Sheets, Excel, or similar files can break if changes are made directly in the source file. This article explains why these issues occur, the most common scenarios that cause them, and how to fix or prevent metric errors related to column names and schema changes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"column-structure-and-metrics","__idx":1},"children":["Column structure and metrics"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create a dataset, the system generates a schema based on the structure of your source file. Column names act as unique identifiers, and metrics rely on those identifiers to calculate values correctly."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you change column names or data structure directly in the source file, the dataset schema updates on the next successful sync. Existing metrics, however, are not updated automatically. Because the system cannot reliably determine what changed in the source file, it cannot safely update metrics that depend on those columns."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This can result in broken metrics, missing columns, or incompatible aggregations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-scenarios-that-affect-metrics","__idx":2},"children":["Common scenarios that affect metrics"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Metric issues most often occur when changes are made directly in the source spreadsheet, outside of Databox. The sections below explain common scenarios that impact metrics, how they affect your data, and best practices for fixing and avoiding issues."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"column-names-are-changed","__idx":3},"children":["Column names are changed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This scenario occurs when column headers are renamed in the source spreadsheet after metrics have already been created. On the next successful sync, the dataset updates to the new column names, but existing metrics continue to reference the original column names."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," You may see the error ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<column_name> is not found in the dataset schema"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Root cause:"]}," Metrics rely on column identifiers that are created from header names. When a header is renamed, the identifier changes, but metric definitions are not updated automatically."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solution:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open the affected metric."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update the metric definition"]}," to use the correct column from the dataset."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save the metric"]}," to rebuild it using the updated schema."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Best practices:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid renaming column headers after metrics are built."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If renaming is required, review and update any related metrics immediately after the change."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If column names are expected to change frequently, consider configuring the dataset to use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["row 0 as the header row"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"using-row-0-as-the-header-row","__idx":4},"children":["Using row 0 as the header row"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When row 0 is selected as the header row, column identifiers are based on column position (A, B, C, and so on) rather than header text. This allows column names to change in the source spreadsheet without breaking existing metrics."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"caution"},"children":["With this setup, column order must remain stable. Moving or swapping columns in the sheet can change which data is associated with each identifier and may impact metrics."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Column names and column order can be modified later in Databox through the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/create-a-dataset"},"children":["dataset editor"]},", without changing the source file."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"data-is-temporarily-removed","__idx":5},"children":["Data is temporarily removed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This scenario occurs when scripts or automations update a spreadsheet by temporarily clearing all values before inserting new data. If a data sync happens while the sheet is empty, the dataset schema may be re-detected incorrectly."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," You may see the error: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Selected aggregation 'SUM' is not compatible with the selected measure column"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Root cause:"]}," When the sheet contains no data during sync, column types may default to text. Metrics that rely on numeric columns then become incompatible with their configured aggregations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solution:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ensure the sheet contains valid data again."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refresh the dataset"]}," so the correct column types are detected."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open the affected metric"]}," and trigger a refresh by saving it or adjusting an advanced setting, such as the date range."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Best practices:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid update processes that leave the sheet empty during sync."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you use scripts or automations, ensure data is written continuously or that updates occur outside of scheduled sync windows."]}]}]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Is it safe to reorder columns in my sheet?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes, as long as column names remain the same. Reordering columns does not affect metrics unless you are using the row 0 header setup."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Why don't metrics update automatically after column changes?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The system cannot reliably determine what changed in the source file, so it cannot safely update metric definitions without user input."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Ensure reliable data sync from spreadsheets in Databox","id":"ensure-reliable-data-sync-from-spreadsheets-in-databox","depth":1},{"value":"Column structure and metrics","id":"column-structure-and-metrics","depth":2},{"value":"Common scenarios that affect metrics","id":"common-scenarios-that-affect-metrics","depth":2},{"value":"Column names are changed","id":"column-names-are-changed","depth":3},{"value":"Using row 0 as the header row","id":"using-row-0-as-the-header-row","depth":4},{"value":"Data is temporarily removed","id":"data-is-temporarily-removed","depth":3}],"frontmatter":{"slug":"ensure-reliable-data-sync-from-spreadsheets-in-databox","seo":{"title":"Ensure reliable data sync from spreadsheets in Databox","description":"Learn how spreadsheet column and structure changes affect data sync and metrics in Databox, and how to keep datasets stable over time."},"keywords":{"includes":["spreadsheet data sync issues","Google Sheets metrics broken","Excel metrics broken","column not found in dataset schema","column renamed broken metric","spreadsheet column name changed","aggregation not compatible metric error","sheet empty during sync","dataset schema update","row 0 header row","spreadsheet metric not updating","reorder columns spreadsheet","dataset column identifier","spreadsheet sync best practices"]}},"lastModified":"2026-05-29T08:50:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ensure-reliable-data-sync-from-spreadsheets-in-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}