Exclude Images, Documents, Media, and PreBuilt directories from publish

Product: CMS

Version: CMS 8, CMS 9

Published: July 20, 2010

Last updated: 7/12/2022



When a publish occurs, there are a number of directories that get copied from the site's xml folder to the publishing target folder. Images, Media, Prebuilt, and Documents folder are examples.  If a directory is set to be excluded from publish, it will not be copied to the publishing target folder during a publish.


If the file size of one of these directories becomes too large, CMS users may experience slower overall publish times when these directories are copied from the xml folder to the publishing target folder.


V7.0 or below: Excluding directories from publish requires Administrative rights to the Design-Time server as well as the ability to modify the registry.

V7.5+: Administrative access to the CMS instance.


V7.0 or below:
  1. Click Start -> Run.  From the run line command prompt type in 'regedit'.
  2. In the Registry Editor, navigate to the following location
    1. On a 32-bit version of Windows Server: HKEY_LOCAL_MACHINE/SOFTWARE/Ingeniux/CMS/
    2. On a 64-bit version of Windows Server: HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/Ingeniux/CMS/
  3. Double click the MediaServerDirectories key.
  4. For the value data field, enter the name of the directory you would like to exclude.  If you would like to exclude more than one directory, use a comma as a separator.

Media Server Directories

  1. Log in to the CMS.
  2. Select the Administration Ribbon.
  3. Select System Options.
  4. Select and expand the Publishing entry.
  5. Select Media Server Directory.
  6. Select the New button.
  7. Enter the Media Server directory name (e.g. Images, Documents, Media, or Prebuilt).
  8. Press Enter.
  9. Repeat steps 6 - 8 for any additional media server directories that you would like to add.
  10. Select the Save button.

Media Server Directory Configuration

    Additional Information

    Please note that all Design-Time sites on the server will be affected by this change. It is currently not possible to exclude Media Server Directories on a per-site basis.

    V7.0 or below: once the registry has been updated, IIS will need to be restarted for the changes to take effect.  Please be sure that all users are logged out of the CMS and that the CMS is not currently performing any tasks prior to restarting IIS.

    It is also important to note that since any excluded directories will not be copied to the publishing target folder, you will need to create separate static PeerSync jobs to replicate the folder content to the run time server. 


    Please login to comment


    There are no comments yet.