# Install Ordinary from the Shopify App Store

> How to install Ordinary on your Shopify store and get the first-party pixel capturing data within minutes.

Source: https://help.tryordinary.com/getting-started/install

---

Getting Ordinary onto your Shopify store takes about two minutes and
doesn't require any code. After install, our first-party pixel starts
capturing sessions immediately — you'll see live data on the dashboard
the same day.

## What you'll need

- A Shopify store (any plan — Basic, Shopify, Advanced, or Shopify Plus)
- Admin access to that store
- A valid email to create your Ordinary account (unless you've been
  invited to an existing account)

## Step-by-step

### 1. Find Ordinary on the Shopify App Store

Search for "Ordinary" on the Shopify App Store, or visit the direct
listing. Click **Install**.


### 2. Approve the scopes

Shopify shows an approval screen listing the data Ordinary can read.
The scopes we request:

- **Read products, orders, customers** — for attribution and reporting.
- **Read reports** — lets us pull your authoritative 12-month GMV for
  tier-appropriate enforcement and reporting.
- **Read customer events** — the first-party pixel.
- **Write pixels** — to install our Customer Events extension automatically.
- **Read all orders** — required for historical order backfill beyond
  Shopify's default 60-day window.

Click **Install app** to approve.


### 3. Sign up or sign in

If this is your first time:

- Ordinary creates a fresh organization named after your shop.
- You'll sign up with your email. The email you use becomes the
  **owner** of the organization.
- The first-party pixel is activated automatically — no code paste
  required.

If your organization already exists (e.g. a teammate invited you):

- You're added to that organization as an admin.
- Any prior data syncs forward; there's nothing to migrate.

### 4. You're in

The dashboard loads with live data as soon as the first orders and
pixel events come through. You'll usually see:

- Today's revenue trend within ~30 seconds of your first new order
- Pixel sessions within a minute of the first storefront visit
- Recent orders within a few minutes; full historical backfill
  finishing in the background (see below)


## What happens next (automatic)

- The first-party Customer Events pixel begins tracking immediately.
- **Full historical backfill of orders, customers, and products** is
  enqueued in the background. With the `read_all_orders` scope granted
  during install, Ordinary pulls every order in your store's lifetime
  (not just the last 60 days). Smaller stores finish in a few minutes;
  larger stores (10k-50k orders) take 10-25 minutes. You can keep using
  the dashboard while it runs — recent data is ready first.
- Your authoritative 12-month GMV is fetched from Shopify's analytics
  and used to size you to the right plan bracket (see
  [Understanding your GMV tier](https://help.tryordinary.com/concepts/gmv-tiers)).

## Common questions

**Do I need to paste a pixel snippet into my theme?**
No. Ordinary uses Shopify's Customer Events extension, which Shopify
auto-loads on every storefront page. Nothing to copy-paste.

**What if I already had a different attribution tool installed?**
Disable the old tool's pixel in Shopify admin → Settings → Customer
events so events don't double-fire. Your Ordinary data is independent
and won't conflict with the old tool's data.

**Can I start on the Free plan and upgrade later?**
Yes. Free is the default at install; upgrade any time from
Settings → Billing.

**I got an error during install — what now?**
See [Pixel says "Disconnected"](https://help.tryordinary.com/troubleshooting/pixel-disconnected)
if the pixel didn't activate, or email
[support@tryordinary.com](mailto:support@tryordinary.com) if the install
itself failed.

## What's next

- [First-time setup checklist](https://help.tryordinary.com/getting-started/setup-checklist) — the 5-minute
  post-install workflow to get the most out of Ordinary.
- [Connecting your first data source](https://help.tryordinary.com/getting-started/connect-first-source) —
  wire up Meta, Amazon, or Google Analytics.
- [Inviting your team](https://help.tryordinary.com/getting-started/invite-team).
