Using the Block Editor
Adding the block
If you build pages with the WordPress block editor (Gutenberg), you can place your directory with the Integration Directory block instead of typing the shortcode. Edit any page or post, click the block inserter (the + button), search for Integration Directory, and select it. The block lives in the Widgets category of the inserter.
The block and the [integration_directory] shortcode are two ways to place the same directory. Pick whichever suits how you build pages — you don’t need both on one page.
No live preview in the editor
The Integration Directory block is a dynamic, server-rendered block: it shares the shortcode’s renderer, so the published front end always matches what the shortcode would produce. Because it renders on the server, the editor does not show a live directory. You’ll see a dashed placeholder with a one-line summary of the current settings instead.
Heads up: to see the real directory — your logos, filters, and layout — use the editor’s Preview button or publish the page and view it on the front end. The placeholder in the editor is expected behavior, not a broken block.
Directory options
With the block selected, open the Inspector (the settings sidebar on the right) and expand the Directory options panel. It has six controls:
| Control | What it does | Default |
|---|---|---|
| Layout | Choose Grid, List, or Compact. | Grid |
| Grid columns | Slider from 1 to 6 columns for the grid layout. | 4 |
| Show at first (0 = all) | Slider from 0 to 60. How many integrations show before a Load more button appears; 0 shows all with no button. Maps to the shortcode’s per_page. |
0 (all) |
| Show search box | Toggle the front-end search box on or off. | Off |
| Show filter sidebar | Toggle the filter sidebar on or off. Maps to show_filters. |
On |
| Limit to categories | Restrict the block to specific categories. Enter a comma-separated list of category slugs (not display names). Leave blank for all categories. | Blank (all) |
Heads up: Limit to categories takes category slugs, not the names you see in the editor. The slug is the lowercase, hyphenated version generated when you create the category — for example a category named Email Marketing is usually email-marketing. See the Setting Up Categories article if you’re unsure of a slug.
Heads up: the block’s Grid columns default is always 4, regardless of the Default grid columns value you set on the Appearance tab. That Appearance default only applies to the bare shortcode; the block ships its own default of 4. Set the columns slider on the block to the number you want.
Block limits
- One block per page. You can add the Integration Directory block only once on a given page or post. If you need more than one directory on the same page, use the
[integration_directory]shortcode instead — multiple shortcodes can coexist on one page. See Shortcode Options. - No HTML editing. The block can’t be converted to or edited as HTML. Configure it through the Inspector controls only.
When to use the shortcode instead
The block exposes six of the directory’s options: layout, grid columns, show-at-first, search box, filter sidebar, and limit-to-categories. Everything else is available only through the shortcode. If you need any of the following, place the directory with [integration_directory] instead:
criteria— hard-scope to a main-filter value.limit— cap the total number of integrations.orderbyandorder— legacy ordering attributes.show_categories— hide the Categories filter section.show_custom_filter— hide the main filter group.url_params— turn the shareable URL parameters on or off.
For the full list of shortcode attributes and how they behave, see the Shortcode Options article. For the ?sort=, ?category=, ?q=, and ?f_<key>= parameters that make any filtered view a shareable link, see Shareable Links.
Related articles
- Shortcode Options — the full
[integration_directory]attribute list, including the options the block doesn’t expose. - Shareable Links — the URL parameters that pre-select filters, sort, and search.
- Setting Up Categories — how categories and their slugs work, for the Limit to categories field.
- Appearance & Styling — accent color, card style, corner rounding, and the default grid columns for the bare shortcode.