Connect a Shopify store

Bring products, customers, locations, orders and inventory from Shopify into Biosphere. Each download lands in Inbox with suggested field choices. Review them once; later eligible arrivals use that source’s approved choices automatically.

Connect a store

1. Open Configure, select Connections, then Shopify.
2. Select Connect Shopify. When a store is already connected, select Add another store.
3. On Shopify, choose your store. Back in Biosphere, choose the business to connect, then approve access on Shopify.
4. Return to the same browser where you started. Biosphere shows the store with its status, such as “Connected · Automatic syncing on”.

The first time a store connects, Biosphere starts downloading everything it gave access to. A new store starts with automatic syncing on for all of that data.

If connecting fails, Biosphere shows the reason and a reference. Finish in the browser where you started. If the store was connected but setup could not finish, select Retry connection. Otherwise open your business and start a new connection.

If Shopify stops accepting access, the store shows Reconnect your store. Select Reconnect and approve access again. Automatic syncing resumes after a successful reconnect.

Choose what stays in sync

Automatic syncing keeps the data you choose up to date. Changes arrive from Shopify as they happen, with regular catch-up and a daily check.

1. Turn Automatic syncing on or off.
2. Under Data to keep in sync, turn on each kind of data: Products and variants, Customers, Locations, Orders, Inventory.
3. Select Save sync settings.

Pausing lets the current sync finish. To turn syncing on, choose at least one kind of data. Your store stays connected while syncing is paused. Biosphere renews access automatically; removing the app in Shopify disconnects the store.

If a kind of data shows “Reconnect to grant access”, the store hasn’t given Biosphere access to it. Select Reconnect and approve the extra access on Shopify.

Download data now

Under One-time download:

• The Sync now button downloads the data chosen under Choose data for Sync now.
• The Download all available data button downloads everything the store gave access to.

Neither changes your automatic syncing settings. Both are unavailable while a sync is running or while the store needs attention.

Review Shopify data in Inbox

1. Select Open Inbox on the store.
2. Open the store’s arrival. Its retained pages and collections stay together. Suggested fields come from the connection’s starter choices and can be changed in Manual.
3. The store is already chosen in From, because each store is its own source.
4. Review the proposed products, orders, lines and customers together, resolve any uncertain matches, then approve. Manual lists Biosphere’s fields with the incoming paths and samples beside them.

After the first approval, later syncs apply on their own when the source’s approved choices, validation and ownership checks allow it. New optional paths stay in the evidence; a missing mapped required path returns to review. See Map a source.

Check sync history

1. Open Sync details on the store.
2. Each sync shows its status (Queued, Syncing, Downloaded, Needs attention or Cancelled), its kind (Changes, Full download or Catch-up scan) and when it started.
3. Open a sync to see the pages it saved with their record counts. Use the Review page link to open a page in Inbox.

Downloaded means the pages were saved, not that their records were approved.

When some data couldn’t be downloaded, the store shows “Some data could not be downloaded.” Use the Inspect and retry the failed job link to retry it on the Background jobs page. When a sync was cancelled, start a new download to continue.

Check for missing records

Under Sync details, the Check for missing records button scans the store for records Biosphere saw before that Shopify no longer has. Findings are listed for review and never delete anything. See Find records missing from a source.

Disconnect a store

Biosphere has no disconnect button. To disconnect, remove the Biosphere app from the store in your Shopify admin.

The store then shows “Connection needs attention” and stops syncing. Its downloads, approved records and history stay in Biosphere. To connect it again, select Reconnect.

What to know

• Biosphere only reads from Shopify. It never changes your store, charges payments or fulfills orders.
• How much order history you get depends on the access Shopify grants.
• A download reads the store while it may be changing, so it isn’t a picture of one exact moment.
• Each store runs one sync at a time.
• A sample connection is labeled “Sample connection” and can’t download data. Select Connect Shopify to connect a real store.