You are here: Administrators Reference > Site Administration > Elements & Forms > Elements > Element Render Handlers > Add Render Handler
Add/Edit Render Handler

Access the Add Render Handler dialog from the Manage Elements dialog (see Defining Render Handlers), or from the Layout or Choose Layout dialogs for those Elements that support custom rendering. See Elements with Support for Custom Render Handlers. See also the Elements Reference for details on customizing layout for individual Elements.

For existing render handlers, this dialog displays in edit mode, as shown above, and contains the following fields:

Name - Required. Enter a unique name for the render handler.

Description - Optional. A text explanation of render handler function. Describe what the render handler does so that authors know which render handler to use. Text entered here displays in the Description column of the Element Render Handlers dialog.

Rendering Type - Required. Whether the render handler is written in ColdFusion or XSL. Controls whether the following Rendering Module field defaults to ColdFusion or XSL Transform modules for XSL files.

Rendering Module/ XSL Transform - Location of the render handler source-code module. Enter the path in the form shown above.


Existing Modules/Transforms: Default. A dropdown displaying a list of modules currently available in the CommonSpot /sitename/renderhandlers/ directory

Explicit Module/Transform: When selected, displays a text field for entering an explicit pointer to the module. Supply a valid path name.

Properties - A group of fields that define render handler attributes.

Display Menus - By default, Layout and Font & Color properties do not display as options for developers coding render handler modules. You can give developers the option of adjusting rendering based on these properties, or use Display Menus settings to provide additional options to authors with design privileges. If enabled, settings made through these options are passed to the render handler.

Preview Image: Displays an existing preview image with pathname. This image displays on mouseover for this render handler in the Manage Layouts dialog. Clicking Clear removes the current image. Clicking Select displays the Choose Image dialog for selecting or uploading a new preview image.


Related Links

You can download PDF versions of the Content Contributor's, Administrator's, and Elements Reference documents from the support section of (requires login).

For technical support: