Get Post Type Labels

Property	Value
description	Get singular or plural labels for a post type.
tags	lib, php, wp, oop
rating

Human: 3 - Mixed authorship

Roughly half AI, half human. Core content reviewed, but minor risk remains.

Overview

Get the singular or plural label for a post type. The helper defaults to the current post type, so it works in templates and Bricks loops without passing a post type explicitly.

Supported label types:

• singular: returns labels like Post, Product, or Event.
• plural: returns labels like Posts, Products, or Events.

Pass a fallback string when you want a custom value for missing or invalid post types.

Variants

Procedural

Add Macro

Add wp-get-post-type-labels macro.

<?php
/**
 * Get post type label.
 *
 * Args:
 * post_type -> default = current post type
 * type      -> singular | plural (default = singular)
 * fallback  -> optional override
 *
 * Examples:
 * mac_get_post_type_label();
 * mac_get_post_type_label( 'product', 'plural' );
 */

if ( ! function_exists( 'mac_get_post_type_label' ) ) {

    function mac_get_post_type_label( ?string $post_type = null, string $type = 'singular', string $fallback = '' ): string {

        // Resolve post type
        if ( $post_type === null || $post_type === '' ) {
            $post_type = get_post_type();
        }

        $type = strtolower( trim( $type ) );
        $type = $type === 'plural' ? 'plural' : 'singular';

        if ( ! is_string( $post_type ) || $post_type === '' ) {
            return $fallback ?: ( 'plural' === $type ? 'Posts' : 'Post' );
        }

        $post_type = sanitize_key( $post_type );
        $obj = get_post_type_object( $post_type );

        if ( ! $obj || empty( $obj->labels ) ) {
            return $fallback ?: ( 'plural' === $type ? 'Posts' : 'Post' );
        }

        if ( 'plural' === $type ) {
            return $obj->labels->name ?: ( $fallback ?: 'Posts' );
        }

        return $obj->labels->singular_name ?: ( $fallback ?: 'Post' );
    }
}

OOP

Add Macro

Add wp-get-post-type-labels--oop macro.

<?php
/**
 * Post type label helpers.
 *
 * @package mac-core
 */

declare(strict_types=1);

namespace MacCore\Utils {

use WP_Post_Type;

/**
 * Post type label helpers.
 */
final class GetPostTypeLabels
{
    public static function get( ?string $postType = null, string $type = 'singular', string $fallback = '' ): string
    {
        $type = \strtolower( \trim( $type ) );
        $type = $type === 'plural' ? 'plural' : 'singular';

        $postType = self::resolvePostType( $postType );

        if ( $postType === null ) {
            return $fallback !== '' ? $fallback : ( $type === 'plural' ? 'Posts' : 'Post' );
        }

        $object = \get_post_type_object( $postType );

        if ( ! $object instanceof WP_Post_Type ) {
            return $fallback !== '' ? $fallback : ( $type === 'plural' ? 'Posts' : 'Post' );
        }

        if ( $type === 'plural' ) {
            $label = (string) ( $object->labels->name ?? '' );
            return $label !== '' ? $label : ( $fallback !== '' ? $fallback : 'Posts' );
        }

        $label = (string) ( $object->labels->singular_name ?? '' );
        return $label !== '' ? $label : ( $fallback !== '' ? $fallback : 'Post' );
    }

    public static function singular( ?string $postType = null, string $fallback = '' ): string
    {
        return self::get( $postType, 'singular', $fallback );
    }

    public static function plural( ?string $postType = null, string $fallback = '' ): string
    {
        return self::get( $postType, 'plural', $fallback );
    }

    private static function resolvePostType( ?string $postType = null ): ?string
    {
        if ( $postType === null || $postType === '' ) {
            $current = \get_post_type();
            $postType = \is_string( $current ) ? $current : '';
        }

        $postType = \sanitize_key( $postType );

        return $postType !== '' ? $postType : null;
    }
}

}

namespace {

if ( ! function_exists( 'mac_get_post_type_label' ) ) {
    function mac_get_post_type_label( ?string $post_type = null, string $type = 'singular', string $fallback = '' ): string
    {
        return \MacCore\Utils\GetPostTypeLabels::get( $post_type, $type, $fallback );
    }
}

if ( ! function_exists( 'mac_get_post_type_singular' ) ) {
    function mac_get_post_type_singular( ?string $post_type = null, string $fallback = '' ): string
    {
        return \MacCore\Utils\GetPostTypeLabels::singular( $post_type, $fallback );
    }
}

if ( ! function_exists( 'mac_get_post_type_plural' ) ) {
    function mac_get_post_type_plural( ?string $post_type = null, string $fallback = '' ): string
    {
        return \MacCore\Utils\GetPostTypeLabels::plural( $post_type, $fallback );
    }
}

}