Feeds

A feed connects an external source — an online store, a product catalogue, any system that holds records — and keeps those records mirrored into your search, on a schedule, with no work on your part. You connect it once; from then on the source is the master copy and your search follows along. Every provider works the same way; this page covers that shared machinery, and each provider has its own guide for its specifics (see Providers below).

Auto-plays · use Back / Next to step through at your own pace.

What a feed actually does

A feed does one thing: it writes a single, always-current file into one of your media stores, at feeds/<name>.ndjson. That’s the whole of a feed. It doesn’t own a list, and it isn’t tied to your plan or subscription — it just keeps that one file in step with the source.

Making the file searchable is the same import you already know: point a list at the feed’s file and turn on keep-in-sync, exactly as you would for a file you uploaded yourself (see Media Stores). The feed refreshes the file from the source; the list refreshes its records from the file. Two simple, familiar steps — nothing new to learn.

The source stays in charge

Feed records are read-only and source-owned. The source decides each record’s identity and shape, so a record renamed at the source updates the same record here rather than creating a duplicate, and a record removed there is retired here on the next sync. You search and read these records like any others; you just don’t hand-edit them, because the source is the master copy and the next sync would overwrite the change.

Connect a feed

1. Go to Feeds (under Sources in the sidebar, next to Media).
2. Click Connect feed and choose a provider.
3. Give the feed a name and the source’s details — what those are depends on the provider, and its guide walks you through getting them (see Providers below). Choose which media store the synced file should live in (your built-in store by default).
4. Click Connect. The details are checked against the live source there and then, so a typo is caught immediately rather than failing quietly later, and the first sync starts right away.

Make it searchable

The feed keeps a file up to date; a list is what makes it searchable. Binding the two takes a minute:

1. Go to Lists → Create List. Name it, and make sure the Media Store picker (near the top of the dialog) is set to the same store your feed writes into — the built-in store unless you chose otherwise.
2. Open the new list and click the import button (the up-arrow in the header). The dialog opens on the From media store tab.
3. Pick your feed’s file — feeds/<name>.ndjson — and leave Keep in sync switched on.
4. Click Import. Your records appear, with the right fields created automatically — the feed’s file describes its own fields, so there’s nothing to map.

That’s the whole loop: change a record at the source, the feed refreshes the file on its next check, and keep-in-sync updates your list. Try a search on the list straight away to see your records come back.

How often it syncs

Each feed polls its source on an interval you set — 30 minutes by default, and no less than 5 minutes. Change it any time from the feed’s Edit interval action, or press Sync now to pull the latest immediately without waiting for the next scheduled check. A feed only rewrites its file when the source has actually changed, so quiet sources cost nothing.

The Feeds list shows each feed’s provider, synced file, interval and last-checked time, with a status badge — Synced once it has run, Waiting for first sync until then. The ⋯ menu on each row holds Sync now, Edit interval and Delete.

Free plan: automatic syncing rests while you’re away

On the free plan, a feed’s automatic syncing takes a break after 14 days without a sign-in. Nothing is deleted and your records stay searchable; syncing picks up again within minutes of your return, and a notice on the Feeds and Media pages tells you if it happened. Sync now always works, even while paused. Paid plans sync continuously, however long you’re away.

Deleting a feed

Deleting a feed removes the feed and its synced file — and only those. Any list you bound to that file keeps every record it already has; it simply stops receiving updates, because the file it synced from is gone. Your search doesn’t suddenly empty out; it just stops moving. Delete the list separately if you no longer want those records.

Providers

Everything above is the same whichever source you connect; each provider’s guide covers only its own details — the credentials it needs and the fields its records get. More providers are on the way.

• Shopify — mirrors your store’s products, with optional stock levels and best-seller counts. The guide includes the two-minute, one-time credential setup.