Documentation
Feedback
Guides

Release Notes
Release Notes
Deprecated
VTEX IO: VBase deprecation and Master Data migration
Today

VBase, the database solution available to VTEX IO apps, will be gradually deprecated, consolidating Master Data as the single database solution offered by the VTEX platform. Apps that currently use VBase must migrate to Master Data before the shutdown dates below.

Integration apps are exceptions and will be handled separately. Payments (PPF), Antifraud, and Search integrations currently use VBase and are excluded from this deprecation.

What has changed?

VBase will no longer be available for app development and running apps. The VBase phase-out uses the same terminology of builder version statuses and will happen in the following phases:

DatePhase
February 1st, 2027Deprecated: Publishing and linking new apps and new major versions of existing apps that use VBase are blocked.
July 1st, 2027Decommissioned: Publishing and linking new versions (minor and patch) of existing apps that use VBase are blocked.
October 1st, 2027Non-functional: Apps using VBase no longer work on the platform.

Why did we make this change?

Consolidating our database infrastructure on Master Data provides stores a more reliable, scalable, and resilient foundation. This unified solution minimizes operational complexity and ensures a consistent, high-performance development experience across the VTEX platform.

What needs to be done?

If you develop or maintain apps that use VBase, migrate them to Master Data before the dates above to avoid service disruptions. For implementation details, see the Master Data CRUD guide.

New apps

Use Master Data as the storage solution from the start. Starting February 1st, 2027, new apps using VBase will be blocked.

Existing apps

Replace VBase usage with Master Data and publish the updated version before the established timelines: February 1st, 2027, for new major releases, and July 1st, 2027, for minor and patch updates. Following these dates, any attempts to publish versions of apps still using VBase will be blocked.

For exceptional cases requiring extended VBase support, open a ticket with VTEX Support to discuss your specific needs.

For more information about modeling and storing data with Master Data, see Master Data introduction.

Integrations exception

Integration apps will be addressed separately. The following integration guides and template repositories currently reference VBase. Apps from these integrations will continue to work as intended.

IntegrationTemplate repository
Payment providerpayment-provider-example
Anti-fraud providerantifraud-provider-example
Search resolversearch-resolver
Was this helpful?
Yes
No
On this page