AdminActionsReplaceHome by Robin S

Replaces the template and content of the home page with that of a selected page. An addon action for the Admin Actions module.

Replace Home

An action for the Admin Actions module for ProcessWire CMS/CMF. The action replaces the template and content of the home page with that of a selected page.

Sometimes there is a need to develop a new home page while keeping the existing home page in place until the new version is ready and approved. Then you want to apply the new home page, but this is not so easy to do in ProcessWire since home is a special page that cannot simply be replaced by another page.

What the action does

  • Removes all the fields from the home template, which simultaneously deletes all the content from the home page.
  • Adds all the fields from the selected source page template and applies any template-specific overrides.
  • Sets the home page field values to match the source page.
  • Updates all file and image URLs in any textareas so they point to the home page files rather than the original source page.

What the action doesn't do

  • The action does not modify the home template file. You will probably want to update the home template file immediately after running the action (e.g. copy/paste the code of the source page template file).
  • The action does not automatically delete the source page – that can be done manually after you have confirmed that the action was successfull.


This action is destructive! It deletes content/files/images from the existing home page. In addition to the automatic Admin Actions database backup you should create a backup of /site/assets/files/ before running this action, and consider also making a manual database backup for extra safety.


  1. Install the Replace Home module.
  2. Visit the Admin Actions config screen and enable the "Replace Home" action for the roles who are allowed to use it.
  3. Create file system and database backups – see the warning section above.
  4. Navigate to Admin Actions > Replace Home, select the source page whose template and content will replace the home page, then execute the action.
  5. Update the home template file if needed.



Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Latest news

  • ProcessWire Weekly #531
    In the 531st issue of ProcessWire Weekly we’ll check out the latest weekly update from Ryan, introduce new third party modules, and more. Read on! / 13 July 2024
  • Page List Custom Children module
    This simple module gives you the ability to customize the parent/child relationship as it appears in the admin page list, enabling child pages to appear under more than one parent.
    Blog / 28 June 2024
  • Subscribe to weekly ProcessWire news

“…building with ProcessWire was a breeze, I really love all the flexibility the system provides. I can’t imagine using any other CMS in the future.” —Thomas Aull