PHPackages                             concretecms/migration\_tool - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. concretecms/migration\_tool

ActiveConcrete5-package[Utility & Helpers](/categories/utility)

concretecms/migration\_tool
===========================

Import content into your concrete5 sites. Cross-grade from version 5.6, 5.7 and more.

102.1k6[12 issues](https://github.com/concretecms/migration_tool/issues)[10 PRs](https://github.com/concretecms/migration_tool/pulls)PHPCI passing

Since Apr 15Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/concretecms/migration_tool)[ Packagist](https://packagist.org/packages/concretecms/migration_tool)[ RSS](/packages/concretecms-migration-tool/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (13)Used By (0)

Installation
============

[](#installation)

Download the Correct Package
----------------------------

[](#download-the-correct-package)

There are several versions of the Migration Tool designed to work with various historical and current versions of Concrete CMS. Navigate to the appropriate GitHub repository page and download the latests release of the master branch:

Concrete CMS (concrete5) VersionCompatible Migration ToolBranchPackage Directory<=5.6.x (legacy)[Addon Migration Tool (Legacy)](https://github.com/concretecms/addon_migration_tool_legacy)master[migration\_tool](https://github.com/concretecms/addon_migration_tool_legacy/tree/master/packages/migration_tool)5.7x through 8.x[Addon Migration Tool](https://github.com/concretecms/addon_migration_tool)master[migration\_tool](https://github.com/concretecms/addon_migration_tool/tree/master/packages/migration_tool)9.x+[Migration Tool](https://github.com/concretecms/migration_tool)master[migration\_tool](https://github.com/concretecms/migration_tool)Install the Package on Your Concrete CMS
----------------------------------------

[](#install-the-package-on-your-concrete-cms)

1. **Upload the package:**
    - Extract the downloaded ZIP file.
    - Upload or copy the `migration_tool` directory to your Concrete installations under `packages/` (located in the installation root).

General Process Note
====================

[](#general-process-note)

Exporting and importing content is not always a straightforward process. Differences in the source and destination sites may require new attribute mappings or other compromises. The hurdles and solutions are not always obvious from the outset, so unless the two sites are exact copies, plan on this being an iterative process.

To help simplify this process, it may be useful to group exported data into smaller batches of content either by type or by size. The importation of these smaller batches can be verified for accuracy and completeness and, if issues are found, can be corrected through different mappings.

As part of this process, the destination site might accumulate imported content which is not correct. A backup should be made of the destination site before importing any content or, if the site is a fresh installation, be prepared to drop the database and start over. To simplify the process, content mapping settings can be saved and revised until all content is imported correctly. This makes the process repeatable and facilitates a final import after this trial-and-error process.

More detailed instructions and advice can be found in the [Migration Tool Tutorial](https://documentation.concretecms.org/tutorials/using-concrete-migration-tool-addon).

Exporting Content
=================

[](#exporting-content)

From the source site, export the content using the following steps.

Access the Migration Tool
-------------------------

[](#access-the-migration-tool)

- After installation, access the Migration Tool by navigating to **Dashboard** > **Migration Tool**.

Create a New Export Batch
-------------------------

[](#create-a-new-export-batch)

1. **Create Batch:**

    - Click on **Create New Batch**.
    - Name your batch for easy identification. Content is often exported in batches rather than all at once especially when there are large differences beteen the source and destination sites. For example, you might export users and associated information as one batch first, and then later export the pages they authored as another batch.
2. **Select Content to Export:**

    - Choose the content types you wish to export (e.g., pages, files, users).
    - Configure the specifics for each content type, such as which pages or which user data to include.

Run the Export
--------------

[](#run-the-export)

- Once you’ve configured your batch, click **Export** to generate a XML file containing your selected content.
- Download this file to your local machine. It will be used to import content to the destination site.

Importing Content
=================

[](#importing-content)

Upload the Export File
----------------------

[](#upload-the-export-file)

- Navigate to **Dashboard** > **Migration Tool** on the destination site.
- Click on **Import Content**.

Start the Import Process
------------------------

[](#start-the-import-process)

1. **Upload the XML File:**

    - Use the file upload interface to select and upload the XML file you exported from the source site.
2. **Import Content:**

    - After the file is uploaded, the tool will automatically parse the XML.
    - Review the content and configurations to be imported. Map the content where needed. This is where breaking the exported content into batches as this process can be labor intensive.
        - Once all content is mapped, consider saving the mapping settings. This can help save time if the import process does not work as expected.
    - Click **Perform Import** to begin the import process.

Verify the Imported Content
---------------------------

[](#verify-the-imported-content)

- After the import process completes, verify that all content has been successfully imported and is functioning as expected. You may have to try importing the content with different settings or mappings and check the results for completeness.
- Check for any discrepancies or issues and address them as necessary. If you have saved the content mappings, this trial-and-error process will be much easier.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance36

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 75.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/842d2fe13512e82f0f9b6f0d79dba8eba1595a3cefd31dd51723960436133307?d=identicon)[KorvinSzanto](/maintainers/KorvinSzanto)

![](https://www.gravatar.com/avatar/d8d8902700dc0979d0cb96ff69a17808f74823c0c2b4ef75d91aba2f66d6f5fb?d=identicon)[aembler](/maintainers/aembler)

---

Top Contributors

[![aembler](https://avatars.githubusercontent.com/u/527809?v=4)](https://github.com/aembler "aembler (335 commits)")[![mlocati](https://avatars.githubusercontent.com/u/928116?v=4)](https://github.com/mlocati "mlocati (64 commits)")[![hissy](https://avatars.githubusercontent.com/u/514294?v=4)](https://github.com/hissy "hissy (11 commits)")[![ignasigarcia](https://avatars.githubusercontent.com/u/161054?v=4)](https://github.com/ignasigarcia "ignasigarcia (9 commits)")[![fabian](https://avatars.githubusercontent.com/u/13346?v=4)](https://github.com/fabian "fabian (6 commits)")[![jbender0](https://avatars.githubusercontent.com/u/54802325?v=4)](https://github.com/jbender0 "jbender0 (6 commits)")[![shahroq](https://avatars.githubusercontent.com/u/7886999?v=4)](https://github.com/shahroq "shahroq (4 commits)")[![wordish](https://avatars.githubusercontent.com/u/42463480?v=4)](https://github.com/wordish "wordish (3 commits)")[![Mesuva](https://avatars.githubusercontent.com/u/1079600?v=4)](https://github.com/Mesuva "Mesuva (2 commits)")[![biplobice](https://avatars.githubusercontent.com/u/2462951?v=4)](https://github.com/biplobice "biplobice (2 commits)")[![martbase](https://avatars.githubusercontent.com/u/3264387?v=4)](https://github.com/martbase "martbase (1 commits)")[![KorvinSzanto](https://avatars.githubusercontent.com/u/1007419?v=4)](https://github.com/KorvinSzanto "KorvinSzanto (1 commits)")[![olsgreen](https://avatars.githubusercontent.com/u/1324164?v=4)](https://github.com/olsgreen "olsgreen (1 commits)")[![carlos22](https://avatars.githubusercontent.com/u/526996?v=4)](https://github.com/carlos22 "carlos22 (1 commits)")

### Embed Badge

![Health badge](/badges/concretecms-migration-tool/health.svg)

```
[![Health](https://phpackages.com/badges/concretecms-migration-tool/health.svg)](https://phpackages.com/packages/concretecms-migration-tool)
```

###  Alternatives

[websharks/html-compressor

Combines & compresses CSS/JS/HTML code.

407.1k1](/packages/websharks-html-compressor)[limewell/laravel-make-extender

This package helps to generate and autoload custom helpers, It can generate multilevel helpers in the context of the directory.

366.8k](/packages/limewell-laravel-make-extender)[linkorb/autotune

Tune your autoloader

177.0k17](/packages/linkorb-autotune)[jayanka/patch-manager

A magento extension to maintain data patches

232.4k](/packages/jayanka-patch-manager)[tapp/filament-progress-bar-column

Add beautiful, color-coded progress bars to your Filament table columns. Perfect for inventory, tasks, storage, and any progress metrics without writing custom views.

124.5k](/packages/tapp-filament-progress-bar-column)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)