Filtering and Formatting Content

You can use filters and macros to make text changes to text at run time. Use the Admin Console to turn these changes on or off, or to change the settings that control how they work.

Each component type has a different role. Here's how they work in general:

Configuring Filters and Macros

The Filters and Macros page lists the filters and macros installed for the selected space. By default, each space inherits the set of filters and macros from the global configuration defined in the root space. However, the list isn't shown for sub-spaces until you choose to copy them. When you click the Copy Global Filters button on the Filters and Macros page for a subspace, the application copies the list and configuration to the page. If you want to edit the list for a sub-space, you'll need to click the button first.

Fastpath: Admin Console: Spaces > Settings > Filters and Macros

Pre-Processing Filters

Pre-processing filters are the very first filters to operate on your content. They are performed on the initial version of the content before all other macros and filters have done their work to generate content. For example, the HTML filter should be executed before any other macros or filters because otherwise it would strip out the HTML content that the other macros and filters introduce.

By default, there are no editable pre-processing filters.

Macros

A macro operates on, or adds, a specific part of content. For example, a macro could format a link or embed a window to display video.

In the list, you'll see all of the macros installed on the system. Many of these, including macros whose functionality is tightly integrated into the content editor toolbar, are not available to be disabled. Those you can disable or delete are generally macros installed as separate components, such as in plugins.

Filters

Filters -- you can think of them as mid-processing filters -- operate on text after macros have executed, but before post-processing filters have done their work. By default, the application doesn't include any editable filters.

Post Processing Filters

Post-processing filters provide a final sweep of content before it's seen by other people. This is where you catch whatever is in the text, including whatever might have been added by other filters or macros. One of the most important filters you can enable is the profanity filter.