Using the Concrete Migration Tool Addon

Apr 27, 2023

The Concrete CMS Migration Tool is a powerful tool that allows users to migrate content one Concrete install to another. The tool is designed to simplify the process of moving content from one system to another by automating many of the tasks that would normally need to be done manually.

The Migration Tool works by exporting content from the source system into a standardized format (An XML file and a Zip file for files), then importing that content into the target system. To use the Migration Tool, you first need to identify the source and target systems you will be working with.

You can use install the Migration Tool on both the source site and the destination site by adding the package to the /packages directory and installing it by going to "Extend Concrete". Installing Import Tool

Content you might export from the source site might include content like pages, blocks, files, and other content, etc. - you can specify what parts of the site to export during the export process. The tool will then convert this content into a standardized format (CIF or Concrete Import Format) that can be imported into the target site.

You can find the Import tool under System & Settings > Import Tool after installing it.

Concrete Import Tool Location after install.

Exporting Content

To create an export, you will need to create a batch. You can create a batch by going to System & Settings > Import Tool > Export Content and then clicking the "Add Batch" button.

Concrete CMS Import Tool Add Batch Button

Once you've created the batch, you will want to specify what content you want to add to it.

Concrete CMS Import Tool - Assigning content to batch

For instance, you will commonly want to export/import pages. Once you select pages, you get a similar set of options that you would in the Page Search section of the dashboard - this lets you narrow down what subselection of pages you want to include (or maybe you want to include all of them - then you can just search without setting any filters).

Concrete CMS Import Tool - Adding Pages

You can select all the results and then hit the "Add to Batch" button. Repeat this process of adding different objects like pages, stacks, users, etc. to the batch until you have everything you want to export batched together. Then, click the "Export Batch" button and download the XML file and the zip file provided by the tool. You will upload these to the destination site to complete the export.

Importing into the new site

After the content has been exported, you can use the Migration Tool to import the content into the target system. The tool will automatically map the content from the source system to the corresponding content in the target system, making it easy to ensure that everything is properly aligned. If the Migration Tool isn't sure what maps to what, it will give you an opportunity to set the mappings manually.

Recent Tutorials
Create custom Site Health tasks
Apr 19, 2024
By myq.

This tutorial will guide you through the creation of a new Site Health task

Reusing the same Express entity in multiple associations
Apr 11, 2024
By myq.

How to create and manage multiple associations in Express

Express Form Styling
Apr 11, 2024
By myq.

Different ways to style Express forms

Setting addon/theme version compatibility in the marketplace
Jan 9, 2024

For developers worn out with setting the latest addon or theme version manually across too many core versions, here is a JavaScript bookmarklet to do it for you.

How to get the locale of a page
Jan 8, 2024
By wtfdesign.

Now, why don't we just have a getLocale() method on Page objects beats me, but here's how you work around it

Using a Redis Server
Jun 16, 2023
By mlocati.

How to configure Concrete to use one or more Redis servers to persist the cache.

Improvements?

Let us know by posting here.