StageBridge

WordPress staging, backups, sync, and Smart 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 staging changes without losing unrelated work added to your live site, 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
  • Use Smart Push to move staging changes without losing unrelated live-site work
  • Protect live WooCommerce orders, customers, stock, sessions, and payment settings
  • Create full, database-only, or files-only backups
  • Restore from saved backups with an optional safety backup before restore
  • Review previews, progress phases, and activity logs for long operations

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.

Smart Push

Pushes staging changes while keeping unrelated work added to your live site.

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 Smart 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 Smart Push. In simple terms: push staging changes without losing unrelated work added to your live site.

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 Smart Push 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.

WooCommerce Protection

When WooCommerce is active, Smart Push keeps live store activity on production while allowing unrelated tested staging changes to move live.

  • Protects orders, including HPOS order data
  • Protects customers, stock, carts, sessions, payment settings, webhooks, and scheduled actions
  • Allows non-conflicting product descriptions, prices, categories, tags, plugin updates, and theme changes to be pushed
  • Blocks staging email and WooCommerce webhook delivery and pauses Action Scheduler by default
Force Overwrite requires an additional confirmation before protected WooCommerce data can be replaced.

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/.

Known disposable log, scan, cache, and traffic tables are excluded by default, but you can include them manually. Automatic safety backups before sync, push, and restore remain enabled by default and can be turned off for a specific operation.

Use restore when you need to roll back from a saved backup. StageBridge restores a backup back to the environment it belongs to: production backups restore to production, and staging backups restore to staging. The restore confirmation modal names the target environment before you continue.

Before restore starts, StageBridge can create a full safety backup of the target environment. This checkbox is enabled by default, and the backup name includes the environment, such as Pre-Restore Production Safety Backup or Pre-Restore Staging Safety Backup.

During restore, StageBridge temporarily locks the target environment, restores large databases in resumable parts, and refreshes WordPress caches when restoration finishes.

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. Confirm the target environment shown in the modal.
  6. Leave the pre-restore safety backup enabled unless you already have a fresh backup and understand the risk.
  7. Wait for the restore process to finish.
  8. Review the final log summary.
  9. 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 resumable steps. It starts efficiently, slows down when the server pushes back, and resets retry attempts after successful progress. 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

Smart 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 Smart Push, keep the 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.