> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summation.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Source table

> A Summation table populated by importing a file.

A **source table** is a [Summation table](/features/tables) populated by **importing a file** (CSV). Use it to land external file data in the grid when it isn't coming from a live [connector](/features/connectors) — a one-off load you refresh by re-importing.

**What you can do**

* Upload a CSV (up to 1 GB) and map its columns to typed table columns, marking each nullable or unique.
* Set file options (text encoding, column separator, text delimiter) and a date format, and optionally add a **load date** column.
* Refresh the data by re-importing the file.

## Create a source table

<Tabs sync={false}>
  <Tab title="In the app">
    On the [Tables](/features/tables) page, click **Create → Source Table**, then **Upload File** and choose a `.csv`. Map the columns and click **Import**. (The **Integration** tab is coming soon; for live external data, use a [connector](/features/connectors) instead.)

    <Columns cols={2}>
      <Frame caption="Upload a CSV">
        <img src="https://mintcdn.com/summation-676748f5/ewrpxeNnW54PEh54/images/features/tables/source-upload.png?fit=max&auto=format&n=ewrpxeNnW54PEh54&q=85&s=55453749f3f06890f1729c8185e5a069" alt="An 'Upload File / Integration' dialog with a drag-and-drop area reading 'Drag and drop or browse your files to upload', .csv up to 1GB." width="2796" height="1712" data-path="images/features/tables/source-upload.png" />
      </Frame>

      <Frame caption="Map columns and import">
        <img src="https://mintcdn.com/summation-676748f5/ewrpxeNnW54PEh54/images/features/tables/source-import.png?fit=max&auto=format&n=ewrpxeNnW54PEh54&q=85&s=6fb181add58c48e731bb85284b85cc4c" alt="A 'New Table' import panel with File Options (text encoding utf-8, comma separator, double-quote delimiter), Values format (date format auto detect), Column mapping (Source to Target, Type, Nullable, Unique), an 'Add load date' toggle, and an Import button." width="2788" height="1714" data-path="images/features/tables/source-import.png" />
      </Frame>
    </Columns>
  </Tab>

  <Tab title="Via the API">
    <Card title="POST /v1/table-imports" icon="code" href="/api-reference/tables/create-table-import" horizontal>
      Import a file into a new source table, or refresh an existing one — set `import_type` to `FULL_REFRESH` or `INCREMENTAL_REFRESH` to re-import into a table that already exists (the API counterpart of the refresh above).
    </Card>

    <Card title="GET /v1/table-imports/{importId}" icon="code" href="/api-reference/tables/show-table-import" horizontal>
      Poll an import's status.
    </Card>
  </Tab>
</Tabs>