> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/6/release-notes/deprecations/pre-builts/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Pre-Builts deprecation

> Notice that Pre-Built Wizard, Pre-Built Promotion, and App-Artifacts are no longer maintained as of Platform 6, with guidance on migrating to projects.

Pre-Built Wizard, Pre-Built Promotion, and App-Artifacts are no longer maintained by Itential as of Platform 6.

**Pre-Built Wizard** was an Itential pre-built that allowed users to discover and bundle the workflows, JSON forms, transformations, and other assets associated with an automation entry point. **Pre-Built Promotion** extended this workflow by committing the resulting pre-built to a Git repository, with variants available for GitLab, GitHub, Bitbucket Cloud, Bitbucket Server, and Azure DevOps. Both depended on **App-Artifacts** as a dependency.

Pre-builts that were already installed on your instance before upgrading to Platform 6 remain installed and continue to function. This deprecation affects only how you can install or import new pre-builts.

## What should I do?

Itential recommends migrating your asset bundling and promotion workflows to [projects](/studio/projects/overview). See [Use pre-builts in Platform 6](/itential-platform/admin-essentials/pre-builts/use-pre-builts) for full migration guidance.

If you need to continue using pre-builts, review the options below. The option you choose depends on your deployment type and migration timeline.

### Migrate to projects

Itential recommends projects as the replacement for Pre-Built Wizard and Pre-Built Promotion. Projects natively group the workflows, JSON forms, transformations, and other assets associated with an automation into a single exportable and importable unit — without requiring additional pre-built applications or App-Artifacts.

For Git-based promotion pipelines previously handled by Pre-Built Promotion, projects work with community-maintained tooling such as ipctl and standard Git pipeline files. See [Use pre-builts in Platform 6](/itential-platform/admin-essentials/pre-builts/use-pre-builts) for the recommended workflow.

### Continue using pre-builts (on-premises only)

If you're an on-premises customer and aren't yet ready to migrate to projects, you can continue installing pre-builts on Platform 6 as long as the necessary pre-built dependencies noted in each pre-built's README are deployed in your environment. Pre-builts installed before upgrading to Platform 6 remain installed and continue to function.

#### Option 1: Connect Pre-Builts Catalog to Git

#### Verify dependencies

Verify that the pre-built's dependencies are installed and running in your deployment.

#### Set the active profile

Set the active profile in your `iap.properties` file or as an environment variable to configure the repository connection. For instructions, see [Use pre-builts in Platform 6](/itential-platform/admin-essentials/pre-builts/use-pre-builts).

#### Configure the repository

Configure the repository setting to point to the required repository, such as the Itential [pre-builts automation](https://gitlab.com/itentialopensource/pre-built-automations) repository or [your own](/admin-essentials/pre-builts/build-automation-repository).

#### Install from the catalog

Browse and install pre-builts from the Pre-Builts Catalog in Admin Essentials.

#### Option 2: Import a pre-built artifact file

#### Download the artifact file

Download the `artifact.json` file associated with the pre-built. The artifact file is a mandatory file contained in the pre-built's Git repository.

#### Import via Admin Essentials

Import the file using Admin Essentials.

For more details, see [Install pre-builts manually](/itential-platform/admin-essentials/pre-builts/manually-install-pre-built).

### Cloud customers on Platform 6

Cloud customers upgraded from 2023.2 to Platform 6 retain all pre-builts that were installed before the upgrade. You can view the Pre-Builts Catalog in Platform 6, but you can't install pre-builts directly from it.

To import a pre-built:

#### Download the artifact file

Download the `artifact.json` file associated with the pre-built.

#### Import via Admin Essentials

Import the file using Admin Essentials. For more details, see [Install pre-builts manually](/itential-platform/admin-essentials/pre-builts/manually-install-pre-built).

Contact your Customer Success Manager or the [Product Support Team](https://itential.atlassian.net/servicedesk/customer/portals) for assistance.

> Notice that Pre-Built Wizard, Pre-Built Promotion, and App-Artifacts are no longer maintained as of Platform 6, with guidance on migrating to projects.