Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.
Step 1 of 4. Connect a source or upload a file so Addison has data to work with.If your project already has the files or tables you need, skip ahead to Create your first analysis.
Bring data in
Connect a warehouse
Upload a file
Click Connectors in the left sidebar, then New connection at the top right. The wizard has three steps:
The Connectors page: your data connections and their status
1
Choose a data source
Snowflake, Postgres, and BigQuery sit under Popular; the rest are under Other.
Step 1: choose a data source
2
Enter the details
Give the connection a Name. It’s the identifier used in SQL later, so use letters, numbers, hyphens, and underscores only. Then fill in the credentials and click Test connection before continuing. A pass means Summation could authenticate and reach your data.
Step 2: connection details and credentials
3
Add datasets
Pick the tables to bring in. Each one becomes a dataset available to Addison, to artifacts, and to your tables and data catalog.
Step 3: pick the datasets to bring in
How Summation reads and refreshes data depends on the connector and its settings. See Connectors for details.
Click Projects in the left sidebar (near the bottom, just above your profile) to see the list of projects you have access to. Click the project you want to add the file to — or New Project if you’re starting fresh. This opens the project’s workspace.Above the file list, click + Import, then choose Upload Files from the dropdown. Pick the file from your computer: CSV, Excel, PDF, PowerPoint, and more.The file lands in the project, and that’s already enough to work with: Addison can read it, analyze it, and build artifacts straight from it.It does not become a table on its own. To get it into the data grid, queryable in SQL and with a catalog you can describe, ask Addison to convert it: “turn this CSV into a table.” Worth doing for anything you’ll come back to.
A project's file list, with the Import menu open
You can also drop a file straight into the Addison chat composer with its + button. That’s fine for a one-off question, but it’s ephemeral: the file is scoped to that chat and won’t be there in a new conversation or a future session. Upload to a project (as above) — or ask Addison to convert it to a table — for anything you’ll want to come back to.
Check that it landed
A connection puts its datasets under Tables in the left sidebar; click one to see the rows. An uploaded file shows up in its project’s file list instead, and appears under Tables only once you have asked Addison to convert it.
The Tables page
Projects keep the files and context for a task together. Attach the tables and views you need as the project’s key tables so Addison reaches for them first here. Addison can also work with uploaded project files without converting them to tables first.
Start narrow. Choose the data needed for one question. You can add business context as you review the answer.
Next
Create your first analysis
Step 2: ask a question, create a report, and check its evidence.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Summation","colors":{"primary":"#000000","light":"#888888","dark":"#000000"},"logo":{"light":"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685","dark":"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685"},"favicon":{"light":"https://mintcdn.com/summation-676748f5/shsHObvGm-SkiZl8/images/favicon.ico?fit=max\u0026auto=format\u0026n=shsHObvGm-SkiZl8\u0026q=85\u0026s=25d44d855522b83a4467f76687386368","dark":"https://mintcdn.com/summation-676748f5/shsHObvGm-SkiZl8/images/favicon.ico?fit=max\u0026auto=format\u0026n=shsHObvGm-SkiZl8\u0026q=85\u0026s=25d44d855522b83a4467f76687386368"},"appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Get Started","href":"https://app.summation.com/signup"}},"fonts":{"family":"Inter"},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"summation-676748f5","hasAudioNarration":false,"actualSubdomain":"summation-676748f5","customDomains":["docs.summation.com"],"gitSource":{"type":"github","owner":"summationai","repo":"code","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5cda8b51d0e31167b5abb","clientVersion":"0.0.4149","searchFilterCounts":[{"language":"default","tag":"API","count":156},{"language":"default","tag":"Endpoints","count":144},{"language":"default","tag":"Documentation","count":49},{"language":"default","tag":"Tables","count":31},{"language":"default","tag":"Connectors","count":21},{"language":"default","tag":"Key concepts","count":20},{"language":"default","tag":"Data Connectors","count":17},{"language":"default","tag":"Grid","count":13},{"language":"default","tag":"Conversations","count":12},{"language":"default","tag":"Use cases","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"a[href=\"https://app.summation.com/signup\"]{border:0!important;box-shadow:none!important}a[href=\"https://app.summation.com/signup\"]>*{background:#000000!important;color:#ffffff!important;box-shadow:none!important;padding-right:1rem!important;padding-left:1rem!important;gap:0!important}a[href=\"https://app.summation.com/signup\"] span,a[href=\"https://app.summation.com/signup\"] svg{color:#ffffff!important}a[href=\"https://app.summation.com/signup\"] svg{display:none!important}a[href=\"https://app.summation.com/signup\"]:hover>*{background:#27272a!important}html[data-current-path=\"/home\"] .eyebrow{display:none}html[data-current-path^=\"/features/\"] .eyebrow{display:none}html[data-current-path=\"/home\"] #header{max-width:41rem;margin-top:3rem}html[data-current-path=\"/home\"] .mdx-content{margin-top:1.5rem}html[data-current-path=\"/home\"] #content-area{width:100%;max-width:64rem}html[data-current-path=\"/home\"] #header>p{margin-top:0.75rem;color:#52525b;font-size:1.125rem;line-height:1.75rem}.home-get-started{display:inline-flex;min-width:10rem;height:2.75rem;align-items:center;justify-content:center;gap:0.5rem;padding-inline:1rem;border-radius:0.75rem;background:#000000;box-shadow:none!important;color:#ffffff!important;font-size:0.875rem;font-weight:500;line-height:1;text-decoration:none!important;transition:background-color 120ms ease}.home-get-started:hover{background:#27272a;box-shadow:none!important}.home-get-started:focus-visible{outline:2px solid #000000;outline-offset:3px}.home-get-started img{width:1rem;height:1rem}.home-section-divider{width:100%;height:0.5px;margin-block:2.5rem;background:#e7e7e7}.home-section-divider+.card-group{margin-top:0!important}html[data-current-path=\"/home\"] .card-group{width:100%;max-width:64rem;grid-template-columns:repeat(3, minmax(0, 1fr))!important;justify-content:center;gap:1.5rem!important}html[data-current-path=\"/home\"] .card-group>.card{--primary: 228 228 231;display:flex;width:100%;min-height:9.5rem;padding:1.3125rem 1.5rem;align-items:center;box-sizing:border-box;margin-block:0!important;border:var(--border-width-border-half, 0.5px) solid\n var(--border-layout-divider, #e7e7e7)!important;border-radius:var(--border-radius-rounded-xl, 0.75rem);background:var(--color-neutral-white, #ffffff);box-shadow:0 1px 2px 0 rgb(0 0 0 / 5%);transition:background-color 120ms ease,\n box-shadow 120ms ease}html[data-current-path=\"/home\"] .card-group>.card:hover{background:#f4f4f5;border-color:#e4e4e7!important}html[data-current-path=\"/home\"] .card-group>.card>div{height:100%;width:100%;padding:0}html[data-current-path=\"/home\"] .card-group [data-component-part=\"card-title\"]{font-size:0.9375rem!important}html[data-current-path=\"/home\"] .card-group [data-component-part=\"card-content\"]{color:var(--home-card-description, #52525b)!important;font-size:0.875rem!important;line-height:1.25rem!important}html[data-current-path=\"/home\"] .card-group>.card svg{color:#000000!important}html.dark[data-current-path=\"/home\"] .card-group>.card{--primary-light: 63 63 70;--home-card-description: #888888;border-color:#3f3f46!important;background:#18181b}html.dark[data-current-path=\"/home\"] .card-group>.card svg{color:#f4f4f5!important}html.dark[data-current-path=\"/home\"] .card-group>.card:hover{background:#27272a;border-color:#3f3f46!important}html.dark[data-current-path=\"/home\"] .home-section-divider{background:#27272a}.card{background-color:#fafafa!important;transition:background-color 120ms ease,\n border-color 120ms ease}.card:hover{background-color:#f4f4f5!important}html.dark .card{background-color:#18181b!important}html.dark .card:hover{background-color:#232326!important}#content-area{box-sizing:content-box;width:auto;max-width:700px;margin-inline:auto}#page-title{font-size:2rem!important;line-height:2.5rem!important}#page-context-menu-button{border-radius:8px 0 0 8px!important}#page-context-menu>button[aria-label=\"More actions\"]{border-radius:0 8px 8px 0!important}html[data-current-path=\"/home\"] #page-context-menu{display:none!important}div[role=\"menu\"]:has([role=\"menuitem\"] [class~=\"wrap-break-word\"]) [role=\"menuitem\"]>div:first-child{border-color:transparent!important}div[role=\"menu\"]:has([role=\"menuitem\"] [class~=\"wrap-break-word\"]) [role=\"menuitem\"]>div:nth-child(2)>div:first-child>svg{display:none!important}.mdx-content{font-size:15px;letter-spacing:-0.1px}.mdx-content a.link{border-bottom:0;font-weight:400;text-decoration-line:underline;text-decoration-style:dotted;text-decoration-color:#a1a1aa;text-decoration-thickness:from-font;text-decoration-skip-ink:none;text-underline-position:from-font;transition:text-decoration-color 120ms ease-out}.mdx-content a.link:hover{text-decoration-style:solid;text-decoration-color:currentColor}@media (prefers-reduced-motion: reduce){.mdx-content a.link{transition:none}}.mdx-content>h2{margin-top:3rem!important}#table-of-contents-content{--toc-indicator-height: 1.5rem;--toc-indicator-y: 0px;position:relative;border-left:1px solid #e4e4e7}nav:has(>div>#table-of-contents-content)>h2{display:none}#table-of-contents-content::before{position:absolute;top:0;left:-2px;width:3px;height:var(--toc-indicator-height);border-radius:0;background:#27272a;content:\"\";opacity:0;pointer-events:none;transform:translateY(var(--toc-indicator-y));transition:transform 240ms cubic-bezier(0.4, 0, 0.2, 1),\n height 240ms cubic-bezier(0.4, 0, 0.2, 1),\n opacity 120ms ease-out}#table-of-contents-content[data-has-active=\"true\"]::before{opacity:1}@media (prefers-reduced-motion: reduce){#table-of-contents-content::before{transition:opacity 120ms ease-out}}#table-of-contents-content .toc-item>a{padding-left:calc(\n var(--toc-padding-left) + var(--toc-focus-padding, 0rem) + 1rem\n )!important}#table-of-contents-content .toc-item[data-active=\"true\"]>a{font-weight:400;text-shadow:none!important}#table-of-contents-content .toc-item[data-active=\"true\"]:not([data-toc-current=\"true\"])>a{color:#4f4f4f}#table-of-contents-content .toc-item[data-toc-current=\"true\"]>a{color:#000000}.dark #table-of-contents-content{border-left-color:#3f3f46}.dark #table-of-contents-content .toc-item[data-active=\"true\"]:not([data-toc-current=\"true\"])>a{color:#9e9e9e}.dark #table-of-contents-content .toc-item[data-toc-current=\"true\"]>a{color:#888888}.dark #table-of-contents-content::before{background:#f4f4f5}#navigation-items .sidebar-group>li+li{margin-top:4px}#navigation-items .sidebar-group a,#navigation-items .sidebar-group button[aria-expanded]{width:calc(100% - 0.5rem)!important;margin-left:0.5rem}#navigation-items .sidebar-group a,#navigation-items .sidebar-group button[aria-expanded]{padding-top:0.25rem!important;padding-bottom:0.25rem!important;line-height:1.25rem!important}#sidebar a[aria-current=\"page\"]{background-color:#f4f4f5!important;border-radius:8px!important;color:#000000!important;font-weight:500!important;text-shadow:none!important}#navigation-items a:not([aria-current=\"page\"]):hover{background-color:#fafafa!important}.dark #navigation-items a:not([aria-current=\"page\"]):hover{background-color:#18181b!important}.dark #sidebar a[aria-current=\"page\"]{background-color:#27272a!important;color:#ffffff!important}#sidebar button[aria-expanded]>div:last-child{margin-left:auto}#navigation-items .sidebar-group a span,#navigation-items .sidebar-group button span{hyphens:none}div:has(>form #search-input){padding:0!important;border:0!important;background:transparent!important;box-shadow:none!important}#theme-preference-menu-trigger{width:2.25rem;height:2.25rem;padding:0!important;border:0.5px solid #e4e4e7;border-radius:0.625rem!important}#theme-preference-menu-trigger [data-theme-preference-icon]{display:none!important}#theme-preference-menu-trigger [data-theme-preference-icon=\"dark\"]{display:inline-flex!important}html[data-summation-theme-toggle=\"ready\"] #theme-preference-menu-content{display:none!important}.dark #theme-preference-menu-trigger{border-color:#27272a}.dark #theme-preference-menu-trigger [data-theme-preference-icon=\"dark\"]{display:none!important}.dark #theme-preference-menu-trigger [data-theme-preference-icon=\"light\"]{display:inline-flex!important}#header-ask-ai,#assistant-entry{display:none!important}.chat-assistant-floating-input{display:none!important}#pagination{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:1.5rem;padding:0}#footer{border-top:0!important}html[data-current-path=\"/home\"] #pagination{display:none!important}#pagination>a{display:grid;box-sizing:border-box;min-width:0;height:5rem;align-content:center;padding:1rem 1.5rem;column-gap:0.75rem;row-gap:0.5rem;border:1px solid #e4e4e7;border-radius:0.75rem;background:transparent;font-weight:400;transition:border-color 120ms ease,\n background-color 120ms ease}#pagination>a:hover{border-color:#d4d4d8;background:#fafafa}#pagination>a::before{color:#71717a;font-size:0.8125rem;font-weight:400;line-height:1.25rem}#pagination .pagination-prev{grid-template-columns:auto minmax(0, 1fr)}#pagination .pagination-prev::before{grid-column:2;grid-row:1;content:\"Previous\"}#pagination .pagination-next{grid-template-columns:minmax(0, 1fr) auto;margin-left:0;text-align:right}#pagination .pagination-next::before{grid-column:1;grid-row:1;content:\"Next\"}#pagination [data-component-part=\"pagination-chevron\"]{grid-row:1;width:0.25rem;height:0.5rem;align-self:center;stroke-width:1}#pagination [data-component-part=\"pagination-chevron\"] path{stroke-width:1!important}#pagination [data-component-part=\"pagination-title\"]{grid-column:1 / -1;grid-row:2;color:#27272a;font-size:0.9375rem;font-weight:400;line-height:1.5rem}.dark #pagination>a{border-color:#3f3f46}.dark #pagination>a:hover{border-color:#52525b;background:#18181b}.dark #pagination [data-component-part=\"pagination-title\"]{color:#f4f4f5}header .max-w-8xl{max-width:none!important;margin-inline:0!important}#navbar a[href=\"/\"]:has(.nav-logo){display:flex;align-items:center}#navbar a[href=\"/\"] .nav-logo{height:1.25rem!important}.dark #navbar a[href=\"/\"] .nav-logo{filter:invert(1)}#navbar .max-w-8xl>div>div>.flex.items-center{padding-inline:1.5rem!important}@media (max-width: 639px){#navbar a[href=\"/\"] .nav-logo{height:1.125rem!important}}#navbar>div:first-child{border-bottom-color:#f0f0f0!important}:root{--topbar-tabs-height: 0rem !important}@media (min-width: 1024px){#navbar div.hidden.lg\\:flex.px-12.h-12{position:absolute!important;top:0!important;left:183px!important;height:4rem!important;padding:0!important;width:auto!important}#navbar .nav-tabs{column-gap:2rem}#navbar .nav-tabs-item{gap:0.5rem;white-space:nowrap}#navbar .nav-tabs-item:hover>div.absolute.bottom-0{background-color:currentColor}#navbar .nav-tabs-item[aria-current=\"location\"]>div.absolute.bottom-0{background-color:#27272a!important}.dark #navbar .nav-tabs-item[aria-current=\"location\"]>div.absolute.bottom-0{background-color:#888888!important}#navbar .nav-tabs-item[aria-current=\"location\"]{text-shadow:none!important}}@media (min-width: 1024px){#navbar div:has(>#search-bar-entry){flex:0 1 16rem;min-width:12rem}#navbar div:has(>nav[aria-label=\"Main\"]){flex:0 0 auto;margin-left:0}}#search-bar-entry:focus-visible{outline:2px solid currentColor;outline-offset:2px}.sidebar-group-header--collapsible{cursor:pointer;user-select:none}.sidebar-group-header--collapsible:hover{color:#18181b}.dark .sidebar-group-header--collapsible:hover{color:#f4f4f5}.sidebar-group-header--collapsible:focus-visible{outline:2px solid #a1a1aa;outline-offset:2px;border-radius:4px}.sidebar-group-chevron{margin-left:auto;transform:rotate(90deg);transition:transform 120ms ease}.sidebar-group-header--collapsible[data-sidebar-collapsed=\"true\"] .sidebar-group-chevron{transform:rotate(0deg)}ul.sidebar-group[data-sidebar-collapsed=\"true\"]{display:none}header div:has(>#theme-preference-menu-trigger){margin-left:0.5rem!important}#navbar nav:has(a[href=\"https://app.summation.com/signup\"]){margin-right:0!important}header a[href=\"https://app.summation.com/signup\"]{padding-inline:0.75rem!important}header a[href=\"https://app.summation.com/signup\"]>div{padding-inline:0!important;background:#000000!important}@media (min-width: 1024px){html[data-current-path=\"/home\"] #content-container{position:relative;left:7.5rem}#sidebar{width:280px!important;max-width:280px;transform:translateX(min(-2rem, calc((92rem - 100vw) / 2 - 2rem)));border-right:1px solid #f0f0f0}html:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #sidebar{transform:translateX(min(-2rem, calc((115rem - 100vw) / 2 - 2rem)))}#sidebar>#sidebar-content{top:0!important;left:1.5rem!important}#sidebar-content>[class~=\"pr-8\"]{padding-right:1.5rem!important}#sidebar-content .sticky.top-0.h-8{height:1.5rem}#sidebar-content>[data-component-part=\"scroll-area-scrollbar\"][data-orientation=\"vertical\"]{inset-inline-end:-2.5px!important;margin-inline:0!important}.dark #sidebar{border-right-color:rgba(255, 255, 255, 0.18)}}@media (min-width: 1280px){html[data-current-path=\"/home\"] #header,html[data-current-path=\"/home\"] .mdx-content{transform:translateX(-1.625rem)}html[data-current-path=\"/home\"] .mdx-content{width:calc(100% + 5.25rem)}}@media (min-width: 1024px) and (max-width: 1599px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #content-container{left:0}}@media (min-width: 1280px) and (max-width: 1599px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #header,html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) .mdx-content{transform:none}html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) .mdx-content{width:100%}}@media (min-width: 1600px) and (max-width: 1839px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #content-container{left:calc(50vw - 50rem)}}@media (max-width: 767px){#pagination{grid-template-columns:minmax(0, 1fr)}html[data-current-path=\"/home\"] #header{margin-top:2rem}html[data-current-path=\"/home\"] #header>p{font-size:1rem;line-height:1.5rem}.home-section-divider{margin-block:1.5rem}html[data-current-path=\"/home\"] .card-group{grid-template-columns:minmax(0, 1fr)!important}}figure[data-name=\"frame\"]{padding:1.25rem!important;margin-top:0!important;margin-bottom:1.5rem!important;border-radius:var(--border-radius-rounded-xl, 0.75rem)!important;background:#fafafa!important}.columns figure[data-name=\"frame\"]{margin-bottom:0!important}.columns{margin-top:0!important;margin-bottom:1.5rem!important;row-gap:1.5rem!important}html.dark figure[data-name=\"frame\"]{background:#18181b!important}figure[data-name=\"frame\"]>div[class*=\"bg-grid\"]{display:none}figure[data-name=\"frame\"]>div[class*=\"justify-center\"]{overflow:visible;border-radius:0}figure[data-name=\"frame\"] img{border-radius:0.375rem;box-shadow:0 0 0 0.5px #d4d4d8,\n 0 1px 2px 0 rgb(0 0 0 / 5%)}html.dark figure[data-name=\"frame\"] img{box-shadow:0 0 0 0.5px #3f3f46,\n 0 1px 2px 0 rgb(0 0 0 / 30%)}figure[data-name=\"frame\"]>div[class*=\"pointer-events-none\"]{border-color:transparent}@media (max-width: 767px){figure[data-name=\"frame\"]{padding:0.75rem!important}}html[data-current-path=\"/introduction\"] .card-group,html[data-current-path=\"/use-cases/overview\"] .card-group:has(>.card [data-component-part=\"card-content-container\"].items-center){row-gap:0.5rem!important}html[data-current-path=\"/introduction\"] .card-group>.card,html[data-current-path=\"/use-cases/overview\"] .card-group:has(>.card [data-component-part=\"card-content-container\"].items-center)>.card{margin-block:0!important}.template-meta{display:grid;grid-template-columns:7.5rem minmax(0, 1fr);gap:0.5rem 1rem;margin:0 0 1.5rem;padding:1.25rem;border-radius:var(--border-radius-rounded-xl, 0.75rem);background:#fafafa}.template-meta-label{margin:0;font-weight:500;color:#71717a}.template-meta-value{margin:0}html.dark .template-meta{background:#18181b}html.dark .template-meta-label{color:#a1a1aa}@media (max-width: 639px){.template-meta{grid-template-columns:minmax(0, 1fr);gap:0.25rem;padding:1rem}.template-meta-value:not(:last-child){margin-bottom:0.5rem}}"}],"page":{"pagePath":"get-started/connect-your-data","slug":"/get-started/connect-your-data","pageMetadata":{"title":"Connect your data","sidebarTitle":"1. Connect your data","description":"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.","href":"/get-started/connect-your-data"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,Frame,Heading,OptimizedImage,Step,Steps,Tab,Tabs,Tip,Visibility}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Visibility)_missingMdxReference(`Visibility`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Step 1 of 4. Connect a source or upload a file so Addison has data to work with.`}),`\n`,_jsxs(_components.p,{children:[`If your project already has the files or tables you need, skip ahead to `,_jsx(_components.a,{href:`/get-started/first-artifact`,children:`Create your first analysis`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`bring-data-in`,children:`Bring data in`}),`\n`,_jsxs(Tabs,{sync:false,children:[_jsxs(Tab,{title:`Connect a warehouse`,id:`connect-a-warehouse`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Connectors`}),` in the left sidebar, then `,_jsx(_components.strong,{children:`New connection`}),` at the top right. The wizard has three steps:`]}),_jsx(Frame,{caption:`The Connectors page: your data connections and their status`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=d885c7de2fa4f52eaf72df7aa5123e75`,alt:`The Connectors page titled 'Connectors — Create and manage data connections and app integrations', with a New connection button in the top-right and Data / Apps tabs below. A table lists connections by Name and Status, each with its source type beneath the name: bq_test (BigQuery), DEMO_WH (Snowflake), shortify-url (GitHub), Salesforce connection fresh (Salesforce), Shopify connection (Shopify), and NetSuite connection (NetSuite), each with a 'Last updated' date and a status dot.`,style:{maxWidth:`400px`,margin:`0 auto`,display:`block`},\"data-og-width\":`2036`,width:`2036`,\"data-og-height\":`1566`,height:`1566`,\"data-path\":`images/features/connectors/connectors-home.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=ff1fb9f2364f3d6b9161906ec1dfad27 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=48c33be705c67497a33c08ef0782c1a3 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=da47b67842e3c3d733bd15d31a09e27a 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=2e44eeca3b7fde43536284bb082343bc 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=c90d238cddf785dba414b8925bd0d438 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=d38959e147190d62cd0607a12ca2f0ef 2500w`})}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Choose a data source`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Snowflake`}),`, `,_jsx(_components.strong,{children:`Postgres`}),`, and `,_jsx(_components.strong,{children:`BigQuery`}),` sit under `,_jsx(_components.strong,{children:`Popular`}),`; the rest are under `,_jsx(_components.strong,{children:`Other`}),`.`]}),_jsx(Frame,{caption:`Step 1: choose a data source`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=b4b4348cae7c16923a887a332071fbef`,alt:`Step 1 of 3 of the New connection wizard, titled 'Choose a data source' with a progress indicator reading 1/3. A Popular row offers Snowflake (Data warehouse), Postgres (Database), and BigQuery (Data warehouse). An Other section lists S3 (File storage), GitHub (Repository), Databricks (Lakehouse), ClickHouse, MySQL, Oracle, MotherDuck, Redshift, GCS, SQL Server, REST API (HTTP endpoint), MongoDB (Document database), and Apache Iceberg (Lakehouse catalog). An Apps section below starts with Shopify, NetSuite, and Salesforce.`,style:{maxWidth:`400px`,margin:`0 auto`,display:`block`},\"data-og-width\":`1324`,width:`1324`,\"data-og-height\":`1624`,height:`1624`,\"data-path\":`images/features/connectors/wizard-choose-source.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=16622f402a86343a2a161e9ed7119fbf 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=17b3a6ea7fa2be81385a7e1d0d8b9cbc 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=52fe14f59775dda2543dff31eae2ca87 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e90b600af900fa164e015cd30d6d8626 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=aed44ea30c6369456ab8a2c038aa1583 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e82e96180e6ecfc87f6d77b3e2aea00b 2500w`})})]}),_jsxs(Step,{title:`Enter the details`,children:[_jsxs(_components.p,{children:[`Give the connection a `,_jsx(_components.strong,{children:`Name`}),`. It’s the identifier used in SQL later, so use letters, numbers, hyphens, and underscores only. Then fill in the credentials and click `,_jsx(_components.strong,{children:`Test connection`}),` before continuing. A pass means Summation could authenticate and reach your data.`]}),_jsx(Frame,{caption:`Step 2: connection details and credentials`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=2876b6e9531b13f9b2564173c872eb92`,alt:`Step 2 of 3 of the wizard, titled 'Connection details' (2/3). It has Name and optional Description fields, a 'Need help setting this up? View the setup guide' link, and a Snowflake section with an Authentication toggle between Password and Key pair, plus Account Identifier (myorg-myaccount), Warehouse (COMPUTE_WH), optional Role (ACCOUNTADMIN), Username, and Password fields. Below is a 'Scheduled snapshots' row with an Enabled checkbox and the note 'Datasets inherit this schedule unless they override or disable it.', and Test connection, Back, and Continue buttons with the hint 'Test your connection before continuing.'`,style:{maxWidth:`400px`,margin:`0 auto`,display:`block`},\"data-og-width\":`1324`,width:`1324`,\"data-og-height\":`1810`,height:`1810`,\"data-path\":`images/features/connectors/wizard-connection-details.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e872fc4038a70a0758a612465f5b6d5a 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=c536cf6d142cd59a5136b8f2a69e1a8f 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e365e99717b7d9e35cd3aae7a8d2a458 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=69a8e21f12a01a2d0a842caecf27ac06 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=64889e84416e4fc6ef5387ea4e63ae24 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=396ba23288b775710d0b3bd8296ad566 2500w`})})]}),_jsxs(Step,{title:`Add datasets`,children:[_jsxs(_components.p,{children:[`Pick the tables to bring in. Each one becomes a dataset available to Addison, to artifacts, and to your `,_jsx(_components.a,{href:`/features/tables`,children:`tables and data catalog`}),`.`]}),_jsx(Frame,{caption:`Step 3: pick the datasets to bring in`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=a0a3f0efb8264fd1a0b9a171c6d4eadc`,alt:`An 'Add datasets to this connector' dialog with a checkbox tree on the left rooted at '/' showing DEMO_DB, SNOWFLAKE, SNOWFLAKE_LEARNING_DB, and SNOWFLAKE_SAMPLE_DATA, and a searchable list on the right showing the same four entries each tagged with a yellow DATABASE badge and a drill-in chevron, above a footer reading '0 datasets selected' with Cancel and Add dataset buttons.`,style:{maxWidth:`400px`,margin:`0 auto`,display:`block`},\"data-og-width\":`1818`,width:`1818`,\"data-og-height\":`1518`,height:`1518`,\"data-path\":`images/features/connectors/wizard-add-datasets.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=d32573a72e0e40c99199ee385593064e 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=0e4782aea16f79d0476462285c298d5f 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=ac05ec03c6cf9ba8277882a7d02831b3 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=444b473111a545e1f51d2b216b887015 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=8281b234b90f501d1a3afb193027e298 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=2dc0db16e47613c1df559f31d4f06518 2500w`})})]})]}),_jsxs(_components.p,{children:[`How Summation reads and refreshes data depends on the connector and its settings. See `,_jsx(_components.a,{href:`/features/connectors`,children:`Connectors`}),` for details.`]})]}),_jsxs(Tab,{title:`Upload a file`,id:`upload-a-file`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Projects`}),` in the left sidebar (near the bottom, just above your profile) to see the list of projects you have access to. Click the project you want to add the file to — or `,_jsx(_components.strong,{children:`New Project`}),` if you’re starting fresh. This opens the project’s workspace.`]}),_jsxs(_components.p,{children:[`Above the file list, click `,_jsx(_components.strong,{children:`+ Import`}),`, then choose `,_jsx(_components.strong,{children:`Upload Files`}),` from the dropdown. Pick the file from your computer: CSV, Excel, PDF, PowerPoint, and more.`]}),_jsx(_components.p,{children:`The file lands in the project, and that’s already enough to work with: Addison can read it, analyze it, and build artifacts straight from it.`}),_jsxs(_components.p,{children:[`It does `,_jsx(_components.strong,{children:`not`}),` become a `,_jsx(_components.a,{href:`/features/tables`,children:`table`}),` on its own. To get it into the data grid, queryable in SQL and with a catalog you can describe, ask Addison to convert it: `,_jsx(_components.em,{children:`“turn this CSV into a table.”`}),` Worth doing for anything you’ll come back to.`]}),_jsx(Frame,{caption:`A project's file list, with the Import menu open`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/kBcFdZPA0-IfLZHe/images/get-started/connect-your-data/upload-menu.png?fit=max\u0026auto=format\u0026n=kBcFdZPA0-IfLZHe\u0026q=85\u0026s=0b9f638ecd0b1774b64ccf989927220a`,alt:`The 'My Project' workspace file list, with a 'Reports' folder in the table. Above the list, the + Import dropdown is open showing 'Data connections' (with a submenu arrow) and 'Upload Files' options, next to a separate Create button and search icon.`,\"data-og-width\":`3014`,width:`3014`,\"data-og-height\":`1484`,height:`1484`,\"data-path\":`images/get-started/connect-your-data/upload-menu.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/kBcFdZPA0-IfLZHe/images/get-started/connect-your-data/upload-menu.png?w=280\u0026fit=max\u0026auto=format\u0026n=kBcFdZPA0-IfLZHe\u0026q=85\u0026s=bd7123d8f642ac57c55b22189e2c7f83 280w, https://mintcdn.com/summation-676748f5/kBcFdZPA0-IfLZHe/images/get-started/connect-your-data/upload-menu.png?w=560\u0026fit=max\u0026auto=format\u0026n=kBcFdZPA0-IfLZHe\u0026q=85\u0026s=fb3220bfea5115bc99e5fab115afec60 560w, https://mintcdn.com/summation-676748f5/kBcFdZPA0-IfLZHe/images/get-started/connect-your-data/upload-menu.png?w=840\u0026fit=max\u0026auto=format\u0026n=kBcFdZPA0-IfLZHe\u0026q=85\u0026s=44fe298ce55ae74737dbba252aea1376 840w, https://mintcdn.com/summation-676748f5/kBcFdZPA0-IfLZHe/images/get-started/connect-your-data/upload-menu.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kBcFdZPA0-IfLZHe\u0026q=85\u0026s=7909079a0bef099280649110536d9458 1100w, https://mintcdn.com/summation-676748f5/kBcFdZPA0-IfLZHe/images/get-started/connect-your-data/upload-menu.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kBcFdZPA0-IfLZHe\u0026q=85\u0026s=6213578b74f1a0474d767ae6d301363d 1650w, https://mintcdn.com/summation-676748f5/kBcFdZPA0-IfLZHe/images/get-started/connect-your-data/upload-menu.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kBcFdZPA0-IfLZHe\u0026q=85\u0026s=9832bcf27caee0c791fbca6b7aad9d80 2500w`})}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`You can also drop a file straight into the Addison `,_jsx(_components.strong,{children:`chat composer`}),` with its `,_jsx(_components.strong,{children:`+`}),` button. That’s fine for a one-off question, but it’s ephemeral: the file is scoped to that chat and won’t be there in a new conversation or a future session. Upload to a project (as above) — or ask Addison to convert it to a table — for anything you’ll want to come back to.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`check-that-it-landed`,children:`Check that it landed`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`connection`}),` puts its datasets under `,_jsx(_components.a,{href:`/features/tables`,children:_jsx(_components.strong,{children:`Tables`})}),` in the left sidebar; click one to see the rows. An `,_jsx(_components.strong,{children:`uploaded file`}),` shows up in its project’s file list instead, and appears under `,_jsx(_components.a,{href:`/features/tables`,children:_jsx(_components.strong,{children:`Tables`})}),` only once you have asked Addison to convert it.`]}),`\n`,_jsx(Frame,{caption:`The Tables page`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/kKUH9dXzx-Aq6DU-/images/features/tables/tables-home.png?fit=max\u0026auto=format\u0026n=kKUH9dXzx-Aq6DU-\u0026q=85\u0026s=39821838da095f4d5459242e276cdd19`,alt:`The Tables page titled 'Create and manage your tables', with a Create button top-right. Type filter chips read All, Summation (21), and Snowflake (8). A table lists folders and tables with Name, Type, Column, Source, and Last refreshed columns: a Sales_Data folder, then tables allocate_plan, budget_plan, buy_plan, campaign_performance, and commissions_actuals, each sourced from Summation and last refreshed Aug 31.`,\"data-og-width\":`3016`,width:`3016`,\"data-og-height\":`1502`,height:`1502`,\"data-path\":`images/features/tables/tables-home.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/kKUH9dXzx-Aq6DU-/images/features/tables/tables-home.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKUH9dXzx-Aq6DU-\u0026q=85\u0026s=1a0e7e8bc57d2deeb02e04641dad74f1 280w, https://mintcdn.com/summation-676748f5/kKUH9dXzx-Aq6DU-/images/features/tables/tables-home.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKUH9dXzx-Aq6DU-\u0026q=85\u0026s=cb0f53a6141d077cac4febf19fdc2aff 560w, https://mintcdn.com/summation-676748f5/kKUH9dXzx-Aq6DU-/images/features/tables/tables-home.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKUH9dXzx-Aq6DU-\u0026q=85\u0026s=2cd4eba53532e78e0e0805a580fe7173 840w, https://mintcdn.com/summation-676748f5/kKUH9dXzx-Aq6DU-/images/features/tables/tables-home.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKUH9dXzx-Aq6DU-\u0026q=85\u0026s=c00368f2eb23d82e46973f246ad44c9a 1100w, https://mintcdn.com/summation-676748f5/kKUH9dXzx-Aq6DU-/images/features/tables/tables-home.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKUH9dXzx-Aq6DU-\u0026q=85\u0026s=5918addf3aced7ff4ba8991b9d9b990a 1650w, https://mintcdn.com/summation-676748f5/kKUH9dXzx-Aq6DU-/images/features/tables/tables-home.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKUH9dXzx-Aq6DU-\u0026q=85\u0026s=be533c5a0e5a76f0480620a5f78755ae 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/features/projects`,children:`Projects`}),` keep the files and context for a task together. Attach the tables and views you need as the project’s `,_jsx(_components.a,{href:`/features/projects#key-tables`,children:`key tables`}),` so Addison reaches for them first here. Addison can also work with uploaded project files without converting them to tables first.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Start narrow. Choose the data needed for one question. You can add business context as you review the answer.`})}),`\n`,_jsx(Heading,{level:`2`,id:`next`,children:`Next`}),`\n`,_jsx(Card,{title:`Create your first analysis`,icon:`file-lines`,href:`/get-started/first-artifact`,horizontal:true,children:_jsx(_components.p,{children:`Step 2: ask a question, create a report, and check its evidence.`})}),`\n`,_jsx(Visibility,{for:`agents`,children:_jsxs(_components.p,{children:[`Creating a connection and attaching datasets over the API is on `,_jsx(_components.a,{href:`/features/connectors`,children:`Connectors`}),`; read its `,_jsx(_components.strong,{children:`API`}),` tab rather than assuming this page maps one-to-one. Two traps that page documents and are worth carrying into any scripted setup: connector config keys are sent in `,_jsx(_components.code,{children:`snake_case`}),` while responses render them in `,_jsx(_components.code,{children:`camelCase`}),`, and `,_jsx(_components.code,{children:`undocumented_types`}),` does not mean uncreatable.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connect your data","sidebarTitle":"1. Connect your data","description":"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.","href":"/get-started/connect-your-data"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Bring data in","slug":"bring-data-in","depth":2,"children":[]},{"title":"Check that it landed","slug":"check-that-it-landed","depth":2,"children":[]},{"title":"Next","slug":"next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/summation-676748f5/109fb4ec55c4f518/theme-toggle.js","/_mintlify/custom/summation-676748f5/767147eed46ae967/toc-indicator.js","/_mintlify/custom/summation-676748f5/82e2d1909a80e450/sidebar-collapse.js"],"subdomain":"summation-676748f5","siteName":"Summation","title":"Connect your data - Summation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-10T01:30:45.322Z","originalFileLocation":"get-started/connect-your-data.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Summation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect your data - Summation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Summation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.summation.com/get-started/connect-your-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://summation-676748f5.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Connect+your+data\u0026amp;description=Connect+a+warehouse+or+upload+a+file+to+give+Addison+the+data+it+needs+to+identify+insights+across+your+business.\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=fbed9b6afdef8312f3ae9dc7a438044b8bc7e6c015b492a3a010a8b4cf80148c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connect your data - Summation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://summation-676748f5.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Connect+your+data\u0026amp;description=Connect+a+warehouse+or+upload+a+file+to+give+Addison+the+data+it+needs+to+identify+insights+across+your+business.\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=fbed9b6afdef8312f3ae9dc7a438044b8bc7e6c015b492a3a010a8b4cf80148c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Summation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.summation.com/get-started/connect-your-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/get-started/connect-your-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.summation.com/#organization\",\"name\":\"Summation\",\"url\":\"https://docs.summation.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.summation.com#website\",\"name\":\"Summation\",\"url\":\"https://docs.summation.com\",\"publisher\":{\"@id\":\"https://docs.summation.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.summation.com/get-started/connect-your-data#webpage\",\"url\":\"https://docs.summation.com/get-started/connect-your-data\",\"name\":\"Connect your data\",\"description\":\"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.\",\"dateModified\":\"2026-09-10T01:30:45.322Z\",\"isPartOf\":{\"@id\":\"https://docs.summation.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.summation.com/get-started/connect-your-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.summation.com/get-started/connect-your-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://docs.summation.com/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect your data\",\"item\":\"https://docs.summation.com/get-started/connect-your-data\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.summation.com/get-started/connect-your-data#article\",\"headline\":\"Connect your data\",\"name\":\"Connect your data\",\"description\":\"Connect a warehouse or upload a file to give Addison the data it needs to identify insights across your business.\",\"url\":\"https://docs.summation.com/get-started/connect-your-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.summation.com/get-started/connect-your-data#webpage\"},\"dateModified\":\"2026-09-10T01:30:45.322Z\",\"publisher\":{\"@id\":\"https://docs.summation.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.summation.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Summation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Summation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/get-started/connect-your-data.md","siteName":"Summation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","pages":[{"title":"What is Summation?","description":"Summation is an AI analyst that helps you monitor your business, get insights you can trust, plan and forecast, and automate recurring work.","href":"/introduction"},{"title":"Connect your data","sidebarTitle":"1. Connect your data","href":"/get-started/connect-your-data"},{"title":"Create your first analysis","sidebarTitle":"2. Create your first analysis","description":"Ask Addison a question, create a report, and check the result.","href":"/get-started/first-artifact"},{"title":"Refine your business context","sidebarTitle":"3. Refine your business context","href":"/get-started/build-your-context"},{"title":"Automate your first workflow","sidebarTitle":"4. Automate your first workflow","href":"/get-started/first-workflow"}]},{"group":"Key concepts","pages":[{"title":"Addison","href":"/features/addison"},{"title":"Projects","href":"/features/projects"},{"group":"Artifacts","pages":[{"title":"Verified Artifacts","sidebarTitle":"Overview","href":"/features/artifacts"},{"title":"Verification","href":"/features/artifacts/verification"},{"title":"Reports","href":"/features/artifacts/reports"},{"title":"Dashboards","href":"/features/artifacts/dashboards"},{"title":"Decks","href":"/features/artifacts/decks"},{"title":"Playbooks","href":"/features/artifacts/playbooks"},{"title":"Excel","href":"/features/artifacts/excel"},{"title":"HTML","href":"/features/artifacts/html"}]},{"title":"Workflows","href":"/features/workflows"},{"title":"Applications","href":"/features/applications"},{"group":"Tables","pages":[{"title":"Tables","sidebarTitle":"Overview","href":"/features/tables"},{"title":"Data table","href":"/features/tables/data"},{"title":"Source table","href":"/features/tables/source"},{"title":"Calculation table","href":"/features/tables/calculation"},{"title":"Dimension table","href":"/features/tables/dimension"},{"title":"Views","href":"/features/tables/views"}]},{"title":"Knowledge","href":"/features/knowledge"},{"title":"Skills","href":"/features/skills"}]},{"group":"Connectors","pages":[{"title":"Connectors","sidebarTitle":"Overview","href":"/features/connectors"},{"title":"Apps","href":"/features/connectors/apps"},{"title":"Snowflake","href":"/features/connectors/snowflake"},{"title":"BigQuery","href":"/features/connectors/bigquery"},{"title":"Databricks","href":"/features/connectors/databricks"},{"title":"Postgres","href":"/features/connectors/postgres"},{"title":"Redshift","href":"/features/connectors/redshift"},{"title":"MySQL","href":"/features/connectors/mysql"},{"title":"SQL Server","href":"/features/connectors/mssql"},{"title":"ClickHouse","href":"/features/connectors/clickhouse"},{"title":"MongoDB","href":"/features/connectors/mongodb"},{"title":"Oracle","href":"/features/connectors/oracle"},{"title":"MotherDuck","href":"/features/connectors/motherduck"},{"title":"REST API","href":"/features/connectors/http"},{"title":"Datadog","href":"/features/connectors/datadog"},{"title":"S3","href":"/features/connectors/s3"},{"title":"Apache Iceberg","href":"/features/connectors/iceberg"},{"title":"AWS Glue","href":"/features/connectors/glue"},{"title":"GCS","href":"/features/connectors/gcs"},{"title":"Google Sheets","href":"/features/connectors/google-sheets"},{"title":"GitHub","href":"/features/connectors/github"}]},{"group":"Agent integrations","pages":[{"title":"Claude Plugin","href":"/integrations/claude-plugin"},{"title":"Codex Plugin","href":"/integrations/codex-plugin"},{"title":"MCP Server","href":"/integrations/mcp-server"}]}]},{"tab":"Use cases","icon":"lightbulb","pages":[{"title":"Use cases","href":"/use-cases/overview"}]},{"tab":"API","icon":"code","pages":[{"title":"API","href":"/api/overview"}]}]},"basePath":"","title":"Connect your data - Summation","buildId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","deploymentId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-CTNA9txH.js","DynamicMarkdown-DMUWO-az.js","zoom-image-lightbox-CLs1Rxcl.js","lightbox-handle-r17bVUz3.js"]}