> For the complete documentation index, see [llms.txt](https://molgenis.gitbook.io/molgenis/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://molgenis.gitbook.io/molgenis/configuration/guide-migration.md).

# Migration

We only specify functional migration steps in this guide.

## From 7.x to 8.x

Functional migration steps from MOLGENIS 7.x to 8.x

### EMX models and other configuration

The following changes require manual actions (if applicable for your application):

* MREF as labels are not allowed anymore. You should use template expressions. Please check: [template expressions](/molgenis/data-management/guide-emx.md#template).
  * You can migrate the database first and if you encounter the following error

    ```
    Error:
      Conversion failure in entity type [#name#] attribute [#name#]; No converter found capable of converting from type [org.molgenis.data.support.DynamicEntity] to type [java.lang.String]
    ```

    You can fix these attributes in the Metadata Manager by editing the expression of the mentioned attribute.
* If users or groups were giving special permissions on the *Settings Manager* Plugin, these permissions should be set again for the replacement *Settings* Plugin. The plugin itself is replaced automatically.