StageBridge

WordPress staging, backups, sync, and safe push.

Create a staging copy of your site, test changes safely, and push approved work back to production with backups and conflict-aware protection.

Best For
  • Testing plugin and theme updates
  • Safely preparing site changes
  • Maintaining client sites
  • Backing up before risky operations

Overview

StageBridge helps you create and manage a staging copy of your WordPress site from inside the WordPress dashboard. You can clone production to staging, sync production changes into staging, push approved staging changes back to production, and create backups before important operations.

  • Create staging in a subfolder such as /staging/
  • Use staging on a subdomain such as staging.example.com
  • Pull production changes into staging
  • Push staging changes back to production
  • Create full, database-only, or files-only backups
  • Restore from saved backups
  • Use safe push to reduce accidental overwrites

Core Terms

Production

Your live public website. This is the site your visitors use.

Staging

A private working copy of your website where you can test changes before publishing them.

Clone

Creates the staging site from production.

Sync

Pulls newer production changes into staging.

Push

Sends tested staging changes back to production.

Safe Push

The default push mode that tries to preserve production changes made since the last clone, sync, or push.

Recommended Workflow

  1. Create a staging site.
  2. Sync staging from production if production has changed recently.
  3. Update plugins, themes, or content on staging.
  4. Test the staging site carefully.
  5. Push staging to production using safe push.
  6. Review the completion log after the operation finishes.
If multiple people work on production, sync before starting staging work and avoid force overwrite unless you are sure staging should replace production.

Creating a Staging Site

Go to StageBridge > Dashboard and click Create Staging.

You can choose subfolder staging, such as example.com/staging, or subdomain staging, such as staging.example.com.

For subdomain staging, create the subdomain in your hosting panel first and point the subdomain document root to the staging folder configured in StageBridge.

Steps to create staging

  1. Open StageBridge > Dashboard.
  2. Click Create Staging.
  3. Choose Subfolder or Subdomain.
  4. Enter the staging folder or subdomain details.
  5. Review included files and database options if available.
  6. Start the clone process.
  7. Wait for the progress modal to finish.
  8. Use Switch to Staging to open the new staging environment.

Syncing Production to Staging

Use sync when production has newer changes that should be copied into staging.

Sync can update selected files, selected database data, generated frontend files where supported, and staging metadata or configuration.

StageBridge compares changes so it can avoid copying unchanged files where possible.

Steps to sync production to staging

  1. Open StageBridge > Dashboard.
  2. Make sure the staging site already exists.
  3. Click Pull from Production or the sync button.
  4. Review the preview if you want to inspect changes first.
  5. Keep the safety backup option enabled unless you already have a fresh backup.
  6. Start the sync.
  7. Watch the progress phases and activity log.
  8. Open staging and confirm the expected content, plugins, themes, and frontend assets are present.

Pushing Staging to Production

Use push when staging changes are tested and ready for production.

By default, StageBridge uses safe push behavior. This means it tries to avoid overwriting production changes made since the last clone, sync, or push.

Before push begins, StageBridge can create a safety backup. This option is enabled by default, but you can turn it off for a specific operation if you recently took a backup and understand the risk.

Steps to push staging to production

  1. Test the staging site carefully before pushing.
  2. Open StageBridge > Dashboard from the staging side when possible.
  3. Click Push to Production.
  4. Decide whether to push files, database data, or both.
  5. Leave safe push behavior in place unless staging must fully replace production.
  6. Keep the safety backup option enabled unless you intentionally want to skip it.
  7. Review the preview if you want to inspect file or database changes first.
  8. Start the push and wait for the operation to complete.
  9. Review the final log summary before refreshing.
  10. Check the live production site and admin area after the push.

Force Overwrite

Force overwrite is an explicit push option. Use it only when you are sure staging should replace matching production data and files.

Force overwrite should not be used casually on active sites where content changes may be happening on production.

Backups and Restore

StageBridge can create full backups, database-only backups, and files-only backups. Full and file backups are compressed when the server supports the required ZIP functionality.

Backups are stored on your server under wp-content/uploads/stagebridge/.

Use restore when you need to roll back from a saved backup. A database-only backup restores database data, while a full backup includes both database and files.

Steps to create a backup

  1. Open StageBridge > Backups or use the backup button from the dashboard.
  2. Choose the backup type: full, database-only, or files-only.
  3. Start the backup.
  4. Wait for the compression and save phases to complete.
  5. Confirm that the new backup appears in the backup list.

Steps to restore a backup

  1. Open StageBridge > Backups.
  2. Find the backup you want to restore.
  3. Confirm whether it is a full, files-only, or database-only backup.
  4. Click Restore.
  5. Wait for the restore process to finish.
  6. Review the final log summary.
  7. Check the site frontend and admin after the restore.

File Exclusions

StageBridge excludes common files and folders that usually should not be copied into staging or backups, such as cache folders, backup folders, archive files, log files, and non-WordPress folders at the site root.

*.log
*.zip
*.gz
cache
backups
Use exclusions carefully. Excluding a real plugin, theme, upload folder, or important custom folder can cause staging to be incomplete.

Large Sites and Server Limits

Large sites can be limited by hosting resources such as CPU, memory, disk speed, disk space, request timeout limits, firewall rules, and file count or inode limits.

StageBridge runs long operations in steps and can retry temporary server errors. If your host still returns repeated 500 or 503 errors, reduce the batch size or increase retry attempts in StageBridge settings.

Subfolder vs Subdomain Staging

Subfolder

Example: example.com/staging. Subfolder staging is simple and works on many hosts without creating DNS records.

Subdomain

Example: staging.example.com. Subdomain staging may be better when premium plugins or services recognize staging subdomains differently from subfolders.

Troubleshooting

Staging looks broken after cloning

Try syncing production to staging. If generated CSS or frontend assets are missing, check whether a cache, optimization, page builder, or security plugin generated files after the clone started. Also confirm that custom exclusions are not excluding important folders.

Push or sync fails with a server error

Check the live log. If the error is temporary, StageBridge may retry automatically. If errors continue, reduce batch size or increase retry attempts in settings.

Production changes were not pushed

Safe push may have detected conflicts and preserved production data. Review the operation log. If you intentionally want staging to replace production, use force overwrite with care.

Subdomain staging does not load

Confirm that the subdomain exists in your hosting panel, points to the correct staging folder, and has a valid SSL certificate if using HTTPS.

Frequently Asked Questions

Does StageBridge send my data to an external service?

No. StageBridge runs inside your WordPress site and does not send your site data to an external service.

Should I take a backup before pushing?

Yes. Safety backups are enabled by default for push and sync operations. You can turn the option off for a specific operation, but only do this when you already have a recent backup and understand the risk.

Can StageBridge create DNS records or hosting subdomains?

No. Create subdomains in your hosting account first, then configure StageBridge to use that staging URL.

What is the safest way to push changes?

Use safe push, keep safety backup enabled, review the preview and logs, and avoid force overwrite unless you are certain staging should replace production.

Support

If you need help, include your WordPress version, PHP version, StageBridge version, staging type, the operation you were running, and relevant StageBridge activity log lines.

You can submit support requests on the official WordPress.org support forum: wordpress.org/support/plugin/stagebridge/

Do not publicly share passwords, database credentials, private keys, or full backup files.