Site Editor is the Content Management System (CMS) available for stores using Store Framework. In some situations, you may encounter difficulties opening the Site Editor or saving content.
Below are some instructions to help you solve these issues in Site Editor.
Issue | Description | How to fix it |
---|---|---|
Site Editor won't open | The Site Editor page displays a blank screen or the message Something went wrong . | - Check the search integration. - Check the tenant configuration (new accounts only). |
I can't manage my store's content in Site Editor (#I-can't-manage-my-store's-content-in-site-editor) | I can't edit, save or delete content in Site Editor. | - Check if the user role has the necessary permissions. - Check the domain's main location. |
I lost the content stored in Site Editor | The content saved in Site Editor has been lost. | Open a ticket with VTEX Support. |
I'm still having problems with Site Editor | Issues with the Site Editor persist even after trying to resolve them. | Open a ticket with VTEX Support. |
To understand and correct each error, see the solutions below:
Site Editor doesn't open
The following error may occur: when accessing VTEX Admin, going to Storefront and clicking Site Editor, the Site Editor page shows a blank screen or the message Something went wrong
.

To solve this error, see the following instructions:
Checking the search integration
One possible reason for this issue might be related to the Intelligent Search search not integrated with your store’s catalog. Follow the steps below to integrate it into your store:
-
Access the VTEX Admin and go to Store Settings > Intelligent Search > Integrations.
-
On the Integrations page, all the statuses must be checked, as in the following image.
-
If the statuses are all checked, and you still can’t open Site Editor, see the Checking the tenant configuration section. Otherwise, proceed to the next step.
-
If the Integrations page does not look like the image above, here are the reasons and how to fix them:
- The status
Enable search
is not checked: You didn’t start the integration. ClickStart Integration
. - One of the statuses failed and is not checked: If you already tried to start the integration but it still failed, open a ticket with VTEX Support to report the error.
Checking the tenant configuration (new accounts only)
If you already have the search integrated and still see a black screen when you click Site Editor in the VTEX Admin, the store might not have the tenant set, or there is an error in this setting.
VTEX uses a SaaS multi-tenancy architecture approach, where each account is a tenant that needs to be connected (binding) to the VTEX architecture for data and information synchronization.
To set the tenant in your store, open a ticket with VTEX Support team requesting it. Once you receive feedback from support confirming the tenant has been set, go to the VTEX Admin, access Storefront > Site Editor, and check if it opens correctly. If the blank screen persists, explain the new issue in the ticket you opened with VTEX Support so the team can further investigate.
I can't manage my store content in Site Editor
One error that can happen in Site Editor is when you can't edit, save, or delete content. When you try to do one of these actions, you see the following message:
Something went wrong. Please try again.
To solve this error, see the following instructions:
- Check if the user role has the necessary permissions.
- Check if the trade policy is configured in the catalog
- Check the domain's main locale
Checking if the user role has the necessary permissions
One possible reason for this issue might be related to the lack of the CMS GraphQL API
License Manager resource in a user role for content management.
Ensure that users are associated with the CMS GraphQL API
resource within their user roles by either creating a new role or editing an existing one.
If you still can't manage the content even after adding the CMS GraphQL API
resource to the user role, see the next section: Check the domain's main locale.
Checking the domain's main locale
Another possible reason for this error is related to the locale set for the account.
-
Install the
vtex.admin-graphql-ide@3.x
app using your terminal. -
In the VTEX Admin, go to Store Settings > Storefront > GraphQL IDE.
-
In the dropdown menu, select the
vtex.tenant-graphql@0.1.2
app. -
In the text box, enter the following query:
query { tenantInfo { bindings { id, canonicalBaseAddress, defaultLocale } } }
-
Check the main location set for your store. This information is available in the
defaultLocale
field. See the example below. -
Now, go to Store Settings > Channels > Trade Policies.
-
On the Trade Policies page, select the trade policy associated with your account and check the Locale field.
The locale is considered incorrect in the following cases:
- The locale is different from the one the account should use. For example, the locale is set as
pt-BR
, but the account should bept-PT
. - The locale is in lowercase. Since this configuration is case-sensitive, you must set the locale as
pt-BR
instead ofpt-br
. - The locality configured in the trade policy is different from the
defaultLocale
identified.
- In both cases, open a ticket with VTEX Support to request a change in the locale set for the trade policy. Remember to include evidence of the error, such as screenshots, message logs, and details of your prior investigation.
I lost content stored in Site Editor
Open a ticket with the VTEX Support team to investigate the issue further.
To avoid losing content stored in Site Editor when changing the pair dependencies of the Store Theme app, follow the steps in the guide Migrating CMS settings after a major theme update.
In cases where you lose content in Site Editor, the content can only be restored if the loss is related to the known issue of Intermittent Site Editor content loss. In this situation, open a ticket with the VTEX Support with urgent
priority.
I'm still experiencing issues with Site Editor
If you have already gone through the solutions described above and are still experiencing issues with Site Editor, please open a ticket with the VTEX Support team and add evidence of the issues you are facing:
- Error messages.
- Console log messages (If there is any).
- Changes made before the issue occurred.
- Screenshots of the issue.
- Date and time when the issue started.
- Tests you have already performed and the steps to reproduce them.