WordPressのカスタム投稿タイプ ― 投稿タイプキーには文字数制限がある

WordPress

2025.09.08

WordPress で独自の投稿タイプ（CPT: Custom Post Type）を作成する際、register_post_type() 関数を利用します。
しかし、このとき指定する 投稿タイプキー（第一引数）には 1〜20文字の制限 があることをご存じでしょうか？

投稿タイプキーの制限とは？

投稿タイプキーは、WordPress が内部でカスタム投稿タイプを識別するための名前です。
次のルールがあります。

もし制限を超えた場合、以下のような Notice が表示されます。

Notice: 関数 register_post_type が誤って呼び出されました。
投稿タイプ名の長さは1から20文字でなければいけません。

たとえば「レシピコレクション」というカスタム投稿タイプを作りたいとします。
キーを長く指定してしまうとエラーになります。

register_post_type('my_favorite_recipe_collection_posts', [
    'label' => 'レシピコレクション',
    'public' => true,
]);

このキーは 20文字を超えているため、登録できません。

register_post_type('recipes', [
    'label' => 'レシピコレクション',
    'public' => true,
]);

このように、内部キーは短くシンプルにして、管理画面に表示される「ラベル」で正式名称を表現するのが正しい方法です。
これにより、システム上の安定性と、ユーザーにとっての分かりやすさを両立できます。

投稿タイプキーは WordPress 内部で幅広く利用されます。

長すぎるキーを使用すると、内部処理やデータベース構造に不具合を生じる恐れがあるため、WordPress が制限を設けています。