Last updated August 26, 2011. Created by sun on March 29, 2009.
Edited by latulipeblanche, alrueden. Log in to edit this page.

Configuring the WYSIWYG module is more complex than most, because the settings are in two locations:

  • WYSIWYG profiles are at www.yoursite.com/admin/settings/wysiwyg/profile (D7: admin/config/content/wysiwyg)
  • Input filters are at www.yoursite.com/admin/settings/filters (D7: admin/config/content/formats)

Adding an input filter

By default, there are two input filters: Filtered HTML and Full HTML. Additional filters can be added on the Input filters page. Input filters are not associated with a WYSIWYG editor by default, and are configured accordingly (i.e. URLs turn into links automatically and line breaks automatically become <br> or <p> tags). To associate an input filter with an editor, go to the WYSIWYG profiles page.

Setting up an editor profile

The WYSIWYG profile page contains instructions for downloading and installing various editors. Any editor can be associated with any input filter, but only one editor per input filter (switch editors by deleting a profile and picking a new one). Be aware that some editors do not enable any toolbar buttons by default. Choose "edit" to select exactly which toolbar buttons to make available.

WYSIWYG profiles

Editor default CSS: Makes the editor always look the same, no matter what Drupal theme you're using. Force cleanup on standard paste: Removes (or should remove) a lot of the goop from pasting from Word documents. The option for header and div tags is "HTML Block Format" (at least in TinyMCE)

Configuring input formats

On the Input formats page, choose which user roles to give permission to use each profile (for instance, restrict anonymous users to Filtered HTML, but allow Full HTML for administrators). By default, all users can use Filtered HTML. Check the input format configuration to make sure the tags are enabled for all the toolbar buttons you want available. Disable "line break converter," because the WYSIWYG editor will handle that. (See #352702: Required Drupal filter configuration not obvious for more on the line break converter.)

Better Formats module (http://drupal.org/project/better_formats): allows you to set default formats per user role, among other things.

Using input filters in combination

Each piece of content - for instance, a text area in a node - can only have one input filter applied to it. Users without permission to use the input format applied to a text area will not be able to edit that text area at all.

For example: Administrators are granted the Full HTML input format and Authenticated users Filtered HTML. Authenticated users will not be able to edit any content created with Full HTML. However, Administrators can use Filtered HTML to create content that Authenticated users can edit.

See #415808: How To Assign Editor Configuration by Role for more on conflicting input filters.

Looking for support? Visit the Drupal.org forums, or join #drupal-support in IRC.