> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/release-orchestration/3.0/troubleshooting/variable-mapping-errors.md).

# Variable Mapping Errors

Variable mapping errors occur when variables cannot be resolved or mapped correctly.

### Common Errors <a href="#common-errors" id="common-errors"></a>

#### Undefined Variables <a href="#undefined-variables" id="undefined-variables"></a>

**Problem**: Variable not defined **Solution**:

* Check variable definition
* Verify variable scope
* Provide default values

#### Type Mismatches <a href="#type-mismatches" id="type-mismatches"></a>

**Problem**: Variable type mismatch **Solution**:

* Check variable types
* Convert types if needed
* Validate types

### Resolution <a href="#resolution" id="resolution"></a>

#### Variable Validation <a href="#variable-validation" id="variable-validation"></a>

Validate variables:

* **Check Definitions**: Verify definitions
* **Check Scope**: Verify scope
* **Check Types**: Verify types
* **Test Mapping**: Test mappings

### Related Topics <a href="#related-topics" id="related-topics"></a>

* [Common Issues](/release-orchestration/3.0/troubleshooting/common-issues.md)
* [Stuck Releases](/release-orchestration/3.0/troubleshooting/stuck-releases.md)
* [Execution Failures](/release-orchestration/3.0/troubleshooting/execution-failures.md)