# 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/8.4/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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://molgenis.gitbook.io/molgenis/8.4/configuration/guide-migration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
