ACF Table Field Pro Add-on Docs Last updated:

Select plugin version:

Since version: v1.0.0

Cell content type

New since version 1.5.4

  • Option to enable or disable media insertion in the editor

The content type decides how a cell is edited: with a simple text field, with the classic WordPress editor, or not at all. You can set it for the whole table and change it for single columns, rows and cells.

Content types

Type When you click the cell Use it for
None Nothing opens, the cell can’t be edited. Its content stays visible, and the Tab key skips the cell. Content that editors should not change.
Simple Text A plain text field opens directly in the cell. This is the default of a table. HTML code also works here. It is protected by sanitizing, so scripts and other unsafe code won’t run. Short text and numbers without formatting.
Editor The classic WordPress editor (WYSIWYG) opens in a window. Formatted text, links, lists and images.
Inherit The cell takes its type from the next higher level: Cell → Row → Column → Table. The default of columns, rows and cells.

Set the content type

  1. Open the settings of the level you want to change: the Settings for the table button, or the menu icon of a column, row or cell.
  2. Open the Content Type tab.
  3. Select a type under Type of Content.
  4. Click Apply Changes.
Settings for a cell, Content Type tab, Editor selected with the Editor Toolbar and Enable Media Insertion options

The tab is available for the table, columns, body rows and body cells. If the table has a header or footer, its rows and cells have the tab as well.

How Inherit works

With Inherit, a level uses the type of the next higher level. The levels are checked in this order, and the first one with its own type wins:

Cell → Row → Column → Table

The table is the top level, so it has no Inherit option. It uses Simple Text by default.

An example, as shown in the video:

  • The table is set to Simple Text, so every cell starts as Simple Text.
  • A column set to Editor makes all cells in that column Editor cells.
  • A row set to None locks its cells, also those in the Editor column, because the row comes before the column.
  • A single cell in that row set to Simple Text can be edited again, because the cell comes first.

Editor options

When Type of Content is set to Editor, two more options appear:

  • Editor Toolbar sets the buttons of the editor. You can choose the ACF toolbars such as Full and Basic, or Inherit to use the toolbar of the next higher level. You can also add your own toolbars.
  • Enable Media Insertion shows or hides the Add Media button in the editor. The options are only shown on a level that is set to Editor itself, not on a level set to Inherit. To change them for a single cell in an Editor column, set that cell to Editor as well.

Field settings

In the settings of the table field in your field group, you decide which content type options editors get. Each level has its own group of checkboxes, for example Settings for the table, Settings for the table columns or Settings for cells in the table body. Two of them belong to the content type, and both are checked by default:

  • Contenttype shows the Content Type tab on that level. Without it, editors can’t change the content type there. The level keeps the type it already has.
  • Editor, nested under Contenttype, offers the Editor type in the dropdown on that level. Without it, editors can only choose None, Inherit and Simple Text there.
Field settings of the table field, the group Settings for cells in the table body with the checkboxes Contenttype and Editor marked

The checkboxes apply per level. To rule out the Editor completely, uncheck Editor in every group. Cells that are already set to Editor remain Editor cells. To give editors a table with fixed parts, set up a default table and set those cells, rows or columns to None. More about the checkboxes in Setup editing options.

Output on the website

When the table is output with get_table() or the shortcode, the content type has this effect:

  • Editor: the cell outputs the HTML created in the editor.
  • Simple Text: each line break becomes a br element.
  • None: the content is output as it is stored, without br elements.

Previous and Next Sources

Parent sources