Planning for Mini-Migration - Joomla 2.5 to 3.10

From Joomla! Documentation

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎català • ‎español • ‎français • ‎português do Brasil • ‎български • ‎русский

Going from Joomla 2.5 to 3.10.x is considered a mini-migration or a minor migration. This means that Joomla core extensions will upgrade with a "one-click update" but third-party extensions are debatable and need to be taken on a case by case basis.

The one-click update will be fine and work well for many. For some larger, more complex sites, the one-click update may not be the best route. For large or very complex sites, you may want to follow instructions for a regular migration and bypass the one-click update functionality. To do this, follow the same instructions for planning 1.5 to 4.x and migrating from Joomla 1.5 to 4.x, simply substitute 2.5 for 1.5 while reading.


Migrations are a great time to reassess goals, clean up, and develop other areas/elements of your site. The more organized you can be with your ideas/thoughts/plans the better. Plan, plan, plan. Planning makes execution easier.

Start planning by asking the following questions or doing the tasks listed below. You may have more items to plan for depending on the complexity of your site. Sadly, there is no way we can list every possible scenario. You can ask specific questions on the Joomla 4.x General Questions/New to Joomla 4.x Forum.

Planning Action Items[edit]

  1. Assess your original site goals. Migration is an opportunity to get back into focus with your goals or change direction.
  2. Does your server meet the minimum Technical Requirements for Joomla 3? If not, you will need to change hosts. No better time to change hosts than during a migration.
  3. What kind of development environment will you use? A development environment on your local device? A subdomain or subdirectory on your server? A new server/hosting account due to technical specifications?
  4. Make a list of all third-party extensions in use. This includes components, modules, plugins, languages, and templates. You may copy/paste them into a document for reference, or a paper and pen works too. Include if these extensions are used heavily, moderately, hardly ever, or not at all.
  5. Determine whether the third-party extensions you rely on are ready for the version of Joomla you are migrating to.
  6. Determine if you really need all the extensions you are using. Could it be that Joomla 4 has built in features that could eliminate the use of a third-party extension?
  7. Take a look at your Categories and Articles. Is there clean-up that needs to be done so that you don’t migrate unnecessary content?
  8. What about your template? If you purchased your template from a third-party source, is there a 3.x and 4.x version released for it? Would you like to continue using it? Is there an upgrade path published by the developer? Is the new version of it responsive? Is your template a custom template? Or was it heavily customized from a third-party template? For an expansion of Template based considerations, see Template Considerations During Migration.
  9. If you are changing out your template for a new one, will it require any new images? For example, if your current site has a white background and your logo or other images are .jpg images with a white background it won’t look very nice against a new template with an off-white or coloured background.
  10. If you redesign or make changes to your site design or navigation, will you have obsolete pages that will require a redirect?

See Planning for Mini-Migration - Joomla 2.5 to 4.x

Joomla 2.5 to 3.x Step by Step Migration