Exporting sites

The system allows you to export entire websites including their settings and related objects (such as page types, workflows, web parts, page templates, etc.) into a single file archive. You can then import the archive on any Kentico instance.

Exporting a site

  1. Open the Sites application.

  2. Click Export site () for the site you want to export. The Export wizard starts.

  3. Fill in the name of the export package and choose the object pre-selection type:

    Option

    Description

    File name

    Sets the name of the export package. The wizard creates a zip file containing the export data in the ~/CMSSiteUtils/Export folder.

    Preselect all objects

    Preselects all objects related to the site.

    Preselect objects changed after specific date

    Preselects all objects changed after the specified date.

    Use previous export settings

    Preselects objects based on the settings of a previous export.

    Tip: To clear the history of previous exports, open the Sites applications, click View export history among the header actions and delete the items on the History tab. Deleting export history items does not remove the corresponding packages from the file system.

    Select an option and click Next.

  4. Select which objects you want to export. The tree separates objects into categories according to the related functionality. These reflect the product categories to which the objects are related. The Website category contains objects related to the selected website. The Global objects category contains global objects that can be used by all sites. Selecting a category opens a set of check boxes in the right part of the screen, allowing you to select which objects will be exported.

    Note: The Pages of a website may require other objects to work correctly (for example the Page types of the site’s pages or shared Page templates). To ensure that the exported pages can be successfully imported, you need to include the required objects into the package.

    See the Export - Object selection settings section for details.

    Selecting objects for export

  5. After making all required selections, click Next to proceed. A log appears, showing you the export progress. You can abort the export by clicking Cancel at any time. When the export finishes, a message appears above the log, showing the file system path to the exported file along with a download link.

  6. (Optional) Click the download link at the top of the the log if you wish to immediately download the export package.

  7. Click Finish.

The system returns you to the Sites application. You can now copy the exported package into the ~/CMSSiteUtils/Import folder of the target installation of Kentico, and use the Import site or objects wizard described in Importing a site or objects.

Export - Object selection settings

The following options are available in the Object selection step of the Export wizard.

Select the root of the tree (All objects) to access the following general export settings:

Global selection

Load default selection

Preselects all objects based on your selection in Step 1 of the export wizard.

Select all objects

Selects all available objects.

Deselect all objects

Unselects all objects.

Export settings

Export tasks

If enabled, delete tasks (incremental deployment) will be included in the package.

Export files

Some database objects are linked with physical files stored on the file system inside the web project. If you check this option, such files will be exported along with the corresponding database objects.

Export global folders

If enabled, all files under the following folders will be added to the export package:

  • ~/App_Code/Global/
  • ~/CMSGlobalFiles/
  • ~/CMSScripts/Custom/
  • ~/App_Code/Controllers/
  • ~/Controllers/Global/
  • ~/Views/Global/
  • ~/Models/Global/

Export custom assembly files

If enabled, custom assembly files (dlls) that store the classes of certain custom objects will be exported together with the given objects. Applies to notification gateways, translation services, payment options, integration connectors, scheduled tasks, advanced workflow actions, marketing automation actions and smart search analyzers.

The system considers assemblies as custom if their name does not start with the CMS. prefix.

Export site folders

This option is only available when exporting websites, not just separate objects. If enabled, all files under the following site-related folders will be added to the export package:

  • ~/App_Code/<site code name>/
  • ~/App_Data/<site code name>/
  • ~/<site code name>/
  • ~/Controllers/<site code name>/
  • ~/Views/<site code name>/
  • ~/Models/<site code name>/

Export ASPX templates folder

If enabled, the folder with ASPX page templates will be exported:

  • ~/CMSTemplates/

Export forum custom layouts folder

If enabled, the folder with custom forum layouts will be exported:

  • ~/CMSModules/Forums/Controls/Layouts/Custom/

The following categories contain extra options to be set:

Custom tables

Export custom table data

If checked, custom table records (the actual data stored in the tables) will be exported along with the selected custom tables.

Pages

Export pages

If checked, pages will be exported

Export page histories

If checked, histories of all exported pages will be exported.

Export page relationships

If checked, relationships of all exported pages will be exported.

Export page level permissions

If checked, page security settings made in the Pages application will be exported.

Export blog comments

If checked, blog comments will be exported.

Export event attendees

If checked, event attendees will be exported for all exported events.

Forms

Export forms data

If checked, stored forms’ data will be exported together with the exported forms.

Export physical files

If checked, physical files saved within form records (if there are some) will also be imported.

Forums

Export forum posts

If checked, forum posts will be exported together with the exported forums.

Message boards

Export board messages

If checked, board messages will be exported together with particular message boards.

Media libraries

Export media files

If checked, media files stored in the database will be exported.

Export physical files

If checked, physical media files stored in the file system will be exported. This option is not selected by default as it may cause the package size grow extremely large; instead, it is recommended to export these files manually.

If you have the Log export tasks setting enabled in Settings -> Versioning & Synchronization -> Staging, a list of object deletion tasks may be displayed at the bottom of the list. If you leave the boxes checked, the objects will be deleted after you import the package on the target server.