---
title: Troubleshoot publishing, checkout, and apps
description: Separate publication, live-store, checkout, and provider problems so you can fix the right layer.
---

A successful build does not by itself prove publication, catalog data, checkout, or an outside provider. Verify each layer separately.

**Entry path:** Runner documentation → **Help and reference** → **Troubleshoot publishing, checkout, and apps**.

## Before you start

- Record the affected store, public URL, provider, and exact visible state.
- Stop before a real charge, order, provider disconnect, or other consequential action unless the test is authorized.
- Verify one layer at a time; a working Preview does not prove publication or checkout.

## Important controls and results

| Control | What happens after you select it |
| --- | --- |
| **Retry check** | Runs the failed publication or checkout readiness check again. It does not fix the named cause. |
| **Publish** / **Republish** | Starts publication after required checks pass; it does not prove catalog or checkout behavior. |
| **Connect Stripe** | Opens the payment connection path. No payment is accepted until the provider and live checkout are usable. |
| **Reconnect** in Apps | Restarts the provider's official authorization flow for the existing connection. |

## Identify the failing layer

| Layer | Proof to look for | If it is missing |
| --- | --- | --- |
| Preview | The intended page and interaction work in **Storefront**. | Fix the build or content before publishing. |
| Publication | Runner shows a successful published state and a live URL. | Open publication status and resolve the named requirement or error. |
| Live storefront | The live URL shows the intended version in a fresh visit. | Check whether newer changes require **Republish**. |
| Catalog | The expected product, price, availability, and shipping choice are visible. | Correct Store Operations data and storefront availability. |
| Checkout | A safe test can reach the expected checkout and payment/shipping choices. | Check payment, shipping, store mode, and provider status. Do not place a real order unless authorized. |
| Provider | The app shows connected and the provider confirms the expected account. | Reconnect through the official app flow and recheck permissions. |

## Publish recovery

1. Open [Prepare to publish](../storefront-and-publishing/prepare-to-publish) and complete every visible requirement.
2. Check whether another publication is already **Deploying**.
3. If publication fails, preserve the displayed error.
4. Retry once only after the named cause is resolved.
5. Open the live URL after success and verify the intended page.

## Checkout recovery

1. Confirm at least one sellable product is visible on the live store.
2. Confirm shipping applies to the test destination.
3. Confirm the payment app is connected to the intended mode and account.
4. Reach checkout through the live storefront rather than a direct guessed URL.
5. Stop before a real charge or order unless the test is explicitly authorized.

## App recovery

1. Open **Apps** and select the provider.
2. Read the displayed state: not connected, connected, needs attention, or unavailable.
3. Reconnect only through the provider's official authorization window.
4. Confirm the returned account and permissions.
5. Verify the actual downstream result; a green connection badge alone is not end-to-end proof.

## Related guides

- [Publish and republish](../storefront-and-publishing/publish-and-republish)
- [Live store and checkout](../storefront-and-publishing/live-store-and-checkout)
- [Connect, manage, and reconnect apps](../apps-and-integrations/connect-manage-reconnect)
- [Apps troubleshooting](../apps-and-integrations/troubleshooting)