Custom Editor Toolbar Documentation

CKEditor 4 toolbar is highly flexible and can be easily adjusted to your needs. You can influence such toolbar aspects as:

The number of buttons available to your users.
How the available buttons are grouped.
The sequence of groups in the toolbar.
The sequence of buttons within a group.
The number of toolbar rows.

The most recommended approach to adjusting the editor to your needs is to start from creating a custom build, removing unwanted features before they even make it to your toolbar. It is a bad practice to download the Full package and then remove plugins or buttons in your configuration. You will only be loading unnecessary stuff without any good reason.

Toolbar Configuration

The simplest way to configure the toolbar is to use the dedicated toolbar configurator that is available in each editor installation package starting from CKEditor 4.5. The editor instance below was configured by using the accessible "toolbar groups" approach, with some unwanted buttons removed by setting the config.removeButtons configuration option.

<h1><img alt="Saturn V carrying Apollo 11" src="assets/sample.jpg" style="float:right" /> Apollo 11</h1>

<p><strong>Apollo 11</strong> was the spaceflight that landed the first humans, Americans <a href="http://en.wikipedia.org/wiki/Neil_Armstrong">Neil Armstrong</a> and <a href="http://en.wikipedia.org/wiki/Buzz_Aldrin">Buzz Aldrin</a>, on the Moon on July 20, 1969, at 20:18 UTC. Armstrong became the first to step onto the lunar surface 6 hours later on July 21 at 02:56 UTC.</p>

<p>Armstrong spent about three and a half two and a half hours outside the spacecraft, Aldrin slightly less; and together they collected 47.5 pounds (21.5&nbsp;kg) of lunar material for return to Earth. A third member of the mission, <a href="http://en.wikipedia.org/wiki/Michael_Collins_(astronaut)">Michael Collins</a>, piloted the <a href="http://en.wikipedia.org/wiki/Apollo_Command/Service_Module">command</a> spacecraft alone in lunar orbit until Armstrong and Aldrin returned to it for the trip back to Earth.</p>

<h2>Broadcasting and <em>quotes</em></h2>

<p>Broadcast on live TV to a world-wide audience, Armstrong stepped onto the lunar surface and described the event as:</p>

<blockquote>
				<p>One small step for [a] man, one giant leap for mankind.</p>
				</blockquote>

<p>Apollo 11 effectively ended the <a href="http://en.wikipedia.org/wiki/Space_Race">Space Race</a> and fulfilled a national goal proposed in 1961 by the late U.S. President <a href="http://en.wikipedia.org/wiki/John_F._Kennedy">John F. Kennedy</a> in a speech before the United States Congress:</p>

<blockquote>
				<p>[...] before this decade is out, of landing a man on the Moon and returning him safely to the Earth.</p>
				</blockquote>

<h2>Technical details</h2>

<table align="right" border="1" cellpadding="5" cellspacing="0">
					<caption><strong>Mission crew</strong></caption>
					<thead>
						<tr>
							<th scope="col">Position</th>
							<th scope="col">Astronaut</th>
						</tr>
					</thead>
					<tbody>
						<tr>
							<td>Commander</td>
							<td>Neil A. Armstrong</td>
						</tr>
						<tr>
							<td>Command Module Pilot</td>
							<td>Michael Collins</td>
						</tr>
						<tr>
							<td>Lunar Module Pilot</td>
							<td>Edwin &quot;Buzz&quot; E. Aldrin, Jr.</td>
						</tr>
					</tbody>
				</table>

<p>Launched by a <strong>Saturn V</strong> rocket from <a href="http://en.wikipedia.org/wiki/Kennedy_Space_Center">Kennedy Space Center</a> in Merritt Island, Florida on July 16, Apollo 11 was the fifth manned mission of <a href="http://en.wikipedia.org/wiki/NASA">NASA</a>&#39;s Apollo program. The Apollo spacecraft had three parts:</p>

<ol>
					<li><strong>Command Module</strong> with a cabin for the three astronauts which was the only part which landed back on Earth</li>
					<li><strong>Service Module</strong> which supported the Command Module with propulsion, electrical power, oxygen and water</li>
					<li><strong>Lunar Module</strong> for landing on the Moon.</li>
				</ol>

<p>After being sent to the Moon by the Saturn V&#39;s upper stage, the astronauts separated the spacecraft from it and travelled for three days until they entered into lunar orbit. Armstrong and Aldrin then moved into the Lunar Module and landed in the <a href="http://en.wikipedia.org/wiki/Mare_Tranquillitatis">Sea of Tranquility</a>. They stayed a total of about 21 and a half hours on the lunar surface. After lifting off in the upper part of the Lunar Module and rejoining Collins in the Command Module, they returned to Earth and landed in the <a href="http://en.wikipedia.org/wiki/Pacific_Ocean">Pacific Ocean</a> on July 24.</p>

<hr />
				<p>Source: <a href="http://en.wikipedia.org/wiki/Apollo_11">Wikipedia.org</a></p>

When content filtering is working in automatic mode, toolbar configuration affects what is allowed in the editor. In other words, CKEditor 4 will only allow the type of content that can be created using the available toolbar buttons and will remove disallowed elements.

Related Features

Get Sample Source Code

Custom toolbar

<!doctype html>
<html lang="en">

<head>
  <meta charset="utf-8">
  <meta name="robots" content="noindex, nofollow">
  <title>Custom toolbar</title>
  <script src="https://cdn.ckeditor.com/4.25.0-lts/standard-all/ckeditor.js"></script>
</head>

<body>
  <textarea cols="80" id="editor1" name="editor1" rows="10">&lt;p&gt;This is some &lt;strong&gt;sample text&lt;/strong&gt;. You are using &lt;a href=&quot;https://ckeditor.com/&quot;&gt;CKEditor&lt;/a&gt;.&lt;/p&gt;</textarea>
  <script>
    CKEDITOR.replace('editor1', {
      // Define the toolbar groups as it is a more accessible solution.
      toolbarGroups: [{
          "name": "basicstyles",
          "groups": ["basicstyles"]
        },
        {
          "name": "links",
          "groups": ["links"]
        },
        {
          "name": "paragraph",
          "groups": ["list", "blocks"]
        },
        {
          "name": "document",
          "groups": ["mode"]
        },
        {
          "name": "insert",
          "groups": ["insert"]
        },
        {
          "name": "styles",
          "groups": ["styles"]
        },
        {
          "name": "about",
          "groups": ["about"]
        }
      ],
      // Remove the redundant buttons from toolbar groups defined above.
      removeButtons: 'Underline,Strike,Subscript,Superscript,Anchor,Styles,Specialchar,PasteFromWord'
    });
  </script>
</body>

</html>