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

# Wizard Marketplace

> Discover and clone wizard templates shared by other organizations — with featured listings, search filters, and a detail view for ratings and cloning.

The Wizard Marketplace page at `/fw/wizards/marketplace` displays wizard templates shared through the cross-organization marketplace. Users can browse, preview, and clone templates into their own organization.

## Overview

The Wizard Marketplace fetches listings from `useMarketplaceListings` and featured listings from `useFeaturedListings`. Featured templates are shown in a horizontally scrollable carousel when no search or module filter is active. All listings are shown in a responsive grid below. A `MarketplacePreviewDialog` allows users to inspect a template before cloning. Cloning uses `useMarketplaceMutation.cloneListing` and redirects to `/fw/wizards/:id/edit` on success.

## Who it's for

Access follows your organization's role and module configuration. All authenticated users with access to the FW module can browse the wizard marketplace. Cloning requires an active organization context.

## Browsing and cloning

**Browsing:**

1. Navigate to `/fw/wizards/marketplace`.
2. Review featured templates in the horizontal carousel (when no filters are active).
3. Browse all templates in the main grid.

**Filtering and sorting:**

1. Use the `MarketplaceFilters` component to filter by search term and/or module.
2. Adjust the sort order (e.g., popular).

**Previewing a template:**

1. Select a listing card to open the `MarketplacePreviewDialog`.
2. Review the template details.
3. Select **Clone** to proceed with cloning.

**Cloning a template:**

1. From a card or preview, select **Clone**.
2. The `CloneFromMarketplaceDialog` opens for confirmation.
3. Confirm the clone. On success the wizard template is added to the organization and the browser navigates to `/fw/wizards/:id/edit`.

* **Marketplace listing** — A wizard template made available by another organization for cloning.
* **Featured listing** — A curated marketplace listing shown prominently at the top of the page.
* **Clone** — Creates a copy of the marketplace listing's wizard template in the current organization.
* **Module filter** — Filters listings by the platform core they are associated with (e.g., `rh`, `hr`, `cl`).

## Viewing a listing

The Listing Details screen (`/fw/wizards/marketplace/:listingId`) displays the full detail of a wizard template marketplace listing.

This screen loads a marketplace listing via `useMarketplaceListing` identified by `listingId`. The breadcrumb label is set to `listing.title` via `useEntityBreadcrumb`. The listing detail shows metadata and step structure (via `WizardStep` type). User reviews and ratings are loaded via `useListingRatings`. Cloning is initiated by `CloneFromMarketplaceDialog`; on success the user is navigated to `/fw/wizards/:id/edit` for the cloned template. A rating submission form (stars + text review) is present inline, submitted via `useMarketplaceMutation`. Wizard steps are shown in a collapsible list.

Before you start: reach this screen from the Marketplace (`/fw/wizards/marketplace`) by clicking a listing. You must be logged in; the current organization is used for cloning.

1. Navigate to `/fw/wizards/marketplace/:listingId` or click a listing in the marketplace.
2. Read the description, steps, and metadata for the wizard template.
3. Scroll to the reviews section to see community ratings via `MarketplaceReviewsList`.
4. Click **Clone** to open `CloneFromMarketplaceDialog` and add this template to your organization.
5. Select a star rating and optionally enter a review, then submit.

* **Clone** — copies the marketplace template into the current organization as a new wizard template, then navigates to the wizard builder.
* **WizardStep** — the structured steps that define the wizard template flow.

## Related

<Columns cols={2}>
  <Card title="Forms & Workflow" icon="diagram-project" href="/fw/overview">
    Forms & Workflow core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fw\.tsx
  * src/platform/wizards/pages/MarketplacePage.tsx
  * src/platform/wizards/pages/MarketplaceListingDetailPage.tsx
  * src/platform/wizards/hooks/useMarketplace.ts
  * src/platform/wizards/hooks/useMarketplaceMutation.ts
</Accordion>