# Gradle Project not linked

**URL:** <https://discuss.gradle.org/t/gradle-project-not-linked/50752>\
**Category:** Help/Discuss\
**Created:** [April 3, 2025, 3:07pm UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752 "2025-04-03T15:07:47Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![Guihom](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/guihom/32/11549_2.png) [@Guihom](https://discuss.gradle.org/u/Guihom)\
**Post date:** [April 3, 2025, 3:07pm UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/1 "2025-04-03T15:07:47Z")

</div>

Hello,  
I a beginner in flutter developpement and i just created a new flutter project in Android Studio.  
I have done nothing else but I already have a error when i look to settings.gradle.kts : **Code Insight unavailable (related Gradle project not linked).**  
I have a button to link Gradle project but i don’t really understand what i have to link.  
Can you help me please ?

---

<div class="post-metadata">

**Author:** ![Vampire](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/vampire/32/9082_2.png) [@Vampire](https://discuss.gradle.org/u/Vampire)\
**Post date:** [April 3, 2025, 4:31pm UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/2 "2025-04-03T16:31:53Z")

</div>

That just means your IDE did not import the project as the Gradle project is not linked to your IDE project.  
This is more an IDE question than a Gradle question.  
Usually it should automatically linked, but if not, just press the button and it should be properly linked / synched, unless there was an error during the sync that prevented it to be linked properly.

---

<div class="post-metadata">

**Author:** ![Guihom](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/guihom/32/11549_2.png) [@Guihom](https://discuss.gradle.org/u/Guihom)\
**Post date:** [April 3, 2025, 5:58pm UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/3 "2025-04-03T17:58:49Z")

</div>

Thx for your answer.  
When I click on the link, i have to indicate the path to something ! But i don’t understand what i have to link to !

---

<div class="post-metadata">

**Author:** ![Vampire](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/vampire/32/9082_2.png) [@Vampire](https://discuss.gradle.org/u/Vampire)\
**Post date:** [April 3, 2025, 10:29pm UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/4 "2025-04-03T22:29:44Z")

</div>

Well, maybe you should show a screenshot of what you are seeing  
or actually you maybe should ask the IDE support instead. 🤷‍♂️

---

<div class="post-metadata">

**Author:** ![Guihom](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/guihom/32/11549_2.png) [@Guihom](https://discuss.gradle.org/u/Guihom)\
**Post date:** [April 5, 2025, 8:06am UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/5 "2025-04-05T08:06:18Z")

</div>

Actually, everything seems to works despite this message.  
So, I will forget it 😇  
Thx for your help.

---

<div class="post-metadata">

**Author:** ![Gitesh](https://avatars.discourse-cdn.com/v4/letter/g/ecb155/32.png) [@Gitesh](https://discuss.gradle.org/u/Gitesh)\
**Post date:** [April 24, 2025, 5:37am UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/7 "2025-04-24T05:37:42Z")

</div>

i am getting the same issue and i am attaching the screenshot of which i am getting after clicking on link gradle project button

 ![Screenshot (6)](https://global.discourse-cdn.com/gradle/original/2X/5/5e7da90d01e2cd33da501e6dd35f0dae26f1ea8c.png)

and then i am choosing the android folder to link gradle project but then ide download some files and warning goes out but the project structure mismatch and if i reopen the project so the ide start linking the gradle file with project automatically and sometimes it dont shows any waring but major time the linking failed and shows another warning that “Gradle project sync failed. Basic functionality (e.g editing, debugging) will not work properly”.

plz help me why i am getting this warning even after creating new project i have several questions.

1. should i forgot this error?
2. should i solve this error?
3. will it automatically solved by ide?
4. will it affect at release level build?

---

<div class="post-metadata">

**Author:** ![Vampire](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/vampire/32/9082_2.png) [@Vampire](https://discuss.gradle.org/u/Vampire)\
**Post date:** [April 25, 2025, 7:38am UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/8 "2025-04-25T07:38:48Z")

</div>

> 1. should i forgot this error?

Probably not

> 1. should i solve this error?

Probably

> 1. will it automatically solved by ide?

Probably not

> 1. will it affect at release level build?

Depends on what your problem is.  
It is is just an IDE sync error, you just loose IDE functionality.  
If it is some other problem, you get other problems.

You forgot to share what error you got from the Sync exactly.  
After it failed the respective tool window should usually have opened.  
If not, open the “Build” tool window manually to retrieve the error.  
Optimally you would enable build scans programmatically and share the build scan URL for the failing Sync.

---

<div class="post-metadata">

**Author:** ![Dan1](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/dan1/32/11701_2.png) [@Dan1](https://discuss.gradle.org/u/Dan1)\
**Post date:** [August 7, 2025, 10:41am UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/9 "2025-08-07T10:41:48Z")

</div>

where u able to solve your problem?

---

<div class="post-metadata">

**Author:** ![Vampire](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/vampire/32/9082_2.png) [@Vampire](https://discuss.gradle.org/u/Vampire)\
**Post date:** [November 16, 2025, 2:50pm UTC](https://discuss.gradle.org/t/gradle-project-not-linked/50752/10 "2025-11-16T14:50:25Z")

</div>

A post was split to a new topic: [`androidx.core` requires new AGP version](https://discuss.gradle.org/t/androidx-core-requires-new-agp-version/51756)
