Post Types and Custom Fields

How to get there: Go to Post Types in the admin (under Settings or the Post Types page directly).

Post types let you categorize posts into distinct kinds (such as Feature Request, Bug Report, or Question) and attach different custom fields to each type.

Creating a Post Type

  1. Click Add Post Type.
  2. Enter a name (e.g. "Bug Report", "Feature Request").
  3. Optionally check the boards this type should be available on (users can only pick the type when submitting on those boards).
  4. Click Save.

The new post type appears in the list. You can rename it with the pencil icon, delete it with the trash icon, or copy its direct submission link with the link icon.

Assigning post types to boards

Each post type has a Boards setting that controls which boards expose this type on the submission form. If a post type isn't assigned to any board, you'll see a warning marker; users won't be able to submit posts of that type until you assign at least one board.

To change board assignments, click Settings under the post type and toggle the boards.

Auto-assign categories

Each post type can be linked to one or more categories. When a user submits a post with that type, the selected categories are automatically assigned. Open the Settings section underneath a post type and check the categories to enable this.

Adding custom fields

Custom fields collect structured information from users when they submit a post of a given type. Each post type has its own set of fields.

  1. Click Add Field under a post type.
  2. Configure the field:
    • Name -- the label shown to the user (e.g. "Steps to Reproduce").
    • Type -- choose from:
      • Text -- a rich text editor (formatting, links, lists).
      • Textarea -- a multi-line text box. Optionally enable Rich text to upgrade it to the same editor as Text.
      • Dropdown -- a list of predefined options. Enter the options separated by commas.
      • Number -- a numeric input.
      • Checkbox -- a yes/no toggle.
    • Required -- when checked, users must fill in this field before submitting.
  3. Click Add.

Fields appear on the post submission form whenever the user picks that post type. Edit a field with the pencil icon, delete it with the trash icon.

Reordering fields

Each field row has a drag handle (the dotted icon on the left). Drag fields up or down to change the order they appear in on the submission form. The new order is saved automatically.

Each post type has a copy-link button that gives you a URL like /new?post_type=123. Share this link to send users directly to the new-post form with that post type pre-selected.