A table block for Wagtail StreamField powered by TinyMCE

Links

• Documentation
• Changelog
• Contributing
• Discussions
• Security

TinyTableBlock is a StreamField block powered by TinyMCE and its table plugin.

Wagtail provides TableBlock and TypedTableBlock which are good options if you want basic tables with some cell merging capability or StreamField-powered cell, but they have their limitations:

• TableBlock is using an old version of handsontable. It doesn't support multi-row header, column headers, nor pasting complex tables.
• TypedTableBlock gets complex quickly depending on the types of blocks you add, and pasting is limited to single cells.

Wagtail TinyTableBlock (this package) provides the TinyMCE table editor which has improved copy/paste, multi-row and column headers, external link support and more. It does not currently support the Wagtail rich text data format for page and document links, nor does it support embedding images.

Installation

In your project's Django settings, add the app your INSTALLED_APPS list (at the end is fine):

INSTALLED_APPS = [
  # ...
  "wagtail_tinytableblock",
]

Add the TinyTableBlock model to your StreamField definition. For example

# yourapp/models.py
from wagtail.fields import StreamField
from wagtail.models import Page

from wagtail_tinytableblock.blocks import TinyTableBlock


class WonderfulPage(Page):
    body = StreamField([
        # ...
        ("table", TinyTableBlock()),
    ])

Finally, run Django's makemigrations and migrate commands to apply any model field changes to your project

$ python manage.py makemigrations
$ python manage.py migrate

Configuration

TinyTableBlock accepts an allow_links keyword argument which allows enabling the TinyMCE link plugin. Note: this currently only works with external URLs.

from wagtail.blocks import StreamBlock
from wagtail_tinytableblock.blocks import TinyTableBlock

class ContentBlocks(StreamBlock):
    table_block = TinyTableBlock(allow_links=True)

By default, we disable the TinyMCE contextual menu to allow the browser native one. If you want to use TinyMCE one, pass enable_context_menu=True:

from wagtail.blocks import StreamBlock
from wagtail_tinytableblock.blocks import TinyTableBlock

class ContentBlocks(StreamBlock):
    table_block = TinyTableBlock(enable_context_menu=True)

Configuring rich text features allowed in table cells

You can customize which text formatting tools are available inside the table cells. By default, formatting features are turned off to keep table content clean. You can enable them per block or globally across your entire site.

Supported features

The following formatting identifiers can be passed to the configuration arrays:

• bold
• italic
• strikethrough
• subscript
• superscript
• blockquote

Block configuration

To enable per-block configuration, pass a features list directly to the TinyTableBlock definition in your models.py. This aligns directly with standard Wagtail RichTextField formatting controls.

Global configuration (Django settings)

If you want to define a fallback list of formatting features for all tables across your website without repeating the code in every model, define WAGTAIL_TINYTABLE in your settings.py:

# settings.py

WAGTAIL_TINYTABLE = {
    "features": ["bold", "italic", "strikethrough"]
}

Note: If no global settings are defined and no per-block features are provided, the features list defaults to empty ([]), disabling rich text formatting choices completely.

Content Security Policy

For Content Security Policy configuration guidance, follow the TinyMCE documentation with the self-hosted option.

Data representation

The table data is saved as a JSON-serialized dictionary with the following keys:

{
   "headers": [],
   "rows": [],
   "html": the_sanitised_html
}

headers / rows are lists of lists with cell values. Each cell is a dictionary with the following keys

Contributing

All contributions are welcome! See CONTRIBUTING.md

Supported versions:

• Python 3.12, 3.13, 3.14
• Django 4.2, 5.2, 6.0
• Wagtail 6.3 (LTS), 7.0 (LTS), 7.3