Change site address
Use this after copying a site's database to a new domain, for example from https://staging.example.com to https://www.example.com. It changes every link and image address in the content to the new domain in one go.
| Screen | Route | Minimum role |
|---|---|---|
| Change site address | /admin/system/site-address | Administrator |
Open it from System → Maintenance → Change site address.
Used Import & export instead?
Then you don't need this page. An import already changes links to the old site to the site it runs on. See Moving from staging to live.
Moving a site by copying the database
- Copy the database to the live server (phpMyAdmin export and import, or
mysqldump). - Copy the
storage/app/publicfolder too. Uploaded images live there, not in the database. - Set
APP_URLin the live site's.envto the live address. Image addresses are built from it. The Change site address screen warns you if it does not match the address you opened the admin on. - Open System → Change site address. Enter the old address and the new one, and press Find matches.
- Check the counts, leave Back up the database first ticked, and press Change.
What it does
Find matches only counts. Nothing is written until you press the second button. You'll see something like "Posts — 38 records, 143 addresses" for each part of the site that has a match.
| Where | What is changed |
|---|---|
| Posts, pages, products | Content, excerpts, featured images, canonical URLs, schema data |
| Builder layouts | Published layouts, drafts, saved sections and layout history |
| Categories and tags | Descriptions and images |
| Menus | Custom links |
| SEO | Per-page overrides and redirect destinations |
| Settings and theme options | Logo links, footer links and the like |
| Comments | Links people left in comments |
How addresses are matched:
- Any scheme.
http://staging.example.com,https://staging.example.comand//staging.example.comare all changed to the new address, so a move is also a chance to fix mixed http/https links. - Only that site.
staging.example.com.auandstaging.example.communityare left alone. - Subfolders. If the site lived in one, include it in the old address, for example
http://localhost/radius. - http to https on the same domain also works. Enter the same domain with each scheme.
Encrypted settings, such as API keys, are never read or changed. Orders, payment records, logs and sessions are history and are left as they are.
Undoing it
With the backup option ticked, a database backup is written before anything changes. Download it from Updates & backups and import it with phpMyAdmin or mysql to put everything back.
Run it once
Moving into a subfolder of the same domain (from https://example.com to https://example.com/shop) and then running it again would change /shop to /shop/shop. Always check the counts on the preview before you press the button.

