Which content and settings are synced

SiteSync helps you keep the content between your environments up to date and in sync, without risking any content loss, broken parent-child hierarchy, or other potential issues on your Live environment. When promoting content, you can decide whether to sync the entire site or do a selective sync of individual pages, content items, and templates and what content to exclude from syncing.

Content in Sitefinity CMS comes in many forms, such as text, media, or content fields. Content can be contained in pages and displayed by widgets. In addition, depending on its hierarchical structure, content can be organized and classified via taxonomies and tags. And last, but not least, website content has settings that define its usage and structure, such as permissions and search indexes.

You can select to promote all content items of the News content type or make a more granular selection of which specific News items with what classification to promote. If you have dynamic content, you may also want to promote the site settings, for example, the dynamic module’s custom fields and structure or assignment of users and roles.

The following sections describe in detail what content you can sync. For a list of what data and content you cannot sync, see Limitations to promoting data via SiteSync.

Content

The following table lists what content you can promote from source to target environments.

Promoted content

Description

Dependencies (selective sync and others)

Built-in content types

  • News
  • Blogs and Blog posts
  • Lists and List items
  • Events and Calendars
  • Shared content blocks
  • Forms

    NOTE: You can promote form definitions only, that is, forms structure.

 

Media content and libraries

  • Documents and Document libraries
  • Images and Image libraries
  • Videos and Video libraries

When promoting Sitefinity CMS media content items, for example images, that are stored on an external blob storage provider, SiteSync updates only the content item properties (such as UrlName, Title). For more information, see Considerations when using SiteSync.

Dynamic content

You can choose to synchronize the structure of the module, or both the structure and its data. The structure of the module includes creating any new fields and dynamic module types, editing them or changing the hierarchy.

NOTE: To promote the content of a new dynamic module, you need to sync not only its content, but also its structure.

Dynamic items » module structure

Dynamic items with media fields » corresponding media item

Hierarchical dynamic item » parents

For the new Dynamic module content to be promoted to the destination environment, you need to sync not only its content, but also the Dynamic module structure.

Related data

Related content or media

 

Some types of content may be dependent on each other. If you decide to promote only certain types of content (or selected items from that content type), you must ensure you respect the content relations. For example, if you add a related data field of type Images to a content type, you must promote not only the items of this content type, but Images as well.

Custom fields

Site Sync promotes only the custom fields of dynamic modules and only when you select this option explicitly. For more information see SiteSync advanced settings.

 

Pages

Pages are synchronized together with their personalized versions, if any.

Pages » page templates

Pages » widget templates

Pages » segments for personalized versions

Hierarchical content

SiteSync promotes hierarchical content types and persists the dependencies. For example, if you sync blog posts, the parent Blog will also be synced.

Parent is always synced, even if you do not explicitly select it.

IMPORTANT: You cannot explicitly select to sync only the children of a hierarchical taxonomy, without the parent taxonomy itself.

Personalized content

Promote user segments, so that synchronization of personalized pages is enabled.

 

Multilingual content

If you are using more than one language, you can select to sync items in a particular language only.

 

Content organization

Classifications (including Tags, Categories, Departments, and so on)

 

Classifications for content modules are automatically synced, even if not explicitly selected.

If you add a custom field of type classification to a content type, you must take care of synchronizing the configurations and data structure first, and then promote the content and its classifications. For more information see Which content and settings are synced and Best practices: Difference between SiteSync and Export / Import.

 

 

For all selected items types, you can use selective sync. For more information, see Promote content with SiteSync.

NOTE: The last modified date attribute is calculated automatically by the Sitefinity CMS ORM when the record is inserted into the database. That is why on the source and on the target servers there may be different values for the last modified date.

Templates and widgets

By default, the SiteSync promotes data that is stored in the DB. This includes page and widget templates, as well. Keep in mind that you need to manually copy (for example, via deployment) any resources used on your website located on the File system, such as MVC templates or mapped WebForms templates, to the destination environment File system.

Revision history

The SiteSync module syncs the revision history of content items and pages.

All versions are synced, together with the user that modified the item and created the respective version.

NOTE: If the user who modified a version in the release history does not exist on the target environment, when the item is synced, this user will appear in the revision history as USER NOT FOUND.

Permissions

By default, SiteSync promotes content along with its permissions. If you need to have different permissions on the source and destination environment, see SiteSync advanced settings.

Site properties

In case you created a new site on the source environment, you can use SiteSync to promote the site, its properties to the destination environment. This includes:

  • Site properties, such as site name and domain URL, and languages.
  • Configured modules
    This list includes all modules, enabled for this site. This includes the provider settings.

    NOTE: Keep in mind that module content is synced separately by selecting it from the list of content types. The Configured modules list only contains the module settings for this site.

Sitefinity CMS settings

You can promote the following Sitefinity CMS settings to the destination environment:

  • Basic and advanced settings
    Using this option will promote any configuration changes you have made on the source environment to destination. For more information see Which content and settings are synced.

    NOTE: Using this option will override the configurations on the destination environment. If you are using Continuous Delivery process, we recommend that you do not use this option but use config transformation instead.

  • Interface labels and messages
    This option lets you promote changes you made to your Sitefinity CMS website labels and messages. For more information see Backend languages and labels.
  • Search indexes
    SiteSync enables you to promote the search index definitions from the source environment. Once the definitions are promoted to destination, Sitefinity CMS runs a reindex operation to generate the search index files for your destination environment content.

What content and data cannot be synced

  • Custom fields for built-in modules
    By design, built-in modules custom fields created on the source destination are not synced to the destination environment. SiteSync promotes only the custom fields of dynamic modules and only when you select this option explicitly. For more information see Setup SiteSync.

    NOTE: When you add custom fields to content modules, this results in both configurations and DB changes. Thus, after such changes, you need to use the import/export functionality or manually sync the DB and configurations to use SiteSync properly. For more information, see Best practices: Difference between SiteSync and Export / Import.

  • File system content
    Content that is not in the database, such as themes, MVC templates and master pages.
    For more information, see Overview: Page templates.

    NOTE: You can, however, synchronize library content that is stored in the File system storage.

  • Backend pages
  • Feeds
  • Workflow definitions
  • Responsive design settings
  • Email campaigns

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?