Installing JEditor is as simple as installing any Jira add-on/app. To install JEditor, do the following:
- Go to Jira administration > Find new add-ons
- Search the marketplace for JEditor
- Click the Free Trial button to get an evaluation license and install the add-on.
Sometimes you may be asked by our support to install a JEditor build manually. To do so, navigate to Jira administration > Manage add-ons and click the Upload add-on link.
JEditor can be enabled on a per-field basis for any multi-line text field (like description or comment), including custom fields. After installing JEditor, you won't see any immediate changes in your Jira fields.
Do the following to enable JEditor for a particular field:
- Navigate to Jira administration > Issues
- Select Fields > Field Configurations to view all your field configurations
- Locate the field configuration of interest and click the Configure link to open the View Field Configuration page, which lists all system and custom fields in your Jira installation for that field configuration
- Click the Renderers link for the field you want to change. This will take you to a page where you will have the option to select a renderer from all configured and available renderers
- This page will warn you if there are issues that will be affected by the change. If no issues are affected, then the warning does not show. From this page, choose the JEditor Renderer and click Update
JEditor properly renders existing fields that contain wiki markup (created using wiki renderer or Jira RTE).
You can evaluate JEditor in your testing environment or your production Jira.
If you want to evaluate JEditor in your production Jira - it's safe to do so. Create a test project with a separate field configuration and enable JEditor only for the fields in that field configuration.
JEditor comes pre-configured with some default Templates, Styles, ready Toolbar configuration. To change the configuration, navigate to Jira administration > JEditor Configuration. Below is the short review of the sections in JEditor Configuration:
- Settings. On this tab, you will find settings related to JEditor's UI/UX, renderer settings, upload parameters.
If you just installed JEditor, you may want to enable the Attach Uploads param, switch the Image Links param to Native Links and enable the Require Auth param.
You can also configure the default height of the editor or enable the Autogrow mode.
- Toolbar. On this tab, you can change the toolbar configuration: enable or disable the toolbar buttons, change the number of rows on the toolbar or change the order of the buttons. For more information about this tab, see Toolbar and bottom bar.
- Templates. On this tab, you can manage HTML templates that users can insert using the Template button on the toolbar. For more information, see Templates and prepopulation.
- Prepopulation. On this tab, you can configure field prepopulation schemes. JEditor can automatically populate any multi-line field on the Create Issue screen with a pre-defined template. For more information, see Templates and prepopulation.
- Prepopulation for SD. On this tab, you can configure templates that will pre-populate the Description field on customer portals.
- Custom Styles. On this tab, you can add custom CSS code to Jira pages as well as configure the Styles dropdown list. For more information, see Custom Styles/CSS.
- Replace. On this tab, you can configure JEditor Renderer's replace rules. These rules are executed during page load and allow to replace any text (it's possible to use regular expressions) in any JEditor-rendered field. For more information, see Replace With.
- Syntax Highlight. On this tab, you can configure some options for JEditor's code highlighter. It's possible to collapse all code snippets by default and hide/show line numbers.
If you are currently evaluating JEditor, you probably want to know if JEditor is better than Jira's RTE (built-in default editor) and why. That's a tricky question. The answer is yes, and no.
Yes, JEditor is much more capable compared to the Jira's RTE. JEditor has more features, and it allows advanced formatting. Only using JEditor users can copy-paste from documents/emails/corporate portals without losing formatting.
However, JEditor is based on HTML formatting, and it has its drawbacks. HTML formatting is more verbose compared to wiki markup (more substantial volumes of data to store in the DB).
The right answer is: JEditor should co-exist with Jira's RTE, not completely replace it. Every Jira needs JEditor to help users when they need to do something the default editor is not capable of:
However, enabling JEditor for all possible fields in Jira is probably overkill. Jira RTE works great for regular comments and most descriptions, especially in R&D projects. Such projects may benefit from having JEditor in a custom field and using it on a when-needed basis.
At the same time, projects that serve as hubs for administrative tasks (where users work with documents a lot) may need JEditor in the Description field.
JEditor uses HTML formatting of data instead of wiki markup. This helps JEditor to support a wide range of formatting options and allows end-users to copy data from various sources such as documents, emails, web pages. However, some Jira notification templates are explicitly designed for wiki markup/plain text, and you will need to update those velocity templates adding HTML support.
If your Jira notification emails start coming with HTML tags, see Jira notification email contain HTML tags.
JEditor for Jira Service Desk (Customer Portal)
If you use Jira Service Desk, you may want to enable JEditor in certain fields on the customer portals.
JEditor for SD supports rich text formatting, including tables, lists, links, inline images, text coloring, headings. It also supports pasting data from various sources, including:
- PDF documents
- Word/Excel documents
JEditor for Service Desk supports the following request fields:
- Multi-line text custom fields
To enable JEditor for SD, do the following:
- Navigate to Jira administration > Apps
- In the left navigation panel, select JEditor for SD > Field Schemes
- Create a field scheme for each field where you want JEditor
For more details on how to configure JEditor for Service Desk, see Configuring JEditor for Service Desk.
JEditor can import your HTML formatted emails, creating new Jira issues or comments. To enable the mail handler, do the following:
- Navigate to Jira administration > System > Incoming Mail
- Click the Add incoming mail handler button
- Select the JEditor Rich Text Mail Handler (create or comment)
- Follow the dialog to configure the mail handler
Please note that JEditor's mail handler has limited functionality. It does a great job importing HTML-formatted emails. However, if you need more features, you may want to try apps that specialize in importing emails: