Skip to content
Log in

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 to www. 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?

Was this article helpful?