---
id: topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp
type: topic
title: Migrate from Dynamics GP
summary: "Migrating on-premises Dynamics GP to Business Central online: the process, preparation, cloud migration setup, data replication, data upgrade and final completion steps. It answers questions about phases, prerequisites, configuration, monitoring, validation, and post-migration users and permissions."
tier: official
language: en
system: administration
review:
  state: reviewed
  by: opus
  at: "2026-10-07T13:37:24.317Z"
  flags: []
generated:
  at: "2026-10-08T00:04:31.553Z"
  pipeline: 0.2.0
  prompts:
    hub-topic: 1
  input_hash: bf87e774b6710b1b51998d07fb32ac0da1dc3119e497fef0747c2d717e01ffdd
evidence:
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/cloud-migration-prerequisites-gp
    title: Cloud Migration Prerequisites for Dynamics GP
    date: "2024-02-29"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-setup-overview
    title: Cloud migration setup overview
    date: "2024-12-13"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migrate-dynamics-gp-videos
    title: Compare Work in Dynamics GP to Business Central
    date: "2022-07-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-finish-gp
    title: Complete cloud migration for Dynamics GP
    date: "2024-02-29"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migrate-gp-configure-companies
    title: Configure Dynamics GP company migration
    date: "2026-01-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-data-replication
    title: Data replication overview
    date: "2023-01-15"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-manage-gp
    title: Managing Dynamics GP cloud migration
    date: "2024-02-29"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migrate-dynamics-gp
    title: Migrate Dynamics GP data to the cloud
    date: "2026-01-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migrate-gp-overview
    title: Migrate on-premises GP data to Business Central online overview
    date: "2024-12-13"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migrate-gp-validation
    title: Migration validation overview
    date: "2025-01-09"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/cloud-migration-plan-prepare-gp
    title: Prepare and plan for cloud migration from Dynamics GP
    date: "2024-02-19"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-retain-permissions
    title: Retain permissions
    date: "2024-02-29"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migrate-data-replication-run
    title: Run and manage data replication
    date: "2024-12-20"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-setup-gp
    title: Run cloud migration setup for Dynamics GP migration
    date: "2024-02-29"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-data-upgrade-gp
    title: Upgrade data for Dynamics GP cloud migration
    date: "2024-02-29"
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-finish-gp
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-data-upgrade-gp
  objects:
    - object/page/4003
  features: []
  topics:
    - topic/dev-itpro/administration/migrate-to-business-central-online
    - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/overview
    - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/prepare
    - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/set-up-cloud-migration
    - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/replicate-data
  localizations: []
  videos:
    - video/2430rfEywuI
    - video/Ry9QvV6D7lg
  posts: []
  guidelines: []
learn_toc_path:
  - Administration
  - Migrate to Business Central online
  - Migrate from Dynamics GP
toc_file: dev-itpro/TOC.md
parent: topic/dev-itpro/administration/migrate-to-business-central-online
children:
  - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/overview
  - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/prepare
  - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/set-up-cloud-migration
  - topic/dev-itpro/administration/migrate-to-business-central-online/migrate-from-dynamics-gp/replicate-data
coverage:
  learn: 15
  code: 1
  video: 2
  blog: 0
  guideline: 0
bc_forms:
  - 2502
  - 4003
member_hash: 194e2f11f11c01c69a77d6adec2ece8f0a046e31253c78df1c253f2c9e08c7c5
narrative: generated
---

# Migrate from Dynamics GP

> Migrating on-premises Dynamics GP to Business Central online: the process, preparation, cloud migration setup, data replication, data upgrade and final completion steps. It answers questions about phases, prerequisites, configuration, monitoring, validation, and post-migration users and permissions.

Path: [Administration](../../administration.md) > [Migrate to Business Central online](../migrate-to-business-central-online.md) > Migrate from Dynamics GP · tier official · system administration · narrative reviewed (checked by Opus)

## Overview

This section walks through moving Dynamics GP data into Business Central online. It follows the order of the migration: an overview of the process and migrated data, preparation and planning, setting up cloud migration, replicating data, upgrading data, and completing the migration.

Start with the Overview to understand the phases, which GP data moves, and how everyday GP work maps to Business Central. Then use Prepare to check prerequisites for the destination environment, the source system and the self-hosted integration runtime, and to plan scope and approach. Set up cloud migration covers the connection and pipeline, running the setup, GP company migration settings, and retaining user permissions.

Replicate data explains how to run and manage replication from the Cloud Migration Management page and how to validate migrated data. The two pages in this section cover the later steps. Data upgrade transforms GP tables into Business Central tables, and you review migration errors in the operations log. Completing the migration means validating data, disabling cloud migration, and setting up user accounts and permission sets in Business Central online.

## Key points

- Source is on-premises Dynamics GP and the target is Business Central online.
- Prepare covers prerequisites for the destination, the source system and the self-hosted integration runtime.
- Planning covers migration strategy, the migration assessment tool, data scope, and an approach with backup, replication and upgrade steps.
- Setup involves the connection and pipeline, running the setup, GP company migration settings, and retaining user permissions.
- Replication is run and managed from the Cloud Migration Management page, followed by validation of migrated data.
- Data upgrade transforms Dynamics GP tables into Business Central tables; errors can be checked in the operations log.
- Completion means checking validation status, disabling cloud migration, and setting up user accounts and permission sets.

## Subtopics

- [Overview](migrate-from-dynamics-gp/overview.md) (4 pages)
- [Prepare](migrate-from-dynamics-gp/prepare.md) (2 pages)
- [Set up cloud migration](migrate-from-dynamics-gp/set-up-cloud-migration.md) (4 pages)
- [Replicate data](migrate-from-dynamics-gp/replicate-data.md) (3 pages)

## More Learn pages

- [Complete cloud migration for Dynamics GP](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-finish-gp): This article describes the task you do to complete the data migration from Dynamics GP to online.
- [Upgrade data for Dynamics GP cloud migration](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-data-upgrade-gp): This article explains the process for running the data upgrade as part of Dynamics GP cloud migration.

## Videos and posts

Linked by a Haiku matcher with a grounding quote from the item's summary (link/topics.ts); machine-generated.

- [GP Assessment Tool - Optimize Your Migration to Dynamics 365 Business Central (2024)](../../../../videos/2430rfEywuI.md) (video): "gp assessment; migration planning; cloud migration; gp to business central"
- [Dynamics GP Cloud Migration - Moving to Business Central](../../../../videos/Ry9QvV6D7lg.md) (video): "Dynamics GP Cloud Migration - Moving to Business Central. Topics: gp migration; cloud migration; data migration"

## Business Central pages and reports

The pages, reports and queries this hub's Learn pages name (ms.search.form, API reference), joined to the code by exact object id (data/index/docs-objects.json); a page shows the table it runs on.

- [Page 4003 "Intelligent Cloud Management"](../../../../objects/page/4003.md) · captioned "Cloud Migration Management" · on [Table 4001 "Hybrid Replication Summary"](../../../../objects/table/4001.md) · via [Overview](migrate-from-dynamics-gp/overview.md)

Learn also names 1 object with no object page: page/2502.

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn's own.