> ## 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 Guide

> > User guide for browsing, cloning, publishing, and managing wizard templates in the marketplace.

> User guide for browsing, cloning, publishing, and managing wizard templates in the marketplace.

## Overview

The Wizard Marketplace allows organizations to share and discover wizard templates across the Encore Health OS platform. You can browse templates created by other organizations, clone them for your own use, and publish your own templates to help others.

## Browsing the Marketplace

### Accessing the Marketplace

Navigate to **Forms & Workflows → Wizards → Marketplace** or go directly to `/fw/wizards/marketplace`.

### Search and Filter

The marketplace provides several ways to find templates:

* **Search**: Type keywords to search by title or description
* **Module Filter**: Filter by module (HR, RH, FA, etc.)
* **Rating Filter**: Show only templates with a minimum rating
* **Featured Only**: Show only featured (staff-picked) templates
* **Verified Only**: Show only verified templates

### Understanding Listing Cards

Each listing card shows:

| Element        | Description                           |
| -------------- | ------------------------------------- |
| Title          | Template name                         |
| Module Badge   | Which module(s) the template supports |
| Rating Stars   | Average rating from users             |
| Clone Count    | How many times it's been cloned       |
| Verified Badge | ✓ Staff-verified quality              |
| Featured Badge | ⭐ Staff-picked recommendation         |

## Viewing Listing Details

Click any listing card to view full details:

### Information Shown

* **Description**: Full template description
* **Preview**: Visual preview of wizard steps
* **Step Count**: Number of steps in the wizard
* **Field Count**: Total number of form fields
* **Tags**: Categorization tags
* **Reviews**: User ratings and comments
* **Clone History**: When you cloned it (if applicable)

### Step Preview

The step preview shows:

* Step titles and descriptions
* Field types in each step
* Validation rules applied
* Visibility conditions

## Cloning Templates

### How to Clone

1. Open a marketplace listing
2. Review the template details and preview
3. Click the **Clone to My Organization** button
4. The template will be copied to your organization

### What Gets Cloned

* All steps and their configurations
* All form fields with settings
* Validation rules
* Visibility conditions
* Wizard configuration (progress style, etc.)

### What Doesn't Get Cloned

* Organization-specific data
* Default field values (cleared for safety)
* Analytics data
* Ratings from the original

### After Cloning

* The cloned template appears in your wizard list
* You can customize it as needed
* Changes don't affect the original
* Attribution shows where it came from

## Publishing Your Templates

### Prerequisites

* You must have `pf.wizards.admin` permission
* The template must be active
* The template should have at least one step

### Publishing Process

1. Open your template in the Wizard Builder
2. Click the **Share to Marketplace** button
3. Fill out the publishing form:
   * **Title**: Public display name
   * **Description**: What the template does
   * **Tags**: Searchable keywords
   * **Visibility**: Who can see it
4. Click **Publish**

### Visibility Options

| Visibility             | Description                              |
| ---------------------- | ---------------------------------------- |
| Public                 | Anyone on the platform can see and clone |
| Private                | Only your organization can see it        |
| Specific Organizations | Only selected organizations can access   |

### Choosing Tags

Good tags help users find your template:

* Use module names (hr, rh, fa)
* Include use cases (onboarding, intake, assessment)
* Add industry terms (nonprofit, healthcare)

## Managing Your Listings

### Editing a Listing

1. Go to your template in the wizard list
2. Click the marketplace icon next to it
3. Update title, description, or visibility
4. Save changes

### Updating the Template Snapshot

When you update your template and want the marketplace listing to reflect changes:

1. Open the template in the builder
2. Make your changes
3. Click **Update Marketplace Listing**
4. The new snapshot replaces the old one

### Unpublishing

To remove your template from the marketplace:

1. Open the listing settings
2. Change visibility to **Private**
3. The listing will no longer appear in search

## Ratings and Reviews

### Rating a Template

After cloning and using a template:

1. Go to the marketplace listing
2. Click **Rate This Template**
3. Select 1-5 stars
4. Optionally add a review comment
5. Submit

### Rating Guidelines

* **5 Stars**: Excellent, worked perfectly, saved significant time
* **4 Stars**: Good, minor customizations needed
* **3 Stars**: Acceptable, some issues or missing features
* **2 Stars**: Below expectations, significant problems
* **1 Star**: Poor, unusable without major changes

### Review Etiquette

* Be constructive and specific
* Mention what worked and what didn't
* Suggest improvements rather than just criticizing
* Update your review if issues are fixed

## Best Practices

### For Template Publishers

1. **Write Clear Descriptions**: Explain what the template does and who it's for
2. **Use Meaningful Step Titles**: Make the workflow obvious
3. **Add Help Text**: Include field-level guidance
4. **Test Thoroughly**: Ensure all validation rules work
5. **Choose Appropriate Tags**: Help users find your template

### For Template Users

1. **Read the Description**: Understand what you're cloning
2. **Check the Preview**: Verify it matches your needs
3. **Look at Ratings**: Consider user feedback
4. **Customize After Cloning**: Don't use blindly
5. **Leave a Rating**: Help others make decisions

## Troubleshooting

### Common Issues

| Issue                 | Solution                                    |
| --------------------- | ------------------------------------------- |
| Can't find a template | Try different search terms or clear filters |
| Clone button disabled | Check your permissions or login status      |
| Can't publish         | Verify you have admin permissions           |
| Listing not appearing | Check visibility settings                   |

### Getting Help

If you encounter issues:

1. Check your organization permissions
2. Verify the template exists and is active
3. Contact your administrator

## See Also

* [Wizard Builder Documentation](../../src/platform/wizards/README.md)
* [Advanced Validation Guide](./wizard-advanced-validation-guide.md)