Staging allows you to easily transfer changes made to pages or objects from one Kentico instance to another Kentico instance (typically hosted on a different server). You can also perform complete synchronization of all pages and objects. All connected instances must use the same version of Kentico. Staging is particularly useful if you need to synchronize multiple environments during development, for example:
Development -> Testing -> Editing (staging) -> Live (production)
All pages stored in the content tree of websites can be synchronized. However, not all objects in Kentico support synchronization. Make sure you read through the What can be synchronized section for more information.
Setting up staging
Configuring content staging - to allow synchronization, you need to configure the Kentico instances that you wish to connect.
Bi-directional content staging - explains how to configure servers to be both target and source servers at the same time. Allows transferring of changes in both directions.
Using X.509 authentication - learn how to secure the staging service using X.509 certificates.
Content staging security - learn about the permissions that roles need to perform synchronization actions.
Troubleshooting staging - check for solutions to problems that can occur when using staging.
Synchronizing the content - explains how to transfer synchronization tasks to other servers.
Automatic content synchronization - set up the system to perform synchronization automatically.
Exporting and importing sites - you can also manually transfer your content to other instances of Kentico using the export and import features.
What can be synchronized
Content staging supports synchronization of the following data:
- Page data - pages in the website content tree.
- Pages need to be on the same place in the content tree on both the source and target servers.
- Timeout defined for pages that are part of a workflow is not synchronized for consistency reasons.
- Page file attachments - if a page contains attachments or file fields, the files are synchronized together with the page.
- Page relationships - relationships between pages are synchronized if the relationship type and both pages exist on the target server. Synchronization is NOT supported for relationships between pages on different sites.
- Workflow process - only published page versions are synchronized to the target server and both servers need to have the same workflow schemas defined.
- Email feeds - when staging email feeds, we recommend setting the staging of child and binding objects to incremental to avoid overwriting individual email issues and their statistics.
- Custom tables and their data.
- Media libraries and the files and folders in them.
- ACLs (page-level permissions)
- Global objects - all global objects with the exceptions listed below.
Content staging does not support synchronization of the following data:
- Abuse reports
- Blog comments (blogs and blog posts are synchronized as pages)
- Booking event attendees
- Contacts (the state of contacts in automation processes is also not synchronized)
- Content notification subscriptions
- Custom modules
- Event log
- Export history
- Form data (the actual form objects are synchronized)
- Forum posts (forum objects are synchronized)
- Message board messages (message board objects are synchronized)
- Personal messages
- Sites (the global objects holding the properties of sites in the system)
- Web farm servers
- Web templates
- Object data fields that store various types of live site data or statistics (e.g. the status and statistics of campaigns)
- Physical files associated with global objects (for example web part source file, form control files, ASPX page template files)
- Files associated with CSS stylesheets (files managed on the Theme tab when editing stylesheets)
- Database views and stored procedures managed through the Database objects application
- Object code stored and edited in physical files via deployment mode or source control mode
- On source servers, staging tasks are generated only if you edit code in the Kentico UI or after you synchronize changes from files into the database.
- On target servers, staging tasks do not update object code if deployment or source control mode is enabled.
When you stage an object, the synchronization also includes all child objects and bindings (relationships with other objects) in most cases.
For example: A role is not assigned to any users in the development environment, but to 100 users on the target production server. If you synchronize the role object through staging, the users are removed from the role on the target server.
To avoid potential problems, we strongly recommend having mirrored content and consistent objects on all staging servers whenever possible. Developers can also customize the staging of child and binding objects to adjust the behavior according to your environment's requirements.
Staging and ID values
Content staging cannot ensure that objects and pages have the same ID values after being transferred to a different environment. However, the synchronization process preserves GUID values. Use GUID fields if you need to identify pages or objects across multiple staging environments.