Tips for getting started with StoreConnect
On this page
Despite our efforts, not all installations go smoothly. Here are a few tips and known ways to troubleshoot installation and startup.
If your problem is not listed, or these fixes do not solve it, contact our support team.
Installation
The package fails to install
Check that your org meets the compatibility requirements. If your org was created before 2023, check that Lightning Web Security is enabled. StoreConnect does not install without it.
The setup wizard does not appear, or shows a permission message
The setup wizard only appears for a user with the System Administrator profile. A custom profile with the same StoreConnect permission sets is not enough. Sign in as a System Administrator user and open the StoreConnect Console again.
Signing in as the sync user signs you out of Salesforce
The wizard asks you to sign in as the sync user while you are already signed in as yourself. To keep your own session, open a private or incognito window, or a different browser, copy the sign-in link from the wizard into it, and sign in as the sync user there.
If the sign-in tab does not open, your browser may have blocked it. Select Reopen sign-in.
The connection or core services are still building
Building core services takes about 5 to 20 minutes after you accept the trial terms. Making the sync connection usually takes 10 to 20 seconds, and up to 5 minutes. If either takes longer, contact our support team.
“The user license doesn’t allow the permission” or “Missing Salesforce Permissions”
These come from the sync user’s license or permissions. Each error has a fix in the troubleshooting section of set up a StoreConnect sync user.
Setting up
Existing customers are missing from your website
This is expected. Accounts and Contacts already in Salesforce are not part of the import when you install. A customer record reaches your website only after it is saved again, and a Contact also needs a StoreConnect ID. See bringing pre-existing records across.
A product does not appear on the storefront
A product shows only when it is active, belongs to a category in the taxonomy your store uses, and has an available date in the past. If the product shows but cannot be found in search or bought, check it has an active price book entry in the store’s currency. See the minimum requirements for product visibility.
The Take Payment button on an Order fails
Salesforce blocks the payment provider until your store’s address is listed as a trusted site. List your site as a trusted URL. Your .storeconnect.app address and your own domain are separate URLs to Salesforce, so add your own domain as well when you go live.
Order emails do not arrive, or come from the wrong address
The sender address must be set up and verified as an Organization-Wide Address in Salesforce. See setting up StoreConnect emails.
An AI agent cannot connect to your store
Agents connect through your store’s MCP endpoint, which needs StoreConnect v22 or later. See troubleshoot an agent connection.
Pre-launch and launch
Your domain does not reach the store
- Apex domain — if you use a domain without
www, your DNS provider must support an ALIAS or ANAME record. If it does not, forward the apex domain towww. See connect a domain to StoreConnect. - Propagation — DNS changes take around 15 minutes to spread, and some locations and browsers see them sooner than others. Check from several networks and browsers, in a private window where possible.
- Slow switchover — set your DNS TTL to 300 seconds or lower before the dry run, and to 60 seconds on go-live day.
The browser shows a certificate warning
SSL is not provisioned for the domain yet. On the Web Domain record, check Active is selected and the Status field shows Success. See set your store domain and go live.
Returning customers are not matched at checkout
Checkout only matches customers whose records have synced to your website, and matches on exact email. Sync existing customers before launch, and merge duplicate Contact records that share an email address. See contact matching and lead conversion at checkout.
The store still takes test payments after launch
Test mode is still on. Clear Enable Test Mode on the Store record, as part of set your store domain and go live.
Your trial store is disabled or offline
Every new install includes a 90-day trial. After 90 days the trial store is disabled, and it goes offline 15 days later. To keep the store live, sign up for a plan from the StoreConnect Console, or email sales@storeconnect.com.
Tips for a smoother start
- Start the slow things first — payment provider approval and DNS changes are outside StoreConnect’s control. Start both while you plan your move.
- Experiment where mistakes are cheap — try changes in a test store or a StoreConnect sandbox before your live store.
- Do a full dry run — run the dry run at least two days before go-live, with production credentials, so problems surface while there is time to fix them. See launch your StoreConnect store.
- Hear about incidents early — subscribe to status.storeconnect.com for incident and maintenance updates.
Was this article helpful?
Thanks for your feedback! It helps us improve our docs.