> ## 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 Google Analytics 4

> Migrate your GA4 historical pageview data to GhostlyX.

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

## Step 1: Export from GA4

**Option A: Explorations export (recommended for most sites)**

1. In Google Analytics 4, go to **Explore**.
2. Create a **Blank exploration**.
3. Add the dimension **Page path and screen class**.
4. Add the metric **Views**.
5. Set the date range to cover the full period you want to import.
6. Click the export icon and choose **CSV**.

**Option B: BigQuery export (for large datasets)**

If your site has millions of pageviews, use the GA4 BigQuery export to avoid row limits in the Explorations UI. Export the data and format it as a CSV with columns `Page path and screen class` and `Views`.

## Step 2: Upload to GhostlyX

1. Go to your site dashboard and click **Import Data**.
2. Select **Google Analytics 4**.
3. Upload the CSV file.
4. Click **Start import**.

## Column mapping

| GA4 column                 | GhostlyX field |
| -------------------------- | -------------- |
| Page path and screen class | Page path      |
| Views                      | Pageviews      |

## Notes

* GA4 does not export unique visitors per page in the standard Explorations export. Imported data will show pageviews only; visitor counts for historical data will not be available.
* Query parameters are included in the page path column from GA4. GhostlyX will import them as-is.