Inspect before you change anything
Companies & locations reads the authenticated store's native companies, company locations, company contacts and buyers, then draws them as a hierarchy: store → company profile → company → purchasing location → buyer. It is a reading and review surface first. A profile label or a tag never grants catalog access, credit, tax exemption or payment terms on its own.
The workspace shows only loaded records — up to 300 nodes — and says so when the view is incomplete. It reads companies a page at a time and loads a few pages on its own; while more companies exist, Load more companies appears with more companies exist next to the loaded count. Buyer assignments beyond the displayed page stay in Shopify. Use the details panel's Open company in Shopify or Open customer in Shopify link when you need the full record.
Use the search field with Search to look a company up directly, and Group companies to switch between By company profile and All companies. The store card's plus button follows that switch: with profiles shown it adds a Profile name, without them it adds a Native company.
Two presentations
The same records are available as a Relationship map canvas and as a Company tree. Both read the same saved order, so a change you make in one view appears in the other.
- Relationship map draws one row per level, with each parent centred above its children. The layout is computed by the app; you are not arranging a diagram by hand.
- Company tree lists the same hierarchy as indented rows — profile, then company, then purchasing location, then buyer — in the order you set on the map.
Canvas tools, Hand and Select
The map toolbar holds two groups of controls.
- Hand and Select decide what dragging does, and the toolbar says which is active: Hand: pan and zoom · click a card to edit, or Select: drag a card to reorder · Shift + click for several. Hand only pans and zooms the view — clicking a card still opens it, and its plus button still adds a child. Select is the mode where dragging a card changes order: drop it on a sibling and the two swap places, then the app returns both cards to their computed positions. Dragging several cards at once moves them on screen but does not change any order. Neither mode writes to Shopify.
- Expand all, Collapse all, Hide companies / Show companies, Hide locations / Show locations and Hide buyers / Show buyers set how deep the hierarchy is drawn. The level controls share one depth, so Show locations cancels a collapsed map and stops at locations with buyers still folded, Show buyers expands locations as well, and Collapse all folds every level. Each button reports its own pressed state.
Every card also has its own collapse control for its next level, showing the chevron, the child count and the right noun for that level — ⌄ 3 companies on a profile, ⌄ 2 locations on a company, ⌄ 1 buyers on a location. A single card's collapse is a local action: the map keeps the current view instead of jumping back to a tidy overview, and only Expand all, Collapse all and the level buttons refit the canvas to fill the screen.
Each card's plus button adds the next level down: a buyer from a location, a location from a company, a company from a profile, and a profile from the store card when the map is grouped by profile (the store card's button is labelled Add company profile to …, or Add company to … when profiles are hidden).
What is saved is the sibling order, the viewport and which cards are collapsed — per staff member, so the map reopens the way you left it. Coordinates are not saved, because the app computes them from the hierarchy.
Dragging is an intent, not an edit
In Select mode, dropping a card on a target asks a question; it does not answer one. Dropping a company onto a profile group opens a reviewed profile assignment preview; dropping a buyer onto another location inside the same company opens a reviewed move preview. Nothing is written until you confirm.
Three destinations are refused with an explanation: a buyer who already has access to that location, a location in a different company — a Shopify company contact cannot be reparented, so that case needs a separate reviewed onboarding — and a profile that has not been saved yet.
Company profiles
A company profile is the app's grouping label for companies. It is not a Shopify object, so it needs no company to exist: you can name a profile, save it, and assign companies later. Profiles are stored first as app drafts, and you can rename a draft and assign companies to it without touching Shopify.
Assigning a profile writes the Shopify company metafield kaupvik.profile_tags on the selected companies — the first tag in the list is the group shown on the map — and an optional kaupvik.logo_url for the logo. That only happens after a reviewed assignment, never while you type. Limits are 12 tags of up to 50 characters each, and a logo must be a public HTTPS URL.
Use the profile card's Profile tab to rename it (a profile name is 1–50 characters) and Assign companies to choose members, then Review profile assignment. Companies that already carry the profile's tag start checked and are marked In profile, so a profile never looks emptier than it is. The note above the list states Up to 50 companies per reviewed assignment. If more companies exist than the loaded page, load more from the workspace below before you select.
Renaming a profile draft does not rewrite native companies. Select the companies and apply the assignment to push the current tags. Delete profile removes that profile and its aliases from the listed companies; the companies, locations, buyers, other tags and logos are preserved.
You can also see the tags in Shopify admin under the company's metafields. They are labels for your own reporting and grouping — not catalogs, prices, terms or eligibility.
Inspector tabs on each card
Selecting a card opens a details panel with Close details, that record's own Open … in Shopify link and a small set of tabs, so a row of add and edit buttons does not take over the panel:
- Store card: Company profile and Native company, under the strip Add to your organization
- Company profile card: Profile and Assign companies
- Company card: Properties, Company profile, Add location and Add buyer
- Location card: Properties and Add buyer
- Buyer card: Properties and Location access
The Properties tab is Edit properties with Review field changes: company name, external ID and internal note; location name and external ID; a buyer's first and last name. Company profile holds Company profile tags (first tag is the group) and Company logo URL (optional HTTPS) with Review profile. Add buyer offers Create a new customer or Use an existing Shopify customer, then Find existing customer and Choose the actual customer — a buyer created that way is confirmed with Review buyer onboarding. Location access moves access with Source location → Move access to then Review access move, and can Remove access to this location or Remove buyer from company. A company or location also has More actions with Add to bulk name changes and Review deletion of empty record.
Adding from a card's plus button keeps the context. A company added from a profile card returns to a reviewed profile assignment, so the new company is tagged in the same pass; if that profile is still an unsaved draft, the app asks you to save the profile name first instead of writing an untagged company.
Reviewed operations
Every native change from this screen becomes a saved preview under Review changes before saving. Nothing is written until you confirm, and the app reads the native record back afterwards.
- create a company, or create a purchasing location inside a company
- update a company name, external ID or internal note; a location name or external ID; a customer's first or last name
- assign or update a company profile
- move buyer access to another location in the same company — the destination role is assigned first and the source access is removed only after the native result is verified
- remove a buyer's access to one location, or remove the buyer from the company — the Shopify customer itself is preserved
- delete an empty company, or a location that has no buyer access. A company with locations or contacts and a location with buyer access are refused; review those in Shopify first, and customers are never deleted here
Deletions ask you to Type {record name} to confirm deletion before Confirm deletion, and the delete action is described as a Review deletion of empty record. A confirmation button reads Confirm & save to Shopify; while a plan runs you can Stop after current write, Check native result if an outcome was uncertain, or Cancel remaining changes. Deleting or moving a record does not guarantee that its original ID can be restored later. If Shopify changed a record after you opened the preview, the app refuses to confirm and asks for a new preview instead of overwriting the newer work.
Renaming several records at once happens in the Bulk name changes card: select the records, edit their names, then Preview name changes. The preview counts its verified changes and shows the old and proposed name per row; Confirm this preview, Apply confirmed changes, Stop after current change, Check uncertain native result and Cancel remaining changes work the same way as any other plan. Bulk names change names only — never access, prices, terms or taxes.
Changes made here are listed in Bulk change history as an audit record, and every finished change also keeps one version under Version history, where a change that did not delete a native record can be rolled back through a reviewed, verified plan. Understand tasks, reports and change history explains where both histories live and what a rollback can and cannot restore.
Frequently asked questions
How do I visualize and manage multi-location B2B companies in Shopify?
Inside the Companies & locations workspace, switch between an interactive Relationship map — a tidy layered canvas with Hand pan and zoom, Select drag-to-reorder, per-card collapse and level filters — and a Company tree to organise company profiles (the kaupvik.profile_tags metafield), add purchasing locations, or move buyer location access through a reviewed operation.
What is the difference between a company profile and a native Shopify company?
A company profile is an app-level grouping label that only exists as Kaupvik draft data until you assign it, while a native company is a Shopify record that owns locations, contacts and buyers. Assigning a profile writes the Shopify company metafield kaupvik.profile_tags on the selected companies and never renames the company.
Why does a company profile work without any company attached?
Because a profile is only a grouping label in this app and not a Shopify object, you can create and name one before any company exists and assign companies to it later. A profile with no members stays a saved draft, and deleting it leaves the companies, locations, buyers and other tags untouched.
What is the difference between Hand and Select on the relationship map?
Hand only pans and zooms the canvas; clicking a card still opens it and its plus button still adds a child. Select is the mode where dragging a card onto a sibling swaps their order, and because the app computes every position, no coordinates are stored and no Shopify record changes.
Why does the canvas keep the current view when one card collapses?
A single card's collapse is a local edit, so the map keeps the camera where you were working and only repositions the remaining cards. Only the global level controls — Expand all, Collapse all and Show or Hide companies, locations and buyers — refit the canvas to a tidy overview.
What does the company tree show?
The company tree lists the same hierarchy as the relationship map — company profile, company, purchasing location and buyer — as indented rows in the same saved order, so the two views always agree. It is a reading and organising view; every change still goes through a reviewed operation.