Validating Designs

Prior to deploying a design, you can validate the configuration that it contains in accordance with the target platform.

How Validation Works 🔗

Meshery uses static analysis to verify your design. It checks all components within your design and all configured and unconfigured properties of your components against well-defined schemas based on Meshery Models.

This comprehensive validation ensures that:

The design adheres to the expected structure and format.
All components are valid and recognized by Meshery.
There are no missing required configurations.

Performing Validation 🔗

To validate your design, navigate to the Actions button at the top of the Design canvas.

Click on the Validate Icon.

Actions menu with Validate available; Dry Run, Deploy, and Undeploy disabled while signed out — Actions menu (anonymous capture, Sep 2026): **Validate** is available without sign-in; Dry Run / Deploy / Undeploy stay disabled until you have a signed-in session and target context.

If the validation is successful, you will see a modal displaying the number of components validated and the number of annotations, similar to the one shown below:

Validation complete notification toasts after running Validate — Validation result toasts (same anonymous session as the autosave capture). Prefer the modal above for the component/annotation counts UI when it matches your build.

Handling Validation Errors 🔗

If your design fails validation checks, the modal will indicate the number of errors detected. Each error will provide specific information about the component or annotation that caused the failure. Use this detailed feedback to identify and correct the issues in your design before proceeding with the deployment.

Validation Errors 🔗

A common validation error is:

Missing Required Field: This happens when a required field is not provided. For example, in the image below, the component is missing three required properties under “.spec”, and the first error names instanceCount. Click the component’s row in the modal to expand its errors.

To troubleshoot and remediate validation issues:

Click on the error on the modal.
This will open the configuration tab of the component that has that error.
Fix the configuration using the error details provided.
Re-run validation after any significant changes to your design to ensure all issues are resolved.

The validation process is confined to schema-based checks within Meshery and does not require communication with your target environment.