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

# Import from CSV

> Import historical pageview data using the generic CSV format.

<Note>
  Data import requires the **Scale plan**.
</Note>

## When to use the CSV import

Use the generic CSV import when your analytics platform is not in the list of supported sources, or when you have custom-generated pageview data you want to blend into GhostlyX.

## Required columns

Your CSV must have at least two columns: one for the page path and one for the pageview count.

**Accepted path column names:**

* `path`
* `page`
* `pathname`
* `url`
* `page_path`
* `page path`
* `Page path and screen class`

**Accepted pageviews column names:**

* `pageviews`
* `views`
* `hits`
* `page_views`
* `Pageviews`
* `Unique Pageviews`

Column names are case-insensitive.

## File requirements

| Requirement       | Detail   |
| ----------------- | -------- |
| Encoding          | UTF-8    |
| Maximum file size | 100 MB   |
| Delimiter         | Comma    |
| Header row        | Required |

## Number formatting

Numbers with thousands separators are handled automatically. Both `1234` and `1,234` are accepted as valid pageview counts.

## Example file

```csv theme={"dark"}
path,pageviews
/,12450
/blog,4320
/blog/getting-started,1890
/pricing,980
/about,540
```

## Step-by-step

1. Prepare your CSV file with the correct columns and encoding.
2. Go to your site dashboard and click **Import Data**.
3. Select **Generic CSV**.
4. Upload your file.
5. GhostlyX will preview the column mapping. Confirm it looks correct.
6. Click **Start import**.