> For the complete documentation index, see [llms.txt](https://docs.vega365.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vega365.com/xport/user-manual/e-code-to-c-code/step-by-step-user-guide/migrate-users-and-roles.md).

# Migrate Users and Roles

Preserve access control by moving users and their roles to the new system.

1. E-code versions have users, but do not have a concept of roles. The process below provides a ramp to allocate users on the e-code system to roles on the c-code system.

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2FBGzTenf21zKyNME4g9nG%2FScreenshot%202025-06-25%20150701.png?alt=media&amp;token=a3583ceb-d5fe-4b9a-9607-ff7f8c6253fd" alt="" width="563"><figcaption></figcaption></figure>

2. If necessary, create roles in the destination system by clicking on the add (+) button.

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2Fxfw750uw28bDNuUb3aHM%2Fimage.png?alt=media&amp;token=c6961bd4-8928-46bc-98f3-c1db9f36c609" alt="" width="563"><figcaption></figcaption></figure>

3. Drag and drop users to destination roles.

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2FanYuYxJnQEFwckty6WFx%2Fimage.png?alt=media&amp;token=5d30652a-d199-47af-9073-274ff71c84df" alt="" width="563"><figcaption></figcaption></figure>

4. Click the migrate button to add users to the role.

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2FS3umKCs69ywiNvGPakXT%2Fimage.png?alt=media&amp;token=f6ebb8e2-a7a3-4f49-9a2c-e5af11eb70e4" alt="" width="563"><figcaption></figcaption></figure>

5. Click "View Log" to view the logs, if needed.

<figure><img src="https://771655570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxj7X0c61rEOwTqSjg2jo%2Fuploads%2FKGjfDrQHSbait89FQzQG%2Fimage.png?alt=media&amp;token=89fdbac2-1bc6-4e3d-9c1a-1a9eab8fda3c" alt="" width="563"><figcaption></figcaption></figure>
