PHPackages                             froala/craft-froala-wysiwyg - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating &amp; Views](/categories/templating)
4. /
5. froala/craft-froala-wysiwyg

ActiveCraft-plugin[Templating &amp; Views](/categories/templating)

froala/craft-froala-wysiwyg
===========================

Craft 3 CMS plugin for Froala WYSIWYG HTML Rich Text Editor.

5.2.0(1mo ago)1719.1k13[11 issues](https://github.com/froala/Craft-3-Froala-WYSIWYG/issues)[1 PRs](https://github.com/froala/Craft-3-Froala-WYSIWYG/pulls)MITPHPCI failing

Since Jun 27Pushed 1mo ago4 watchersCompare

[ Source](https://github.com/froala/Craft-3-Froala-WYSIWYG)[ Packagist](https://packagist.org/packages/froala/craft-froala-wysiwyg)[ Docs](https://github.com/froala/Craft-3-Froala-WYSIWYG)[ RSS](/packages/froala-craft-froala-wysiwyg/feed)WikiDiscussions develop Synced 3w ago

READMEChangelog (10)Dependencies (4)Versions (79)Used By (0)

Froala WYSIWYG editor for Craft CMS (v3)
========================================

[](#froala-wysiwyg-editor-for-craft-cms-v3)

The implementation of the Froala Editor (license not included) for Craft CMS (v3)

**[Check the Craft CMS v2 version here](https://github.com/froala/Craft-Froala-WYSIWYG/)**

[![Entry Field Example](screenshots/editor-on-entry.jpg "Entry Field Example")](screenshots/editor-on-entry.jpg)

Installation
------------

[](#installation)

You can install this plugin from the Plugin Store or with Composer.

#### From the Plugin Store

[](#from-the-plugin-store)

Go to the Plugin Store in your project's Control Panel and search for "Froala". Then click on the "Install" button in its modal window.

#### With Composer

[](#with-composer)

Open your terminal and run the following commands:

```
# go to the project directory
cd /path/to/my-project

# tell Composer to load the plugin
composer require froala/craft-froala-wysiwyg

# tell Craft to install the plugin
./craft install/plugin froala-editor
```

Known issue (help wanted!)
--------------------------

[](#known-issue-help-wanted)

Adding links to Craft Entries causing issues when you double click on the entry to link to. Just click once and use the "Select" button.

Sorry for the inconvience. We're working on these annoying issues. But we decided to release a new version because of some missing important other features (like saving links the Craft way).

Configuration
-------------

[](#configuration)

### Froala Configs

[](#froala-configs)

You can create custom configs that will be available to your Froala fields. They should be created as JSON files in your `config/froalaeditor/` folder.

For example, if you created a `config/froalaeditor/Simple.json` file with the following content:

```
{
  "toolbarButtons": [
    "bold", "italic", "underline", "strikeThrough", "formatOL", "formatUL", "insertHR", "|",
    "undo", "redo", "|", "paragraphFormat", "paragraphStyle", "|", "html"
  ],
  "paragraphFormat": {
    "N": "Normal",
    "H1": "Heading 1",
    "H2": "Heading 2",
    "H3": "Heading 3",
    "H4": "Heading 4"
  }
}
```

…then a "Simple" option would become available within the config section on your Froala field’s settings.

See the [Froala documentation](https://www.froala.com/wysiwyg-editor/docs/options) for a list of available config options and buttons.

Third party plugins
-------------------

[](#third-party-plugins)

```

```

### HTML Purifier Configs

[](#html-purifier-configs)

Froala fields use [HTML Purifier](http://htmlpurifier.org) to ensure that no malicious code makes it into its field values, to prevent XSS attacks and other vulnerabilities.

You can create custom HTML Purifier configs that will be available to your Froala fields. They should be created as JSON files in your `config/htmlpurifier/` folder.

Use this as a starting point, which is the default config that Froala fields use if no custom HTML Purifier config is selected:

```
{
    "Attr.AllowedFrameTargets": ["_blank"],
    "Attr.EnableID": true,
    "HTML.AllowedComments": ["pagebreak"]
}
```

(The [HTML.AllowedComments](http://htmlpurifier.org/live/configdoc/plain.html#HTML.AllowedComments) option is required for the `pagebreak` plugin.)

See the [HTML Purifier documentation](http://htmlpurifier.org/live/configdoc/plain.html) for a list of available config options.

Contributing
------------

[](#contributing)

If you have any issue regarding the editor itself, please report your issue on the [main repository](https://github.com/froala/wysiwyg-editor) itself.

You can raise an issue here if you have found a problem in the integration with Craft CMS v3.

If you already have fixed the bug yourself, please create a Pull Request (PR) and send us the fixes with a detailed description of the problem and the fix. Please PR your changes on our **develop branch**.

Any help will be appreciated. Many thanks.

License
-------

[](#license)

To enable the editor correctly, you should have a purchased a license on [www.froala.com](https://www.froala.com/wysiwyg-editor/pricing).

Once you have a license, for your domain, you can enter the license key in the plugin settings.

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance77

Regular maintenance activity

Popularity35

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 56% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Recently: every ~21 days

Total

74

Last Release

45d ago

Major Versions

2.9.5 → 3.1.02020-01-28

2.9.8 → 3.2.02020-07-22

3.2.7 → 4.0.02021-06-01

4.7.1 → 5.0.02026-01-15

v2.x-dev → v3.x-dev2026-05-13

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/637004?v=4)[Stefan Neculai](/maintainers/stefanneculai)[@stefanneculai](https://github.com/stefanneculai)

---

Top Contributors

[![harasunu-narayan](https://avatars.githubusercontent.com/u/60644555?v=4)](https://github.com/harasunu-narayan "harasunu-narayan (42 commits)")[![kapil2704](https://avatars.githubusercontent.com/u/47421622?v=4)](https://github.com/kapil2704 "kapil2704 (19 commits)")[![reganlawton](https://avatars.githubusercontent.com/u/2705875?v=4)](https://github.com/reganlawton "reganlawton (5 commits)")[![singhmonaaccolite](https://avatars.githubusercontent.com/u/46958934?v=4)](https://github.com/singhmonaaccolite "singhmonaaccolite (3 commits)")[![jiteshgupta1995](https://avatars.githubusercontent.com/u/17355509?v=4)](https://github.com/jiteshgupta1995 "jiteshgupta1995 (2 commits)")[![Zae](https://avatars.githubusercontent.com/u/96126?v=4)](https://github.com/Zae "Zae (1 commits)")[![froala-travis-bot](https://avatars.githubusercontent.com/u/96036514?v=4)](https://github.com/froala-travis-bot "froala-travis-bot (1 commits)")[![parull249](https://avatars.githubusercontent.com/u/103111355?v=4)](https://github.com/parull249 "parull249 (1 commits)")[![brandonkelly](https://avatars.githubusercontent.com/u/47792?v=4)](https://github.com/brandonkelly "brandonkelly (1 commits)")

---

Tags

craft-plugincraftcmsfroala-editorpluginwysiwyg-editorpluginwysiwygCraftcraftcmsfroalacraftcms-plugin

### Embed Badge

![Health badge](/badges/froala-craft-froala-wysiwyg/health.svg)

```
[![Health](https://phpackages.com/badges/froala-craft-froala-wysiwyg/health.svg)](https://phpackages.com/packages/froala-craft-froala-wysiwyg)
```

###  Alternatives

[marionnewlevant/twig-perversion

Making twig do things it really shouldn't

5466.0k1](/packages/marionnewlevant-twig-perversion)[wbrowar/guide

A CMS Guide for Craft CMS.

6154.6k1](/packages/wbrowar-guide)[verbb/footnotes

Adds a footnotes feature to CKEditor fields and Twig templates.

213.5k](/packages/verbb-footnotes)[verbb/color-mixer

A set of Twig filters for modifying colors.

1321.1k](/packages/verbb-color-mixer)[vierbeuter/craft-footnotes

Adds a footnotes feature to CKEditor fields and Twig templates.

212.7k](/packages/vierbeuter-craft-footnotes)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
