You can only import from organizations and stores you’re a member of. The picker is scoped by your access, so importing across organizations works only when your account belongs to more than one. You’ll never see, or be able to copy, a component from a store you don’t have access to.
How it works
__importSource), which is what powers Re-sync and keeps the same component from showing up again on a second import.
Importing components
Open the dialog
Go to store → Components and click Import components. The picker loads the organizations and stores you can import from.
Pick a source organization and store
Choose an Organization, then a Store within it. Only stores other than the one you’re importing into are listed.
Select components
Check the components you want, or use Select all. The list shows each component’s name and slot, and only includes components that are worth importing (see below).
Choose the target version
Pick the version the copies should land in. It defaults to the version you’re viewing, or your store’s default version.
Reference
What shows up in the list
What shows up in the list
The picker lists active components from the source store that have a built artifact. It hides anything that wouldn’t be a useful import:
- Components you’ve already imported from that source.
- Components whose build already exists in your store (same underlying build), so you don’t get duplicates.
- Duplicate builds within the source itself (listed once).
What an import creates
What an import creates
For each selected component, the import:
- Creates a new component with its own id in the chosen target version.
- Copies the name, slot, and props from the source.
- Copies the build artifact to the new id, so the copy renders on its own and doesn’t depend on the source store staying around.
- Marks the copy inactive and records its origin in
__importSource.
Synced copies & Re-sync
Synced copies & Re-sync
Because an imported copy remembers where it came from, its detail page shows a Synced copy notice with a Re-sync button.
- Re-sync re-copies the latest build from the original source component into your copy. Use it to pull updates after the source changes.
- Avoid deploying a fresh build onto a synced copy unless you mean to replace it: a deploy here overwrites the synced build, and a later Re-sync would overwrite your changes in turn.
Troubleshooting
No stores available to import from
No stores available to import from
You’re only a member of the store you’re importing into (or of organizations with no other stores). Importing needs at least one other store you have access to.
'Nothing new to import from this store'
'Nothing new to import from this store'
Every importable component from that store is already in your store, or none of its components have a built artifact yet. Build and deploy the component in the source store first, then try again.
An imported component isn't rendering
An imported component isn't rendering
Imports arrive inactive on purpose. Open the component and activate it once you’ve confirmed its props and slot.
The source component changed but my copy didn't
The source component changed but my copy didn't
Copies don’t update automatically. Open your copy and click Re-sync to pull the latest build from its source.
Related
- Components — how components work
- Custom Component — building a component from scratch
- Studio — preview and deploy components from the Admin dashboard
- Versions — where imported copies land