Creating Record Types

Open Post Runtime → Post Types and select Add New to create a type, or Edit on a row to change one. The same options can be set by an AI assistant through the connector; the setting key is given in each table for that case.

Basic info

Option	Key	What it does	Default
Slug	slug	The internal name. Lowercase letters, numbers and underscores, at most 20 characters. Cannot be changed after creation. post, page, attachment, product and other WordPress and WooCommerce names are refused.	— (required)
Singular label	label_singular	The name of one record in the admin, such as “Listing”.	— (required)
Plural label	label_plural	The name of the type in the admin menu and archive, such as “Listings”.	— (required)
Description	description	A note stored with the type.	Blank

Behavior

Option	Key	What it does	Default
Public	public	Records have public pages and appear in front-end queries.	On
Has archive page	has_archive	The type gets an archive page listing its records. Also needed for an event type’s calendar feed.	On
Hierarchical (supports parent/child relationships)	hierarchical	Records can have a parent record. Needed for groupings that list child records.	Off
Available in REST API and block editor	show_in_rest	Turn off to edit records in the classic editor.	On
Show in admin menu	show_in_menu	The type gets its own admin menu.	On
Menu position	menu_position	Where the menu sits: 5 is Posts, 20 is Pages.	25
Menu icon	menu_icon	A Dashicons name such as dashicons-admin-home, an image URL, or a base64 SVG.	dashicons-admin-post

Editor features

Option	Key	What it does	Default
Supports	supports	The parts of the edit screen: Title, Editor (main content), Featured image, Excerpt, Author, Comments, Revisions, Page attributes (parent, order), Custom fields. Without Editor, the single page has no main content area.	Title, Editor, Featured image, Excerpt
Taxonomies	taxonomies	Comma-separated taxonomy slugs to attach, such as category, post_tag. The taxonomy must already exist; this plugin does not create taxonomies.	None
Capability type	capability_type	Which WordPress permissions govern the records. Leave as post unless you know you need something else.	post

Hero

The hero is the header at the top of every record’s page: title, excerpt, featured image and the post fields you place there.

Option	Key	What it does	Default
Hero layout	hero_layout	Stacked puts the image as a 16:9 banner above the title. Split puts the image beside the title and excerpt. Overlay places the title and fields on the image over a darkening gradient.	Stacked
Image position	hero_image_position	Split only. Left or Right.	Left
Image aspect ratio	hero_image_aspect	Split only. Square (1:1), Landscape (4:3) or Wide (16:9).	Square
Overlay image focus	hero_overlay_focus	Overlay only. Which part of a tall photo stays visible: Center, Top or Bottom.	Center
Hero theme	hero_theme	Inherit follows the page’s light or dark mode. Light band and Dark band force the hero into a contrasting band with its own background.	Inherit
Hero width	hero_width	Contained keeps the hero within the content width. Full width runs its background to the edges of the window while the content stays aligned.	Contained

A record with no featured image gets a text-only hero; with Overlay, it falls back to the stacked treatment, so the band is never empty. While an overlay image is showing, Hero theme has no effect: text is always light on the dark gradient.

Grouping defaults

Option	Key	What it does	Default
Default icon	default_icon	An icon used on grouping items that have no icon or image, for example items pulled in automatically from other records.	None

Archive card meta

These answer the Promptless theme’s archive cards. They do not affect a Promptless WP post grid, which has its own settings.

Option	Key	What it does	Default
Post date	archive_show_post_date	Show the date the record was created on archive cards. Leave off when a post field carries the date that matters, such as an event date.	Off (up to version 0.10.0 the admin form started with it on)
Post author	archive_show_post_author	Show the author byline on archive cards. The byline is the WordPress account that created the record.	Off (up to version 0.10.0 the admin form started with it on)
Card image aspect ratio	archive_image_aspect	The featured-image crop on archive cards: 16:9 — Wide, 4:3 — Standard, 1:1 — Square or 4:5 — Portrait.	16:9

Public address

A record’s address is /{slug}/{record-name}/ and the archive is /{slug}/, using the type’s Slug. Because a slug may contain underscores, a type named pt_meeting is published at /pt_meeting/….

To publish under a different address, set rewrite through the connector, for example "rewrite": { "slug": "meetings" }. A nested address such as council/meetings works; each part is cleaned the way WordPress cleans a page slug (lowercase, spaces become hyphens). with_front (default off) adds the site’s permalink prefix. The Post Types screen has no field for this.

Warning

Up to version 0.10.0, saving the type from the Edit Post Type screen removes an address set through the connector, and the type goes back to its slug. On those versions, set rewrite again through the connector after editing a type in the admin. From version 0.10.1 the screen keeps settings it does not show.

Old addresses keep working after a change: WordPress redirects a missing address to the record with the same name.

Removing a type

Remove on the Post Types list unregisters the type. Its records and their field values stay in the database, and registering the same slug again brings them back, with their grouping definitions. Up to version 0.10.0, Remove deleted the grouping definitions; the connector kept them. See Connector overview.

Related pages

• Your First Record Type — A short walkthrough that creates a Listing record type with a price field and an amenities list, then publishes a first listing.
• Post Fields — The ten post field display types, the five positions in the page header and on cards, badge options, per-record hiding, and the twelve-field limit.
• Groupings — Repeatable lists on a record's page — the five layouts, where they sit, how items link, and the four ways a grouping fills itself, including reverse lookups.
• Single Record Pages — What appears on each record's page and in what order, related records, search engine tags, caching, and how themes and Promptless WP can take over the page.
• Archives and Post Grids — List records as cards on the theme archive or a Promptless WP post grid, choose what each card shows, and give visitors filters and sorting built from your fields.