Settings
Manage client connections, users, notifications, security, product categories, and SKU sync.
The Settings area controls how the app connects to ShipHero and who can use it. Some screens are for National Commerce staff only.
The sidebar and the link bar at the top of each Settings screen list the same screens in the same order: Notifications, Security, Client Connections, Product Categories, SKU Sync, and Users. Client Users see fewer of them, and both lists hide the same ones.
Account means ShipHero connection
An Account is one connection to ShipHero, and the Client Connections screen lists them. The database calls it a brand. Each account holds its own ShipHero tokens, users, and data.
Who can see what
The app checks access at three layers: the middleware, a check on the page, and each API call. See Roles and access for every screen.
- Every signed-in user can open Security and Product Categories. Client Users see Product Categories read-only.
- NC Internal Users can also open Notifications, SKU Sync, Client Connections, and Users. Client Connections and Users are read-only for them.
- NC Super Admins can change everything here. They are the only ones who create connections and add or change users.
Notifications
NC staff only. Client Users never get alert emails, so this screen is hidden from them.
This screen sets your own email preferences. A master switch turns all emails on or off.
Below it, you choose which emails you want:
- Receiving discrepancy: when a closed purchase order received more or fewer units than were ordered. One email lists every line that did not match. See Notify: PO Line Item Discrepancy.
- Shipping cost alert: when a shipment runs over its threshold.
There is no draft PO email. Nothing creates draft POs automatically anymore, so that setting was removed and its email flow was retired on October 7, 2026.
New users start with every email off. The sub-settings stay greyed out until you turn the master switch on.
Security
This screen shows where your account is signed in and what it has done recently. Every user can open it, and it only ever shows your own account.
Active sessions
Each device that is signed in to your account appears as a row with:
- Device: a label like "Chrome on macOS".
- Location: the city and country, with the internet address, where the portal could work them out. Otherwise just the address, or "Unknown location".
- Last active: how long ago the session was last used.
The device you're using now carries a This device badge.
- Sign out next to a row ends that one session.
- Sign out other devices ends every session except the one you're using.
Sessions also end on their own after 7 days, or after 24 hours without use.
Recent activity
A list of your recent sign-ins and sign-outs, each with its device, location, and time. If you see a sign-in you don't recognize, sign out your other devices and tell your administrator.
Signing in
The portal signs you in with a code sent to your email. There are no passwords. See Sign in to the portal.
Client Connections
This screen manages your ShipHero connections. Its page heading reads ShipHero Connections. It lists your accounts with their connection status and active user count. NC Super Admins see every account. NC Internal Users see their own accounts, read-only.
Connection Name
The Connection Name column shows the connection's nickname, the same name the account pickers elsewhere in the app show. Renaming a connection changes what appears here.
A connection with no nickname yet falls back to a label built from its ShipHero token, like "ShipHero (tq6w)". A connection with no token at all reads "ShipHero (Not Connected)". Give each connection a nickname so you can tell them apart at a glance, because those fallback labels look almost identical.
Filtering on Connection Name matches the name you see in the column.
Connection status
Each account shows one of three states:
- Not Connected (red): a ShipHero token is missing.
- No Credentials (amber): tokens exist, but no saved login.
- Connected (green): tokens and login both exist.
What you can do
Only an NC Super Admin can change a connection. Open an account to manage it:
- Rename the connection.
- Manage credentials to save the ShipHero login and tokens.
- Regenerate tokens refreshes the ShipHero tokens.
- Rename stores in the Connected Stores table. Each row shows the store's ShipHero name and the display name the rest of the app uses for it.
- Connect a user adds someone to this account.
- Revoke or re-enable a user's access.
- Delete the connection removes the account and all its data.
Delete removes everything
Deleting a connection cascades. It removes the account's orders, shipments, SKUs, purchase orders, and user links. It cannot be undone.
Only NC Super Admins see the Create New Connection button. It opens a wizard that connects ShipHero, invites users, and starts the account. ShipHero is connected with an access token and a refresh token created in ShipHero, never a ShipHero login. See Connect a ShipHero account.
An NC Super Admin can't be revoked from an account. Super Admins are on every account.
Users
This screen lists the people on your accounts with their status, type, accounts, and join date. NC Super Admins see everyone and manage users. NC Internal Users see the list for their own accounts, read-only.
What you can do
Only an NC Super Admin can:
- Invite or connect users: pick one or more accounts from a checkbox list, pick a type, and add one or more emails.
- View a user to see their full profile and per-account access.
- Switch a user's type between Client User and NC Internal User on their page. The switch applies to every account they're on.
- Add or revoke accounts for a user on their page.
- Rename, disable, or re-enable a user.
- End a session from a user's page. It lists every device signed in to their account, and End session signs that device out. Unlike Security, there is no "This device" badge here, because which session is "current" depends on whose browser you're in.
How invites resolve
When you add emails, the app checks each one and picks the right action:
- A brand-new email gets an invitation email.
- A disabled user gets re-enabled and added.
- An existing user gets the chosen accounts. A revoked account is restored rather than added again.
- A user who already has every chosen account needs nothing.
The type applies to new logins. An existing user keeps their type, and the review says so when it differs from the one you picked; change it on their page. You review these actions before you confirm them. NC Super Admin is never offered as a type.
The invitation email tells the new user to sign in at the portal with a code sent to their email. They never set a password.
Product Categories
This screen manages the categories you assign to products. Categories belong to one account.
Pick an account, then add, rename, or delete its categories. Deleting a category marks its products as uncategorized. Client Users see the categories but can't change them.
SKU Sync
New SKUs from ShipHero do not enter the system on their own. They land in a review queue first. A person classifies each one before it becomes real.
NC staff only. The screen has two tabs: Queue and Sync history.
Step-by-step guides
This section describes the screen. For the flows themselves, see Resolve the SKU queue and Run a SKU sync.
How new SKUs arrive
The app pulls new SKUs from ShipHero two ways:
- A daily cron runs at 07:00 UTC.
- A Sync Now button runs one account on demand.
Each run records how many SKUs it found, queued, and skipped. A SKU that already exists gets skipped.
An account runs one sync at a time. A run that dies is closed as Failed, the other accounts keep syncing, and the internal Slack channel gets a message.
The queue
The queue lists each pending SKU with a suggested type: Base, Case, or Product. You filter by status, account, or search.
For each SKU you can:
- Review it and classify it.
- Reset a classified SKU to reclassify it. NC Super Admins only.
- Dismiss a SKU that should not exist.
Classify a SKU
The review dialog offers several choices:
- Create a new Base, Case, or Product SKU.
- Dismiss the SKU entirely.
When you create a Product SKU, every component must map to an existing Base SKU. The app tries to match them for you.
Sync history
The history tab lists past runs with their status and counts. Open a run to see each SKU it processed.
SKU sync talks to ShipHero directly
SKU sync reads from ShipHero's own API. Only account creation and user invites route through N8N.