How do I set up B2B portal contacts and control which shipping addresses portal buyers can see or enter?
Last updated: November 10, 2026
Note: The B2B Portal is being retired, and buyers are moving to the new Storefront (Settings → Storefront). Contacts and company shipping addresses work the same way for both.
Part 1: Set up a portal contact
A portal buyer is a contact on a company record, and the contact signs in with their email address and a password you set.
New contact Go to Sales → CRM → Contacts and click Add New Client Contact. Or open the company and go to its Contacts tab, then + Add New Contact. Fill in First Name, Last Name, Email Address and Password (adding a password turns on portal login). Under Company #1, link the contact to their company. Use Add Another Company if they buy for more than one. Click Submit.
Existing contact
Go to Sales → CRM → Contacts and find the contact.
Click the three dots (⋮) on the contact's row and choose Reset Password.
Enter a new password and confirm. The change takes effect immediately.
Luminous can also email the contact an invitation when portal access is provisioned. See the related article below for how to tell whether that email will be sent.
Part 2: Which shipping addresses buyers see
The portal reads shipping addresses from the buyer's company (business account), not from the individual contact. A buyer can pick from the saved shipping addresses on their company at checkout. To change which saved addresses are available, add or remove them on the company's shipping addresses in Luminous. You can also bulk-load them with the client shipping address import.
To add an address, open the company, go to Shipping Addresses, and click Actions → Create Shipping Address.
The first shipping address saved for a company becomes its default.
Part 3: Entering a new address at checkout
For a standard delivery, the buyer must either choose a saved address or type in a new one. If they do neither, checkout shows "Choose a delivery address or enter a new one."
A typed-in delivery address must include address, city, state, postal code and country. Company name, first and last name, email, phone and address line 2 are optional.
The buyer can also choose to save the typed address.
If they save it, it is added to the company's saved shipping addresses and becomes available for later orders.
If they don't save it, the order still uses the typed address, but it is not added to the address list.
The same rules apply to a billing address typed at checkout. A saved billing address is added to the account in the same way.
Good to know
Warehouse pickup is not available in the portal. Buyers must choose a delivery address.
I found no portal setting under Settings → B2B Portal that limits buyers to saved addresses only or hides particular addresses from them. The B2B Portal settings cover branding, product display, line items, cart and checkout, and uploads.
Because saved addresses belong to the company, every contact on that company sees the same saved list. A saved address is not private to one contact.
If you need to keep a typed address out of the list, remove it from the company's shipping addresses afterwards. A buyer who chose to save an address can add it back.