Update docs for Environment Sync and Export#1181
Open
jerico wants to merge 1 commit into
Open
Conversation
mikelittle
requested changes
Jun 2, 2026
| comprising your media uploads and any other assets your application stores there. | ||
| Environment syncing copies data from one environment to another in a single, automated operation. It handles the database | ||
| import, uploads copy, [URL search-replace](./search-replace.md), cache flush, and any | ||
| [post-sync steps](https://docs.altis-dxp.com/core/cli-command/#wp-altis-post-sync) automatically, without any manual intervention required. |
Contributor
There was a problem hiding this comment.
Rather than using absolute paths to other docs, you should use the docs://core/cli-dommand/#wp-altis-post-sync syntax. That way when reading from the WordPress dashboard it doesn't call out to the external site. It also means you can test links locally to new pages that are not published yet.
| 5. Click **Review Sync** and confirm to start. | ||
|
|
||
| You can also import your database and assets from one environment to another, via the Altis Dashboard. | ||
| Progress is shown in real time, with each step listed as it completes. If a step fails, the error is surfaced inline alongside |
Contributor
There was a problem hiding this comment.
Suggested change
| Progress is shown in real time, with each step listed as it completes. If a step fails, the error is surfaced inline alongside | |
| Progress is shown in real time, with each step listed as it completes. If a step fails, the error is shown inline alongside |
| **Note:** These features are designed with the idea that ‘code moves up, content moves down’. We do not recommend you migrate | ||
| content from non-production environments to production environments. Content should typically flow | ||
| from `production` -> `staging` -> `development` -> `test`, etc. | ||
| You can also create a new export of your database and/or assets. Typically, this will be your WordPress Uploads directory, |
Contributor
There was a problem hiding this comment.
It isn't clear that "this" means only the uploads directory. It reads like it means both.
Are there any other non-typical assets that could be downloaded? If not, perhaps we say "database and/or uploads folder". And we don't need this qualification at all.
| information: <https://developer.wordpress.org/cli/commands/search-replace>. | ||
| From the **Sync and Export** tab you can view and download previous exports, displayed as a list, ordered by date. | ||
|
|
||
| **Note:** These features are designed with the idea that ‘code moves up, content moves down’. We do not recommend you migrate |
Contributor
There was a problem hiding this comment.
Do we still want to keep this warning somewhere? The advice still applies.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
https://github.com/humanmade/product-dev/issues/1976