FastStore WebOps now provides a self-service interface to change the GitHub organization and repository associated with your project. This feature streamlines the process of moving FastStore projects between organizations or repositories, eliminating the need to open support tickets for repository migrations.
What has changed?
The Integrations tab in the FastStore WebOps dashboard now includes a Git Provider section to configure the GitHub organization and repository associated with your FastStore project.
Before, moving a FastStore project to a different GitHub organization or repository required opening a ticket with VTEX Support and providing detailed information, including repository IDs, installation IDs, and account details. The process involved multiple manual steps and coordination with the Support team.
Now, you can change your project's connected repository directly from the WebOps dashboard. The Git Provider card allows you to:
- Change the GitHub organization: Switch your project to a different GitHub organization by clicking
Change accountand selecting the target organization. - Change the repository: Move your project to a different repository within the same organization by selecting the target repository from the dropdown.
Why did we make this change?
This change simplifies the repository migration process and gives developers more control over their FastStore project configuration.
What needs to be done?
The feature is available to all FastStore projects using WebOps that meet the required permissions (Owner role in VTEX Admin and Admin role in GitHub repositories).
For FastStore projects hosted in the
vtex-sitesorganization, open a ticket with VTEX Support to move your project to your account's GitHub organization.
To change your Git Provider configuration:
- In your VTEX Admin, go to Storefront > FastStore WebOps and navigate to the Integrations tab.
- In the Git Provider card:
- To change organizations: Click
Change accountunder Account/Organization, select the target organization on GitHub, grant repository access, and select the target repository in WebOps. - To change repositories in the same organization: Select the target repository from the Repository dropdown.
- To change organizations: Click
- Click
Saveto apply your changes.
The repository change feature isn't available for private GitHub instances. The WebOps dashboard won't display the option if your project is connected to a private GitHub instance.
Learn more in the guide Moving your FastStore project to a new GitHub repository.