> For the complete documentation index, see [llms.txt](https://docs.acpt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acpt.io/basics/custom-post-types.md).

# Custom post types

Manage custom post types

### Manage custom post types

The custom post type dashboard looks like this:

<figure><img src="https://3235524095-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fiyf0tSKPgXiyoQ3zV3I6%2Fuploads%2Fgit-blob-1766c7f8d08aaccea4a363da08d2069ac99afac7%2FRegistered-Custom-Post-Types-%E2%80%B9-Localhost-%E2%80%94-WordPress%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

From the main dashboard you can run these operations:

* **Manually sync post types**
* **Create a new custom post type**
* **Update an existent post type**
* **View a registered post type**
* **Delete a registered post type**

### Sync operations

Once you install ACPT or ACPT Lite plugin, a sync process with already registered custom post types is performed automatically.

Please note that ACPT imports also post and page posts, which are labeled as "Native".

From the dashboard, you can see a grayish button to operate the sync manually.

The sync process imports every custom post type **with the `show_ui` attribute set to true**.

### Register a new post type

From the main dashboard click on "**Register new Post Type**" button to create a new custom post type:

The creation of a new post type is a three steps process:

* **STEP 1: Basic**
* **STEP 2: Labels**
* **STEP 3: Settings**

#### Basic (Minimum configuration)

This is the most important step. Define here:

* **Post name**: The post name/slug. Used for various queries. ACPT automatically escapes the slug for you.
* **Singular label**: Used only in the admin panel when a singular label is needed
* **Plural label**: Used only in the admin panel for the post type admin menu item
* **Icon**: Displayed on the sidebar of the admin panel
* **Support**: Add support for various available post-edit features. For more info see here.

#### Labels (Additional labels)

Here you can find the labels used only in the admin panel for ordinary Wordpress operations (searching posts, inserting new content, etc…).

The default settings are good in most situations, but feel free to change what you want.

#### Settings (Other settings)

Other important post type settings.

Pay particular attention to the `show_in_rest` parameter — it must be set to `true` to enable the Gutenberg block editor for this post type.

Please refer to the [official WordPress documentation](https://developer.wordpress.org/reference/functions/register_post_type/) for a full description of each setting. Leave the defaults in place unless you have a specific reason to change them.

Once you complete the three steps, the new custom post type will appear in your WordPress admin menu.

Please refer to [official Wordpress documentation](https://developer.wordpress.org/reference/functions/register_post_type/) to get more info about registering new custom post types.

### Update an existing post type

You have two ways to edit a post type:

* Click the **Edit** link in the dashboard.
* Click the **Edit** link in View mode — this takes you directly to the relevant step.

The update process is identical to the creation process, with one exception: the post slug cannot be changed after creation.

### View a registered post type

By clicking the View link in the dashboard you can view a Custom Post Type.

The View mode is divided into three tabs, as the 3-step creation process.

### Delete a registered post type

By clicking the Delete link in the dashboard you can delete a Custom Post Type.

It's very important to understand that this operation DOES NOT DELETE anything on the posts WordPress DB table, but only the ACPT settings. After deleting a custom post type you will no longer display it in the admin panel, even if the post records are still present. If you try to re-create the same post type you will see the old posts.

Please note that you cannot delete Native post types.