{"title":"Tips for getting started with StoreConnect","slug":"troubleshoot-getting-started","url":"https://support.storeconnect.com/articles/troubleshoot-getting-started","url_markdown":"https://support.storeconnect.com/articles/troubleshoot-getting-started.md","subtitle":null,"summary":"Fix common problems when installing, setting up, and launching StoreConnect: install failures, setup wizard and sync user errors, missing customers or products, payment and email issues, domain switchover problems, and an expired trial. Includes tips for avoiding them.","type":"Help_Documentation","video_url":"","keywords":"troubleshoot, troubleshooting, problems, install failed, setup wizard, sync user, authorize, permission error, missing customers, product not showing, take payment, dns, domain, propagation, ssl, certificate, trial expired, store offline, tips","last_modified":"2026-11-16T04:36:32+0000","body_markdown":"Despite our efforts, not all installations go smoothly. Here are a few tips and known ways to troubleshoot installation and startup.\n\nIf your problem is not listed, or these fixes do not solve it, [contact our support team](storeconnect-support).\n\n## Installation\n\n### The package fails to install\n\nCheck that your org meets the [compatibility requirements](storeconnect-compatibility-guide). If your org was created before 2023, [check that Lightning Web Security is enabled](enable-lightning-web-security). StoreConnect does not install without it.\n\n### The setup wizard does not appear, or shows a permission message\n\nThe 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.\n\n### Signing in as the sync user signs you out of Salesforce\n\nThe 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.\n\nIf the sign-in tab does not open, your browser may have blocked it. Select **Reopen sign-in**.\n\n### The connection or core services are still building\n\nBuilding 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](storeconnect-support).\n\n### \"The user license doesn't allow the permission\" or \"Missing Salesforce Permissions\"\n\nThese 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](how-to-create-a-storeconnect-sync-user#troubleshooting).\n\n## Setting up\n\n### Existing customers are missing from your website\n\nThis 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](initial-sync#bringing-pre-existing-records-across).\n\n### A product does not appear on the storefront\n\nA 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](product-listing-minimum-requirements).\n\n### The Take Payment button on an Order fails\n\nSalesforce blocks the payment provider until your store's address is listed as a trusted site. [List your site as a trusted URL](how-to-list-your-site-as-a-trusted-url-in-salesforce). Your `.storeconnect.app` address and your own domain are separate URLs to Salesforce, so add your own domain as well when you go live.\n\n### Order emails do not arrive, or come from the wrong address\n\nThe sender address must be set up and verified as an **Organization-Wide Address** in Salesforce. See [setting up StoreConnect emails](setting-up-storeconnect-emails).\n\n### An AI agent cannot connect to your store\n\nAgents connect through your store's MCP endpoint, which needs StoreConnect v22 or later. See [troubleshoot an agent connection](troubleshoot-an-agent-connection).\n\n## Pre-launch and launch\n\n### Your domain does not reach the store\n\n- **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](how-to-register-a-domain-to-use-with-storeconnect).\n- **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.\n- **Slow switchover** — set your DNS TTL to 300 seconds or lower before the dry run, and to 60 seconds on go-live day.\n\n### The browser shows a certificate warning\n\nSSL 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](setting-up-a-custom-domain-name).\n\n### Returning customers are not matched at checkout\n\nCheckout 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](lead-contact-and-account-deduplication).\n\n### The store still takes test payments after launch\n\nTest mode is still on. Clear **Enable Test Mode** on the **Store** record, as part of [set your store domain and go live](setting-up-a-custom-domain-name).\n\n### Your trial store is disabled or offline\n\nEvery 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](mailto:sales@storeconnect.com).\n\n## Tips for a smoother start\n\n- **Start the slow things first** — payment provider approval and DNS changes are outside StoreConnect's control. Start both while you [plan your move](plan-your-move-to-storeconnect).\n- **Experiment where mistakes are cheap** — try changes in a [test store](test-store) or a [StoreConnect sandbox](get-a-storeconnect-sandbox) before your live store.\n- **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](preparing-to-launch-your-store).\n- **Hear about incidents early** — subscribe to [status.storeconnect.com](https://status.storeconnect.com) for incident and maintenance updates."}