Skip to main content

AI site setup

AI site setup helps you plan custom post types, taxonomies, and optional field groups from a short written brief, then apply the plan to your site. The feature is labeled Beta. You bring your own API keys (BYO).

Open AI site setup​

  1. Go to Divi Engine → Divi Machine.
  2. Open Tools → AI site setup (badge: Beta).

Direct hash: admin.php?page=divi-engine#divi-machine/ai-setup.

Two tabs:

TabPurpose
API keys & modelStore keys, choose connection and model, test the connection
AI assistantRun the five-step wizard

If no API key is saved yet, the UI opens API keys & model first.

Configure API keys and model​

  1. Open API keys & model.
  2. Enter an API key for OpenAI or a compatible endpoint (required to run the wizard).
  3. Choose Connection:
    • OpenAI (api.openai.com), or
    • Custom compatible endpoint — set API base URL (for example https://openrouter.ai/api/v1, no trailing slash). The endpoint must support POST …/chat/completions with Bearer auth.
  4. Pick a model preset (default gpt-4o-mini) or Custom….
  5. Optional image keys (only if you want stock photos on sample drafts):
    • Unsplash access key
    • Pexels API key
  6. Click Save keys & model, then Test OpenAI connection to verify.
note

Keys are stored for Machine’s AI tools. They are not returned by public Abilities/discovery APIs.

Run the wizard​

Step 1: Describe your site​

Enter a brief of at least 20 characters (for example a dealership, directory, or events site). Example chips in the UI can help you start.

Step 2: Custom fields plugin​

Choose how field groups should be created:

  • Let Divi Machine decide — uses the field provider detected on the site
  • Content types only — CPTs and taxonomies only (no field groups)
  • A specific active provider: Advanced Custom Fields, Secure Custom Fields, Pods, Meta Box, Toolset Types, or ACPT (only listed when active)

Step 3: Review and adjust​

  1. Click Create suggestion to generate a plan.
  2. Edit labels, slugs, and fields in the review UI.
  3. Optionally Regenerate example drafts.
  4. Open Technical details (for developers) if you need the raw JSON plan.

Step 4: Add to your site​

Confirm apply options, then click Add to my site.

Sample post options:

OptionBehavior
Include example draft postsCreates sample posts (count 1–20, default 5; fixed after the plan is created)
Skip creating draftsRegisters content types and fields only
Status for new sample postsDraft or Published in the UI
Demo images for sample draftsOff · Placeholder photos · Stock photos — Unsplash · Stock photos — Pexels

Step 5: Setup complete​

Review the summary and use the admin links (sample posts, field groups) to continue building layouts.

What apply creates​

When you apply a plan, Machine can:

  1. Create Divi Machine post types (skips slugs that already exist)
  2. Create taxonomies and attach them to those post types
  3. Create field groups for the chosen provider when the plugin API is available (group titles look like {Singular} — Fields)
  4. Optionally create sample posts with titles, content, field values, and terms
  5. Optionally attach demo images (featured image and image/gallery fields)

Apply does not modify an existing custom post type that already uses the same slug.

Limits and beta behavior​

  • Feature is Beta — review every plan before you apply it.
  • Brief must be at least 20 characters.
  • Field keys should be lowercase with underscores; avoid WordPress reserved query terms; keys starting with field_ may be auto-prefixed.
  • Repeater sub-fields are not editable in the simple form—use the technical JSON when needed.
  • Linked-post (post_object) sample values stay empty; some media fields may be omitted from generated sample JSON.
  • If Unsplash/Pexels mode is selected without a saved key, the UI warns you.
  • If the chosen fields plugin API is unavailable, field groups may be skipped (acf_skipped-style outcome in the summary).
  • Turn on Enable debug logging under Machine Debug settings if support needs logs from a failed run.

After AI setup​

  1. Open Post Types / Taxonomies under Divi Machine and confirm labels and archives.
  2. Add real content (or polish the sample drafts).
  3. Build a custom loop layout and Theme Builder archive/single templates.
  4. Display fields with Custom Field Item.

WordPress 6.9+ sites may also expose the same AI Site Setup operations through the WordPress Abilities API for agent tooling; day-to-day use is the admin wizard above.

What's Next​