KB Version:

Page Navigation

Related Links

Learning Levels

Most Read



file Files in Cascade Server are used to manage and publish the content and metadata of a wide variety of file types including but not limited to images, PDFs, JavaScript, CSS. Unlike Pages, Files are static in that their contents don't change based on the other assets in the system.

JPEG and PNG images are directly editable from within the system using the image editor. Plaintext files such as CSS, JavaScript, PHP are are also directly editable using the advanced editor. Only the metadata of other binary file types such as PDFs is editable. The contents of binary file types can be updated using the file upload field.


  • What file types does Cascade Server support?


Creating Files

Uploading a new File or Image in Cascade is simple:

  1. Select New -> Default -> File from the top navigation window to use the default asset factory. Your site may use different asset factories for creating specific file types.
  2. Specify the file's contents by dragging a file into the drop zone or by entering text directly in to the editor for text files.
  3. The filename will be automatically populated based on the uploaded file but can be overriden.
  4. Enter any metadata you want to associate with the file
  5. Click Submit to complete the file creation process.

Creating Multiple Files at once with the Zip Archive Tool

To upload a bunch of files at once, first zip up the files using your computer's native zip utility. Then go to Tools -> Zip Archive, select the Zip Archive you want to upload, and choose the folder in Cascade to place it in.

File Types Supported by Cascade

Cascade Server supports uploading of any file type. Asset Factories typically indicate the type of file being uploaded or created. Administrators may choose to edit the list of editable file extensions using the System Preferences. All files also have associated metadata.


  • Can I edit images managed by Cascade Server?
  • How are images handled in Cascade Server?


Uploading (Creating) Files in Cascade

Images, PDF documents, and text files are some common examples of files used in Cascade Server. Only text files and specific image files are editable inside the system.

To upload a new file:

  1. From the top navigation menu, select New -> Default -> File.
  2. Select the file to upload by clicking the file chooser icon or by dragging and dropping a file from the file system to the browser window.
  3. Optionally, update the name of the file in the System Name field.
  4. Choose the folder in which the file should reside by clicking the Folder Chooser icon. Navigate to and select the desired folder and click Submit.
  5. Check the Rewriting box to select whether or not to rewrite the text files as hyperlinks.
  6. Check the Indexing and Publish boxes to include this file when indexing and publishing. Indexing is used for sitemaps and other navigational features. The publishing feature allows the user to keep a content piece or file unpublished until checked.
  7. Check the Spell Check box to enable the spell check feature; in the case of a file, the Spell Check feature will check spelling for all metadata fields.
  8. Check the Workflow box in order to Bypass the Workflow process (leave it unchecked to ensure it does go through a workflow).
  9. Enter any Comments about the new file as necessary.
  10. Show the Metadata options and edit them as necessary.
  11. Click Submit to save your newly uploaded file.


Uploading Multiple Files at Once

Multiple images can be uploaded at a single time via the Zip archive importer as well as using SOAP-based web services.

Uploading Files By Importing a Zip Archive

An archive is a file that contains other files packaged together. There are many formats that are used to package files in such a manner, the most widely known are probably the ZIP file format (cross-platform) and the Stuffit file format (Mac only). There are many other archive file formats as well. An archive allows a computer user to organize and transfer files easily. For example, Cascade Server allows the user to upload a ZIP archive into the system and then unzip it. This is very useful when uploading content for integration: instead of uploading each HTML file and image individually using the File Override option, they can be packaged into one file, uploaded once, and then the system will unpack it as if each file were transferred individually.

To Upload a new Zip Archive:

1. Use the top navigation menu to go to: Tools -> Zip Archive.

upload zip form

2. Click Browse to select the Zip Archive you would like to upload 

3. Choose the Folder in which to place the Zip Archive.

4. Press Submit.

*Note - when creating and editing files (such as .css) in the system, the syntax-highlighting text editor will be on by default. If you'd like to turn it off, simply uncheck the "Advanced Editor" checkbox. For more information on which file-types are supported by this editor, see our syntax-highlighting text editor page.

Inserting files and images in Cascade


Insert WCMS-Managed Images Using the WYSIWYG Editor

You can insert an image that is located in one of the website directories (in the left asset tree) or one that is on the computer’s hard drive. If the image file is on the computer’s hard drive, it must first be uploaded to a website directory before being inserted into a page. Inserting the image into a page is done using the WYSIWYG editor.

insert image

To insert an image: 

  1. Locate the page in which you want to insert an image, and select Edit from the action bar.
  2. Once in the WYSIWYG editor, click your mouse where the image will be inserted so the cursor is visible.
  3. Click the Insert Image icon.
  4. Using the image chooser, locate the image within the folder where it resides.
  5. Preview the image and set its properties (see below).
  6. Click Submit to complete the insertion of the image into the page.
  7. Click Submit, in the WYSIWYG editor, to save the inserted image in the page.

Image Properties: (which can be accessed by simply right-clicking the image you’ve inserted) 

  • Image Location - This shows the directory and name of the image.
  • Alternate Text - This text will appear when a cursor rolls over an image.
  • Alignment - This will align the image within the WYSIWYG editor.
  • Border Thickness - This will adjust the thickness of the image’s border. 
  • Horizontal Padding - This gives the amount of space between the left and right sides of the content area and the image.
  • Vertical Padding - This gives the amount of space between the top and bottom sides of the content area and the image

Certain image properties, such as size, may be adjusted within the WYSIWYG itself. Simply click on the image and drag the border to shrink or enlarge. Please note, however, that this method of resizing will not alter the file size or resolution and therefore should only be reserved for minor adjustments.


Restricting Files using Asset Factory Plug-Ins

Restricting File Types With Asset Factories (File Limit Plug-In)

This plug-in allows administrators to place restrictions on the size and type of file created using a specific asset factory.

If a user, for example, creates or uploads a new file using an asset factory, this plug-in checks to see if the file extension is .doc and that the file size is no larger than 1MB. If either of these conditions are not satisfied, then the asset is not created and a message is displayed to the user explaining why.

To activate this plug-in: 

  1. In the Administration area select Asset Factories.
  2. Select a current asset factory, or create a new one by selecting “New Asset Factory”.
  3. On the “Plugins” tab, select “File Limit Plugin” from the “Add Plugin” drop down. Click the green plus sign to add the plug-in.
  4. Add one or both of the following parameters: 
        Size – Setting this value will require that files created by this asset factory not be larger than this size (in kilobytes).
        Filename Regex – Setting this value will require files created by this asset factory to match this regular expression.

Limiting File Names (Friendly File Name Plug-In)

This plug-in limits the system name of file assets to a-z, A-Z, 0-9 and underscores, periods, and hyphens. Because this plug-in is deprecated, we recommend using the file limit plugin in its place.

To activate this plug-in:  

  1. In the Administration area select Asset Factories.
  2. Select a current asset factory, or create a new one by selecting “New Asset Factory”.
  3. On the “Plugins” tab, select “Friendly File Plugin” from the “Add Plugin” drop down. Click the green plus sign to add the plug-in.

This plug-in takes no parameters.


Importing static files in Cascade

The integrate folder utility is a useful tool designed to import legacy content. More specifically, its function is to import the main content region of a page and specific metadata values into the Cascade Server database. If you look look at the example files located in our demo.zip file, you will see that a main content region has been notated with the following dreamweaver comment tags: <!-- #BeginEditable "main" --> and <!-- #EndEditable -->. As the Integrate Folder utility parses through the files, it will extract the content contained within this region and place it in the Cascade Server database. If no main content region has been specified, the Integrate Folder utility will import everything within the opening and closing <body> tags. In addition, the integrate folder utility will also extract the following metadata values: Display Name, Title, Summary, Teaser, Keywords, and Description. Once this process has finished the new template can be applied.

Cross-Site Relationships

For information on Cross-Site relationships for Files, check out our Cross-Site relationship rules page.



  • How does Document Management work?
  • How does Cascade Server import static files?

Related Links

Related Videos