Android Support plugin for IntelliJ IDEA or Android Studio cannot open this project
Master System Design with Codemia
Enhance your system design skills with over 120 practice problems, detailed solutions, and hands-on exercises.
Introduction
The message saying the Android Support plugin or Android Studio cannot open a project usually means the IDE does not recognize the folder as a valid Android Gradle project. The cause is often one of four things: missing Android plugins, opening the wrong directory, an outdated project structure, or a Gradle and JDK mismatch.
The fix is to treat this as a project-import problem, not a random IDE glitch. Once the IDE can see a valid Gradle-based Android project with the right plugins and toolchain, the error usually disappears.
Understand What the IDE Expects
Modern Android projects are Gradle-based. Android Studio is built around that assumption, and current IntelliJ support also expects Android tooling to be installed explicitly.
JetBrains documents that Android support is not bundled with IntelliJ IDEA. If you open an Android project in plain IntelliJ without the Android plugins, the IDE may fail before Gradle sync even begins. Android Studio already includes the needed Android tooling, which is why opening the same folder there often works immediately.
At minimum, the project should contain files like these at the project root:
And the app module should be declared with the Android plugin:
If those files are missing, malformed, or buried under a subfolder you did not open, the IDE may conclude that the directory is not an Android project at all.
Open the Correct Folder and Reimport Cleanly
A common mistake is opening the app module directory instead of the project root. Open the folder that contains settings.gradle or settings.gradle.kts, not the folder that only contains src.
If the project was imported by an older IDE, stale metadata can also get in the way. In that case:
- Close the project.
- Delete
.ideaand any old.imlfiles. - Reopen the project from the Gradle root directory.
- Let the IDE import from Gradle instead of trying to reuse old IDE metadata.
This is especially useful when moving a project from IntelliJ to Android Studio, or when upgrading from very old Android plugin versions.
Check Toolchain Compatibility
Even if the folder is correct, the IDE may still refuse to open or sync the project if the versions do not line up.
Important compatibility points:
- Android Gradle Plugin version
- Gradle wrapper version
- JDK version used by the IDE
- Android Studio or IntelliJ build version
For example, a project using a recent Android Gradle Plugin may require a newer JDK than the IDE is currently configured to use. The wrapper should be committed with the project so everyone imports the same Gradle version:
If the import fails during sync, read the first Gradle error instead of focusing on the generic "cannot open this project" message. The root cause is often a missing repository, incompatible plugin, or unsupported Java version.
When IntelliJ Is the Wrong Tool
Some projects are better opened directly in Android Studio, especially if they rely on the full Android toolchain, layout editors, emulator integration, or recent Android Gradle Plugin behavior. If you are using IntelliJ IDEA, install both the Android and Android Design Tools plugins first. If the project is older and not Gradle-based, migrate it before expecting Android Studio to import it cleanly.
Google's migration guidance is straightforward: Gradle-based IntelliJ projects can be imported into Android Studio, while non-Gradle projects usually need a new Gradle build setup first.
Common Pitfalls
- Opening the
appfolder instead of the project root that containssettings.gradle. - Using IntelliJ without installing the Android plugins.
- Importing a non-Gradle legacy project and expecting Android Studio to convert everything automatically.
- Keeping stale
.ideametadata from a different IDE version. - Ignoring Gradle and JDK compatibility. A generic project-open error often hides a concrete toolchain mismatch underneath.
Summary
- This error usually means the IDE cannot recognize a valid Android Gradle project.
- Open the project root, not a module subdirectory.
- In IntelliJ IDEA, install the Android plugins because Android support is not bundled by default.
- Reimport cleanly from Gradle if old
.ideafiles are causing trouble. - If the project is legacy or heavily Android-specific, Android Studio is often the fastest path to a successful import.

