Skip to content

[00] Subset Fill, User guide

Getting started

Last updated

Install Subset Fill, pick an AI provider, turn the builder on for a Flexible Content field, and build your first page from pasted content.

Subset Fill fills an ACF Flexible Content field from content you paste. The AI picks which of your layouts each part belongs in and fills the sub-fields with your words, exactly as you wrote them. It arranges your content and never writes its own. This page covers installing the plugin, choosing a provider, setting up a field and running your first build.

Before you start

You need:

  • ACF PRO or Secure Custom Fields. Both include Flexible Content. Free ACF doesn’t, so the builder won’t run with it.
  • WordPress 6.5 or later and PHP 8.1 or later.
  • An API key from Anthropic, OpenAI or OpenRouter, or WordPress 7.0 or later with a provider connected in Settings → Connectors. Pro users can use hosted credits instead.

1. Install the plugin

  1. Download the free Subset Fill zip from subsetwp.com/download/fill.
  2. In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
  3. Click Activate.

If neither ACF PRO nor Secure Custom Fields is active, you’ll see a notice and the plugin stays off until you add one.

2. Choose a provider

Go to Subset → Fill. On the Settings tab, choose a Provider, add your API key and, if you like, pick a model. Leave the model empty to use the default. Click Save Changes, then Test connection to check the key. The test doesn’t send any content.

ProviderWhat you need
AnthropicYour own Anthropic API key
OpenAIYour own OpenAI API key
OpenRouterYour own OpenRouter API key. Models use author/model IDs.
WordPress AI ConnectorsWordPress 7.0 or later, with a provider in Settings → Connectors
Hosted credits (Pro)An active Pro licence. See hosted credits.

With WordPress AI Connectors you don’t enter a key here. The builder uses whichever provider you connected in Settings → Connectors, and WordPress picks a model if you leave it empty.

Saved keys are stored encrypted and never shown again. You can define a key in wp-config.php instead. It takes precedence over the settings screen and locks the field:

<?php
define( 'SFCB_ANTHROPIC_API_KEY', 'sk-ant-...' );

The constants are SFCB_ANTHROPIC_API_KEY, SFCB_OPENAI_API_KEY and SFCB_OPENROUTER_API_KEY. If your site’s security keys (salts) change, saved keys can’t be read any more and you’ll need to enter them again.

Only administrators can see or change this screen.

3. Turn the builder on for a field

  1. Edit the field group and open your Flexible Content field.
  2. Switch on Content builder.
  3. For each layout, fill in Builder description. Say what the layout is for and when to use it, such as “A pull quote with attribution. Use for a standout quote.”

The AI picks layouts by their descriptions, so they matter more than any other setting. A good description says what goes in the layout and what kind of passage should become one. When two layouts are close, say what separates them.

Each layout also has:

  • Builder max per page: the most times the AI may use the layout. Unlike ACF’s own Max, editors can still add more by hand.
  • Builder position: Anywhere, At the start or At the end. Use the start for a hero and the end for a closing call to action.

Each sub-field has a Content builder setting: Fill from pasted content or Always leave for a person. Use the second for things your content never contains, like a background colour.

Field labels and instructions go to the AI too, so “Headline: the short title at the top of the section” works better than “Title”.

4. Build

  1. Open a post that shows the field and click Build from content.
  2. Paste your content. Headings, paragraphs, lists, links, quotes, tables and images all come across.
  3. If the field already has rows, choose Add the new rows after them or Replace them.
  4. Click Build.

Long content is split at headings and built in parts, and you’ll see “Building part 1 of 3” while it runs. You can cancel at any time.

The rows appear in the field, unsaved. A summary bar shows how many rows were built, how many fields need attention and how many passages weren’t placed.

What gets checked

Every value is checked against what you pasted before it reaches the editor. Text, links, email addresses, image sources and numbers that aren’t in your content are cleared, and the field is flagged so you can see what changed.

Passages the AI didn’t place anywhere are counted in the summary bar. Click Show leftovers to see them and Copy to grab the text.

Rows over a layout’s max, and rows with a layout that doesn’t exist, are left out and counted.

Field types

The builder fills these field types: text, textarea, email, URL, select, radio, checkbox, button group, WYSIWYG, number, true/false, link, image, group and repeater.

Image fields are filled only when the pasted image is already in your Media Library. The builder matches it by address, including resized copies, or by file name when exactly one image has that name. It never downloads images. An image it can’t match is flagged for you to choose.

Any other field type is marked Fill manually (not supported yet) and left for you. Pro adds relational fields, nested Flexible Content and clone fields.

Limits

  • Each build takes up to 500 KB of content.
  • Each user can make 60 build requests an hour. Each part of a long build counts as one request.

Developers can change both. See the developer reference.

Where your content goes

When you click Build, the pasted content and the shape of your field go to the provider you chose, from your server, with your key. Nothing is sent before that, and the plugin doesn’t store or log your content. The Build box tells editors this the first time they open it, and Settings → Privacy → Policy Guide has suggested text for your privacy policy.

You pay your AI provider for what you use, under your own account.

Try a file from the command line

If you use WP-CLI, wp subset content-builder map runs a file through your chosen provider and prints the rows as JSON. Nothing is saved.

wp subset content-builder map field_sections article.html

The first argument is the Flexible Content field key and the second is an HTML or plain-text file (use - to read from stdin). Add --plan to print the chunks and the first prompt, with all your layout descriptions, without calling the provider. That needs no API key, so it’s a good way to check your descriptions.

Pro

Pro is a separate add-on plugin. It needs the free plugin active.

  1. Download the Pro zip and install it from Plugins → Add New → Upload Plugin.
  2. Activate it.
  3. Go to Subset → Fill → License, enter your licence key and activate it.

An active licence gets updates and support. See activating a licence for more.

Hosted credits

With hosted credits you build with your Pro licence instead of an API key.

  1. Go to Subset → Fill and choose Hosted credits (Pro) as the provider.
  2. Save. The Credits row shows your balance and a Buy more link.

While you paste, the Build box shows a rough estimate in tokens with your balance. The estimate is a guide, since what a credit buys isn’t final yet. You’re not charged for builds that fail.

To keep building when credits run out, tick When credits run out, use my own API key. It’s off by default. When it’s on, a build that finds no credits left goes to the first of Anthropic, OpenAI or OpenRouter that has a key saved or set in wp-config.php, and that provider bills you. To save a key, choose that provider, enter the key and save, then switch back to hosted credits.

Hosted builds go through Subset’s service to an AI provider. The hosted AI credits page says what’s sent and what’s kept.

Import from a Word file or a web address

With Pro, the Build box has a Content from choice: Paste, Word file or Web address.

  • Word file: choose a .docx file up to 10 MB. Headings, paragraphs, lists, links, tables and images come across, and images are added to your Media Library. Headers, footers, footnotes, comments and text boxes are left out. The file is read on your server and sent nowhere.
  • Web address: enter the address of a public page. Your server fetches it and keeps the main text, without menus, sidebars and footers. Tick Copy the page’s images to the media library to bring the images too. Addresses on private or internal networks are refused.

Either way, the content then goes through the same build and checks as pasted content.

Relational fields

Pro fills post object, page link, relationship and taxonomy fields. The AI names what your content refers to, such as a page title or a category name, and the builder looks it up among your existing posts or terms.

It fills the field only on an exact or high-confidence match, such as the same name in different case. If several posts or terms match, the field is left empty with a note listing them so you can choose. If nothing matches, you’ll see a note. The builder never creates posts or terms.

Nested Flexible Content and clone fields

Pro fills Flexible Content fields inside layouts, using each nested layout’s own Builder description, max and position. It also fills clone fields, in both seamless and group display.

A top-level field and two levels of nested Flexible Content fit in one build, with up to six nested Flexible Content fields. Anything deeper is marked Fill manually and the rest of the build still works.

Get help

Report bugs and request features at subset-feedback (opens in a new tab). For anything else, email hello@subsetwp.com.