> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fusioncore.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Store Overview

> The portal Store lets shoppers browse your products, add them to a cart, and pay — as a logged-in member or as a guest — with every page driven by a single Store Settings record.

The Store turns your fusionCore products into a self-service storefront on a portal site. A shopper browses products, opens a product for detail, builds a cart, and pays. Members and guests both shop; only members need an account.

## The Shopper's Path

**1. Store page**

The shopper searches, filters by category, sorts, and pages through product tiles. **Add to Cart** on a tile adds the product directly when nothing else is needed from the shopper.

**2. Product page**

Products that need a choice first — a subscription plan, for example — open their detail page, where the shopper makes that choice and sets a quantity.

**3. Cart**

The **Cart Indicator** shows a running count. Depending on your configuration it opens the cart **drawer** or goes to the **Cart page**. The Cart page is where a guest chooses whether to check out as a guest or sign in.

**4. Checkout**

**Checkout** hands the shopper to the existing portal [Checkout](https://docs.fusioncore.us/end-user-guides/portal/checkout-lwc/index.md) page to pay, and then to [Payment Confirmation](https://docs.fusioncore.us/end-user-guides/portal/checkout-lwc/payment-confirmation.md).

## The Components

Four components are exposed to Experience Builder. All of them read their configuration from one `FS_PORTAL_Store_Settings__mdt` record, chosen per component with a **Store Settings** property.

| Component | What it is |
| - | - |
| **FS Portal - Store** (`fs_portal_store`) | The storefront grid: title, search, category filter, sort, currency picker, product tiles, pagination |
| **FS Portal - Store Product Detail** (`fsPortalStoreProductDetail`) | One product's detail page, including any choices the product requires |
| **FS Portal - Cart** (`fsPortalStoreCart`) | The cart, in both forms — the slide-in drawer and the full Cart page |
| **FS Portal - Store Cart Indicator** (`fsPortalStoreCartIndicator`) | The cart icon and item count, usually placed in the site header |

> [!NOTE]
>
> These are part of the unmanaged **Portal Components** package (`fs_portal_*` / `fsPortal*` components, `FS_PORTAL_*` Apex, no namespace prefix). Because the package is unmanaged you can customize the components — but **clone** one before editing its code, or a package upgrade overwrites your edits. Component properties and Store Settings survive upgrades.

## Where the Cart Lives

This differs between members and guests, and it explains much of the Store's behavior:

| | Logged-in member | Guest |
| - | - | - |
| Cart storage | A real **Order** in `Open` status — one per contact, reused | The browser's local storage — no Salesforce record |
| When the Order is created | As soon as the first item is added | Only when the guest continues from the Cart page |
| Survives a new device or browser | Yes | No |
| Pricing | Member pricing, from the price books they qualify for | List pricing |

## Working with the Store

> [card] [Setting Up Store Settings](https://docs.fusioncore.us/end-user-guides/portal/store/setting-up-store-settings.md)
>
> Create the Store Settings record, point it at your pages, and configure business units, currencies, and guest checkout.

> [card] [Preparing Products for the Store](https://docs.fusioncore.us/end-user-guides/portal/store/preparing-products.md)
>
> Make a product appear in the Store, and control its image badge, short description, quantity limit, and categories.

> [card] [The Store and Product Pages](https://docs.fusioncore.us/end-user-guides/portal/store/store-and-product-pages.md)
>
> Place both pages, and what a shopper does on them — search, filter, sort, and add to cart.

> [card] [The Cart](https://docs.fusioncore.us/end-user-guides/portal/store/cart.md)
>
> The Cart Indicator, the cart drawer, and the Cart page — including how quantity limits and persistence behave.

> [card] [Guest Checkout](https://docs.fusioncore.us/end-user-guides/portal/store/guest-checkout.md)
>
> Let shoppers buy without an account: placeholder records, contact matching, account logic, and reCAPTCHA.

> [card] [Store Troubleshooting](https://docs.fusioncore.us/end-user-guides/portal/store/troubleshooting.md)
>
> Symptom-to-fix reference for missing products, cart surprises, and guest checkout failures.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.