WordPress Page Types

Overview

WordPress page types let you design special-purpose templates directly in Flowmo -- things like search results, archive listings, product pages, and WooCommerce views. When you add a page type, Flowmo auto-generates a blueprint collection with the right fields and repeaters for that template, so your exported WordPress theme handles every page context out of the box.

You configure page types in the Special Pages tab of the CMS panel. Each page type maps to a specific WordPress template file (e.g., search.php, archive.php, single-product.php) and comes pre-loaded with the fields and repeaters that template needs.

Prerequisites

• A Flowmo project with CMS mode enabled.
• At least one frame on your canvas to assign as the template layout.
• Familiarity with Flowmo's CMS collections and fields (see Visual CMS Editor and ACF Field Types).

Available Page Types

Flowmo supports the following page types:

Page Type	Label in UI	WordPress Template	Purpose
search	Search Results	search.php	Displays search query results
archive	Archive	archive.php	Lists posts by date, post type, or taxonomy
taxonomy-archive	Taxonomy Archive	taxonomy-{slug}.php	Lists posts filtered by a specific taxonomy term
product	Product	single-product.php	WooCommerce single product page
product-category	Product Category	taxonomy-product_cat.php	WooCommerce product category listing
cart	Cart	page-cart.php	WooCommerce cart page
checkout	Checkout	page-checkout.php	WooCommerce checkout page
my-account	My Account	page-my-account.php	WooCommerce customer account page
shop	Shop	archive-product.php	WooCommerce main shop listing

Step-by-Step: Adding a Page Type

1. Open the Special Pages Tab

In the CMS panel on the right sidebar, navigate to the Special Pages tab. If no page types have been configured yet, you will see an empty state with the message "No page types configured" and an Add Page button.

2. Select a Page Type

Click Add Page. A list of available page types appears. Each type can only be added once -- types you have already configured are hidden from the list. Click the page type you want (e.g., Search Results).

3. Review the Auto-Generated Blueprint

When you add a page type, Flowmo automatically creates a blueprint collection with pre-configured fields and repeaters. For example, adding Search Results generates:

• Fields: search_query (search), page_title (page-title)
• Repeaters: search_results with sub-fields result_title (text), result_excerpt (textarea), result_link (url), result_image (image)

You drill into the page type detail view automatically after adding it.

4. Assign a Frame

In the detail view, use the Frame dropdown to assign one of your canvas frames to this page type. This links your visual design to the WordPress template. The frame selector shows all available frames from your project.

5. Configure Page-Type-Specific Settings

Some page types have additional configuration options:

Archive pages show a Scope dropdown with three options:

• General -- A generic archive template for all post types.
• Post Type -- Scoped to a specific post type. When selected, a Post Type text input appears (e.g., enter post or a custom post type slug).
• Taxonomy -- Scoped to a specific taxonomy. When selected, a Taxonomy text input appears (e.g., enter category).

Taxonomy Archive pages show a Taxonomy text input where you specify which taxonomy this template handles (e.g., category, post_tag, or a custom taxonomy slug).

6. Customize Fields and Repeaters

You can modify the auto-generated blueprint to fit your needs:

• Add a field: Click Add Field at the bottom of the Fields section. Enter a name and choose a type from text, textarea, image, url, number, date, boolean, or wysiwyg.
• Add a repeater: Click Add Repeater at the bottom of the Repeaters section. Enter a name, then drill into the repeater to add its sub-fields.
• Edit a field: Click a field to expand its edit controls. You can change its name, type, required status, placeholder, and default value.
• Delete a field or repeater: Click the trash icon that appears on hover.

7. Connect Elements to Fields

To bind your design elements to CMS fields:

1. Select one or more elements on the canvas.
2. In the page type detail view, click Attach Selected Elements on a field or repeater.
3. The selected elements are connected and will pull dynamic data from WordPress at runtime.

8. Navigate Between Levels

Use the breadcrumb navigation at the top of the detail view to move between the page type root and nested repeaters. Click the back arrow or the parent name to go up one level.

Blueprint Reference

Each page type comes with a pre-built set of fields and repeaters. Here is what gets auto-generated:

Search Results

• Fields: search_query, page_title
• Repeaters: search_results (title, excerpt, link, image)

Archive Page

• Fields: page_title, page_description
• Repeaters: items (title, image, excerpt, link, date), categories (name, link, count), pagination (page_number, page_link, is_current)

Taxonomy Archive

• Fields: term_name, term_description, term_image
• Repeaters: items (title, image, excerpt, link)

Product Page

• Fields: product_title, product_description, product_image, product_price, add_to_cart_url
• Repeaters: product_gallery (gallery_image), related_products (title, image, price, link)

Product Category

• Fields: term_name, term_description, term_image
• Repeaters: products (title, image, price, link)

Cart Page

• Fields: page_title
• Repeaters: cart_items (title, image, price, quantity, total, remove_url)

Checkout Page

• Fields: page_title
• Repeaters: none (WordPress/WooCommerce handles the checkout form)

My Account

• Fields: page_title
• Repeaters: none (WordPress/WooCommerce handles account UI)

Shop Page

• Fields: page_title, page_description
• Repeaters: products (title, image, price, link), categories (name, link, count)

Tips

• Start with the blueprint, then customize. The auto-generated fields cover the most common use cases. Add or remove fields as your design requires.
• One page type per project. Each page type can only be added once. If you need multiple archive layouts, use the Archive page type with different scope settings.
• Assign frames early. The frame assignment determines which canvas design becomes the WordPress template. An "Assigned" badge appears in the list view when a frame is linked.
• WooCommerce page types require WooCommerce. The Product, Product Category, Cart, Checkout, My Account, and Shop page types export templates that depend on WooCommerce being installed on your WordPress site.

Common Issues

Problem	Solution
A page type is missing from the "Add Page" list	You have already added it. Each type can only be configured once. Check your existing page type list.
The exported template does not render correctly	Make sure you assigned a frame to the page type. Without a frame, the template has no visual layout to export.
Archive page shows wrong posts	Check the Scope setting. Set it to Post Type and enter the correct slug if you want to filter by a specific post type.
Taxonomy archive not matching	Ensure the Taxonomy field value matches your WordPress taxonomy slug exactly (e.g., category, not Categories).
WooCommerce pages are blank	Confirm that WooCommerce is installed and activated on your WordPress site. These templates depend on WooCommerce functions.
Fields show empty data on the live site	Verify that you connected canvas elements to the fields using Attach Selected Elements. Unconnected fields do not render.

Related Articles

• Visual CMS Editor
• ACF Field Types
• ACF Field Groups
• ACF Repeater Fields
• Custom Post Types
• ACF Options Pages