Troubleshooting
Find and resolve common YAML, Properties, installation and IDE compatibility issues.
Quick troubleshooting checklist
- Confirm the plugin version matches your IntelliJ IDEA version (check the History Versions page).
- After installation, restart the IDE to ensure indexing and file type recognition.
- Verify the file type: YAML (*.yml/*.yaml) or Properties (*.properties).
- Test with a minimal sample (e.g., only spring.application.name) to exclude project-specific conflicts.
- If completion works in a new project but not in your current one, check IDE cache/index and try reimporting the project.
Common configuration mistakes
- YAML indentation: wrong nesting levels cause keys to be ignored.
- Typos in keys: a single wrong character makes the configuration ineffective.
- Profile override order: values in application-*.yml may override base config unexpectedly.
- Type mismatch: numbers/booleans quoted as strings (or vice versa) can trigger binding issues.
Need more help?
Read the Installation section in Documentation first. If the problem persists, download the plugin version that matches your IDE and retry. You can also report issues via the GitHub link in the footer.
When to use the troubleshooting checklist
- YAML or Properties completion does not appear after installing the plugin.
- Completion works in a new project but not in the current project because of cache, indexing, or file type recognition.
- After upgrading IntelliJ IDEA, the installed plugin no longer matches the IDE major version.
- A configuration key looks correct but does not take effect at runtime, requiring profile override and spelling checks.