Documentation
Feedback
Guides
Troubleshooting

Troubleshooting
Troubleshooting
Development

I can't publish my theme due to app dependency

Learn how to fix app dependency validation errors when publishing a theme or app in VTEX IO.

Keywords: Dependency | App | Theme | Publish | VTEX IO CLI

When attempting to install a new store theme or publish an app in VTEX IO, you may encounter a dependency validation error.

This issue occurs when an app dependency is deprecated, or is a release candidate or pre-release version. In these cases, VTEX IO blocks installation or publishing and displays an error similar to the following:

Error validating app dependencies: Error with dependency {appvendor}.{appname}@{appversion}: App cannot be deprecated, a release candidate version, or a pre-release version: {appvendor}.{appname}@{appversion}

Solution

To solve this issue, follow the steps below:

  1. In the error message, identify the specific app causing the issue with the format {appvendor}.{appname}@{appversion}. For example: template.mygiftcard@0.x.

  2. If the dependent app version is deprecated, a release candidate, or a pre-release, disable it so the system can use a stable version. Run:


    _10
    vtex deprecate {appvendor}.{appname}@{appversion}

  3. To install the latest stable version of the app in an account, run:


    _10
    vtex update {appvendor}.{appname}

  4. If deprecation isn't needed and you want to republish that specific version, run:


    _10
    vtex undeprecate {appvendor}.{appname}@{appversion}

  5. After adjusting dependencies, try installing the theme or publishing the app again.

If the issue persists, open a ticket with VTEX Support.

Contributors
1
Photo of the contributor
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
1
Photo of the contributor
Was this helpful?
Suggest edits (GitHub)
On this page