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
Using the Concrete Migration Tool Addon
Apr 27, 2023

How to use the Concrete CMS Migration Tool

How To Add Page Last Updated To Your Concrete CMS Pages
Mar 7, 2023

Concrete CMS has a page attribute you can add to a global area called "Page Date Modified." Here's how to add it

How To Exclude Subpages from Navigation
Dec 24, 2022

How to exclude subpages from navigation - useful for a news or blog link in your main navigation where you don't want all the subpages to appear in a drop down menu.

How Can I Change The Maximum Size Of Uploaded files
Dec 13, 2022

This tutorial explains how to update your php settings.

Updating Concrete Themes from Version 8 to Version 9
Nov 24, 2022

This tutorial covers commonly encountered issues when upgrading a Concrete CMS theme from version 8 to version 9

Transferring ownership of an add-on and a theme
Nov 15, 2022
By katzueno.

If you encounter a Concrete CMS add-on or theme that you love but not being maintained, you may want to ask the author to help or take over the add-on or theme. Here is the quick step-by-step guide of how to transfer the ownership.

Was this information useful?
Thank you for your feedback.