WordPress Custom Post Types and Taxonomies Guide

WordPress comes with two built-in content types: Posts (blog articles) and Pages (static content). But most websites need more. A portfolio site needs a 'Projects' type. A restaurant needs a 'Menu Items' type. A real estate site needs 'Properties.' Custom post types let you create any content structure. Each type gets its own admin screen, custom fields, and URL structure. Combined with custom taxonomies (categories and tags for your custom types), you can build sophisticated content architectures. After converting your site with AI to Wordpress, custom post types let you organize and expand your content beyond the original static structure. Instead of creating regular pages for each portfolio item, create a Portfolio custom post type with dedicated templates.

**Method 1: Code (functions.php or plugin)** add_action('init', function() { register_post_type('portfolio', array( 'labels' => array( 'name' => 'Portfolio', 'singular_name' => 'Project', 'add_new_item' => 'Add New Project', ), 'public' => true, 'has_archive' => true, 'show_in_rest' => true, // Enables block editor 'menu_icon' => 'dashicons-portfolio', 'supports' => array('title', 'editor', 'thumbnail', 'excerpt'), 'rewrite' => array('slug' => 'projects'), )); }); **Method 2: CPT UI Plugin (No Code)** 1. Install Custom Post Type UI plugin 2. CPT UI → Add/Edit Post Types 3. Enter slug, labels, and settings 4. Save — your new content type appears in admin **Method 3: ACF + Custom Post Type UI (Best Combo)** • CPT UI creates the post type • Advanced Custom Fields adds custom data fields • Together: unlimited content structuring without code

Taxonomies categorize your custom post types: **Creating a Custom Taxonomy:** add_action('init', function() { register_taxonomy('project_type', 'portfolio', array( 'labels' => array( 'name' => 'Project Types', 'singular_name' => 'Project Type', ), 'public' => true, 'hierarchical' => true, // Like categories (vs tags) 'show_in_rest' => true, 'rewrite' => array('slug' => 'project-type'), )); }); **Hierarchical vs Non-Hierarchical:** • Hierarchical (like Categories): Parent/child relationships. Best for structured classification. • Non-Hierarchical (like Tags): Flat labels. Best for flexible tagging. **Example Taxonomy Structures:** Portfolio → Project Type (Web Design, Branding, Photography) Testimonials → Industry (SaaS, E-commerce, Healthcare) Team → Department (Engineering, Marketing, Design) Recipes → Cuisine (Italian, Mexican, Japanese) + Diet (Vegan, Keto, Paleo)

Advanced Custom Fields transforms custom post types into powerful content structures: **Install ACF:** Plugins → Add New → 'Advanced Custom Fields' → Install → Activate **Create Field Group:** 1. Custom Fields → Add New 2. Name: 'Project Details' 3. Location: 'Post Type is equal to Portfolio' 4. Add fields: - Client Name (text) - Project URL (url) - Completion Date (date picker) - Technologies Used (checkbox: WordPress, React, etc.) - Project Gallery (gallery) - Featured (true/false) **Display Fields in Templates:** In your child theme template: $client = get_field('client_name'); $url = get_field('project_url'); $date = get_field('completion_date'); $gallery = get_field('project_gallery'); **ACF Field Types:** Text, Textarea, Number, Range, Email, URL, Password, Image, File, Gallery, Select, Checkbox, Radio, Button Group, True/False, Link, Post Object, Page Link, Relationship, Taxonomy, User, Google Map, Date Picker, Color Picker, Message, Tab, Group, Repeater (Pro), Flexible Content (Pro)

WordPress's template hierarchy applies to custom post types: **Archive Page (listing all items):** Create archive-portfolio.php in your child theme: <?php get_header(); ?> <main> <h1>Our Portfolio</h1> <div class='projects-grid'> <?php while (have_posts()) : the_post(); ?> <div class='project-card'> <?php the_post_thumbnail('medium'); ?> <h2><a href='<?php the_permalink(); ?>'><?php the_title(); ?></a></h2> <p><?php the_excerpt(); ?></p> </div> <?php endwhile; ?> </div> <?php the_posts_pagination(); ?> </main> <?php get_footer(); ?> **Single Item Page:** Create single-portfolio.php: <?php get_header(); ?> <article> <h1><?php the_title(); ?></h1> <?php the_post_thumbnail('large'); ?> <?php the_content(); ?> <p>Client: <?php the_field('client_name'); ?></p> <p>Date: <?php the_field('completion_date'); ?></p> <a href='<?php the_field('project_url'); ?>'>View Live Site</a> </article> <?php get_footer(); ?> **Taxonomy Archive:** Create taxonomy-project_type.php for filtered project listings.