Oxygen Builder is a powerful WordPress site builder, but its data structure differs from traditional WordPress themes and page builders. This can cause issues when migrating a site, as standard WordPress search and replace tools (such as WP-CLI commands or plugins like Better Search Replace) do not work effectively with Oxygen’s data storage format.
If you’ve recently migrated an Oxygen Builder site and are experiencing issues such as broken layouts, missing images, or styling problems, follow the steps below to resolve them.
Common Issues After Migration #
- Broken page layouts
- Missing images or incorrect URLs
- CSS styles not loading correctly
- Shortcodes appearing as text instead of rendering correctly
- Slow website performance due to caching conflicts
Pre-Troubleshooting Step: Take a Backup #
Before making any changes, it is highly recommended to take a complete backup of your website to prevent data loss. You can use:
Steps to Fix Oxygen Builder Issues After Migration #
Once your backup is complete, follow these steps:
1. Resave Permalinks #
Incorrect permalinks may cause pages to return 404 errors or break links.
- Log into your WordPress dashboard.
- Go to Settings → Permalinks.
- Click Save Changes (you do not need to modify anything).
2. Re-sign Shortcodes #
Oxygen Builder uses signed shortcodes for security reasons. These signatures may become invalid after migration.
- Navigate to Oxygen → Settings → Security.
- Click Re-sign all shortcodes.
- Wait for the process to complete.
3. Regenerate CSS Cache #
Oxygen Builder caches CSS files, which can cause styling issues post-migration.
- Go to Oxygen → Settings → CSS Cache.
- Click Regenerate CSS Cache.
- Clear your website’s cache if applicable (server cache, plugin cache, or CDN cache).
Additional Steps #
If the above steps do not resolve the issue, consider the following:
Clear Website and Server Cache #
Check Database for Serialized Data Issues #
Check for Plugin Conflicts #
Automating This Process in the Future #
Currently, there are no WP-CLI commands available for automating the Re-sign Shortcodes and Regenerate CSS Cache processes. However, a feature request has been made to Oxygen Builder developers. You can track its progress or contribute support here: GitHub Feature Request
If Oxygen releases WP-CLI commands for these actions in the future,xCloud will be able to automate the process, making site migrations smoother
By following these troubleshooting steps, you can resolve post-migration issues with Oxygen Builder and restore your website’s full functionality. Always take a backup before making changes and clear your cache after implementing fixes. If you continue to face issues, consider reaching out to the Oxygen Builder support community or your hosting provider.
If you are still experiencing issues after following these steps, contact our support team or seek help from Oxygen Builder’s official documentation and community forums.
