Upgrade 5.6 to 5.7

This tutorial is over a year old and may not apply to your version of Concrete CMS.
Feb 24, 2016

When we released concrete5 5.7 last year, it was a big deal. The interface and underlying code had been completely modernized, giving Concrete CMS a solid foundation for the evolving web. Unfortunately, that overhaul was not without some downsides: marketplace add-ons needed to be rewritten, and for the first time ever, there was a version of concrete that wasn't backward-compatible.

Thankfully now we have the answer for that: these are our migration tools, built for both 5.6 and earlier and concrete 5.7. These tools are free, open source and available on GitHub.

http://github.com/concrete5/addon_migration_tool_legacy http://github.com/concrete5/addon_migration_tool

The legacy version exports content from a concrete 5.6 site, and the 5.7 migration tool handles export from and import to a 5.7 site. Export lets you choose which content you want to include from your site, and add it piecemeal to a batch:

The content is then turned into XML, written in the concrete5 Interchange Format (formerly the Content Import Format.) Download this XML file and any associated files, and import them into the new site. Importing is even more powerful: knowing that we were migrating from old, completely different 5.6 installs into 5.7 forced us to build the import tools in a forgiving, powerful and flexible way. When you import content there's full error reporting, file support, and the ability to map old content types found in the XML to new content types found in your site.

We used these tools when building our new community-driven documentation website and they work great.

The export tools built into the 5.7 migration tool also replace the Sample Content Generator, which add-on and theme developers can use to generate sample content. Unlike the Sample Content Generator add-on, the migration tool can build XML exports of just portions of your site, making it much easier to work with than the old add-on.

There's much more to do: specifically the 5.7 exporter needs support for all the data types that can be included in CIF files. There will be GitHub issues for these items shortly, and we'd love community help on this project. Let's get out there and upgrade some sites!

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.