Requirements

1. Install the VTEX IO CLI on your machine

For more information, please refer to this guide (opens in a new tab).

2. Ensure the Headless CMS and its ependencies are installed in your account

The Headless CMS is the solution for managing content in FastStore projects. During the Onboarding, the initial steps to integrate your project with the Headless CMS begins are are carried out. To prevent content duplication, which may lead to build failures during Onboarding, it is crucial to confirm the installation of the following in your account: vtex.admin-cms@1.x, vtex.admin-cms-graphql and vtex.admin-cms-graphql-rc. To check wether you have the them installed, refer to Installing the Headless CMS app.

Checking installed apps in your account

Open the terminal and log in to your account using the following command:

vtex login {accountName}

Remember to replace {accountName} with your account's name, for example, vtex login mystore

Run vtex ls to list all the installed apps in your account.
Check if the vtex.admin-cms@1.x, vtex.admin-cms-graphql and vtex.admin-cms-graphql-rc are in the list. If yes, proceed to check other requirements. If not, install them by following the instructions in Installing the Headless CMS app.

Installing the Headless CMS app and its dependencies

After logging into your account, install vtex.admin-cms@1.x by running the following command:

vtex install `vtex.admin-cms@1.x`

A successful message will confirm the installation:

installation-message

Install the Headless CMS dependencies by running the following command:

vtex install vtex.admin-cms-graphql vtex.admin-cms-graphql-rc

Once the app and its dependencies are installed, proceed to check the next requirements.

3. Enable the VTEX Intelligent Search app in your account

The VTEX Intelligent Search (opens in a new tab) app enhances the user experience by providing accurate and personalized search results throughout the shopping journey. Before developing a storefront in FastStore, you need to enable the app on your account. For more information on the Intelligent Search and its integration, please refer to the VTEX Intelligent Search (opens in a new tab) and Integration Settings (opens in a new tab) guides.

To enable the app, begin by checking the version of your Edition Store (opens in a new tab) account.

Based on the edition version, follow the instructions below.

ℹ️

To confirm which Edition App version is installed in your account, open the terminal and use the VTEX IO CLI. Log in to your account by running vtex login {accountName} and run vtex edition get to see the Edition App version installed on the current account.

Accounts in the vtex.edition-store@5.x

If your account is using the vtex.edition-store@5.x major, the VTEX Intelligent Search app is already included, and you need to integrate the app via VTEX Admin.

To integrate the VTEX Intelligent Search, go to the VTEX Admin and access Store Settings > Intelligent Search > Integrations and click on START INTEGRATION.

Accounts using an edition version below 5.x

In the VTEX IO CLI, log in to your VTEX account by running vtex login {accountName}. Remember to replace the value between brackets with your account name.
If the VTEX Intelligent Search app is not installed in your account, run the following for Intelligent Search:
```
vtex install vtex.search-resolver@1.x vtex.admin-search@1.x
```

After successfully installing the app, integrate it by accessing the VTEX Admin, go to Store Settings > Intelligent Search > Integrations and click on START INTEGRATION.

Accounts that want to migrate to the 5.x

If you are using a different major version and want to migrate, please open a ticket with VTEX Support (opens in a new tab) and request the installation of the Edition app vtex.edition-store@5.x.

4. Request the installation of the FastStore Onboarding app.

Open a ticket with the VTEX support team (opens in a new tab) and request the installation of the FastStore Onboarding app.

Overview 1. FastStore Onboarding