# How to get the migration plugin to help migrating from 1.x?

**URL:** https://platform.jetbrains.com/t/how-to-get-the-migration-plugin-to-help-migrating-from-1-x/665
**Category:** Gradle Build Scripts
**Created:** [February 23, 2025, 6:59pm UTC](https://platform.jetbrains.com/t/how-to-get-the-migration-plugin-to-help-migrating-from-1-x/665 "2025-02-23T18:59:42Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![mjparme](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/mjparme/32/586_2.png) [@mjparme](https://platform.jetbrains.com/u/mjparme)
#### Post date: [February 23, 2025, 6:59pm UTC](https://platform.jetbrains.com/t/how-to-get-the-migration-plugin-to-help-migrating-from-1-x/665/1 "2025-02-23T18:59:42Z")

</div>

The documentation for migration from 1.x to 2.x of the platform plugin has this section:

> **[Migrating from Gradle IntelliJ Plugin (1.x) | IntelliJ Platform Plugin SDK](https://plugins.jetbrains.com/docs/intellij/tools-intellij-platform-gradle-plugin-migration.html#migration-plugin)**

It says the migration plugin “…fill[s] all gaps and help users figure out required changes”. However, it doesn’t appear to do anything. What exactly does it do and how do I trigger it to help me figure out the required changes? The documentation is silent on what exactly I should be expecting this plugin to do.

---

<div class="post-metadata">

### Author: ![jonathanlermitage.1](https://avatars.discourse-cdn.com/v4/letter/j/e480ec/32.png) [@jonathanlermitage.1](https://platform.jetbrains.com/u/jonathanlermitage.1)
#### Post date: [February 23, 2025, 9:23pm UTC](https://platform.jetbrains.com/t/how-to-get-the-migration-plugin-to-help-migrating-from-1-x/665/2 "2025-02-23T21:23:27Z")

</div>

From my own experience, it simply shows some warnings. So, as mentioned in the documentation, you should apply the intellij-platform-plugin v2 along with the migration plugin. The build (`gradlew buildPlugin`) will probably fail, but the migration plugin may show some useful warning messages like `intellij {} should be replaced by the new intellijPlatform {}`. AFAIK, there is no OpenRewrite rules or things like that.

The official [plugin template v2](https://github.com/JetBrains/intellij-platform-plugin-template) can help you, but this is mainly a _starter_ project. You should consider looking at existing open-source plugins that completed their migration.

---

<div class="post-metadata">

### Author: ![mjparme](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/mjparme/32/586_2.png) [@mjparme](https://platform.jetbrains.com/u/mjparme)
#### Post date: [February 23, 2025, 11:05pm UTC](https://platform.jetbrains.com/t/how-to-get-the-migration-plugin-to-help-migrating-from-1-x/665/3 "2025-02-23T23:05:48Z")

</div>

I didn’t end up needing that plugin. I just brought the build file over from the template project (and `libs.versions.toml` and `gradle.properties`) and made a couple of modifications and was able to build and run the plugin with 2.x of the intellij platform plugin.

I am not the original author of the plugin, it seems to have been abandoned and I am seeing if I can add a couple of features to it (it is a custom language plugin for OpenSCAD). Custom language plugins seem to have a huge learning curve…sigh.
