ACF Table Field Pro Documentation
Table Field Pro adds a table field to Advanced Custom Fields (ACF), ACF Pro and Secure Custom Fields (SCF). Editors edit tables directly in a table editor, and you decide which editing options they get. You can display the table as HTML or use its data in your own output.
What is the table field for?
The table field is made for data in rows and columns, such as price lists, technical specifications, schedules or comparisons. Editors add, move and remove rows and columns, use a header and footer, merge cells and import CSV data.
When a repeater field becomes unwieldy for this kind of content, the table field is often the better choice. Compare table field and repeater field
Where do you want to start?
Set up and display tables
You build a theme or plugin. You add the field to field groups, set up the editing options and display tables with PHP, the shortcode, the REST API or WPGraphQL.
Start as developer
Use tables with a Page Builder
You build websites with an existing theme or a Page Builder such as Elementor and want to show tables without writing PHP.
Start as website builder
Edit tables
You edit content in WordPress and want to learn how to work with the table editor.
Start as content editor
Quick start
- Install the plugin and activate your license key.
- Add a field of the type Table Pro to a field group and set up the editing options.
- Fill in the table on a post or page.
- Display the table in your template:
<?php the_table( 'my_table' ); ?>
Without PHP, use the shortcode. Coming from the free version? Read Switch field type from Free to Pro.
Frequently used
- get_table() and the_table(): return or display a table as HTML
- Shortcode: display a table in editors and Page Builders
- Field data: the structure of the stored table data
- REST API and WPGraphQL: read and update tables from outside
- Responsive tables