Post Terms

Displays taxonomy terms (categories or tags) for the current post with text, badge, pill, tag-cloud, or inline-category styles. It is shown in the block inserter as Post Terms and registered as canvas-core/post-terms.

Select the block on a page and its own settings open in the sidebar, in the panels below:

The Post Terms settings in the block editor sidebar

Settings

Each setting is named exactly as the block editor names it, followed by what it does and what it starts as. Where a setting carries a Shown when line, it stays hidden until that condition is met, which is the usual reason a setting looks missing from the sidebar:

Settings

  • Terms FromDefaultThis post

    This post lists the terms assigned to the record in context. The whole site lists every term that has posts: the sidebar tag cloud.

    ChoicesThis postThe whole site

  • Maximum TermsDefault10

    How many terms to list. Site-wide lists take the most used first; a record's own terms keep their own order, so 1 gives the primary term a card chip needs.

  • Chosen TermsDefaultEmpty

    Comma- or newline-separated term slugs, listed in exactly this order. Overrides the maximum above. Leave empty to list by usage.

    Shown when Terms From is "The whole site"

  • OrderDefaultEmpty

    A record's terms are listed alphabetically by default. Choose the attached order when the sequence itself is editorial.

    ChoicesAlphabetical (empty)The order they were attachedShown when Terms From is "This post"

  • Item ClassesDefaultEmpty

    Classes on each term. This is what makes a term a pill, a chip or a plain link.

    Shown when Style is "Bare Chips" or "Tag Cloud" or "Widget List"

  • Written Before Each TermDefaultEmpty

    Text inside each chip, before the term name: a byline that reads "in Travel" or a tag that reads "#travel".

    Shown when Style is "Bare Chips"

  • Current Term ClassesDefaultEmpty

    Extra classes for the term whose archive is being viewed, so a cloud can mark where the reader is.

    Shown when Style is "Bare Chips" or "Tag Cloud" or "Widget List"

  • Show Record CountDefaultOff

    Appends how many records each term holds.

    Shown when Style is "Widget List"

  • Count ClassesDefaulttext-muted

    Classes on the number beside each term, usually a muted colour so it sits behind the name.

    Shown when Show Record Count is on

  • List ClassesDefaultEmpty

    Classes on the list that holds the terms, for the spacing and bullet treatment the design gives it.

    Shown when Style is "Widget List"

  • Wrapper ClassesDefaultEmpty

    Replaces the default classes on the wrapper. A sidebar tag cloud wants a bare tagcloud with no bottom margin.

    Shown when Style is "Tag Cloud" or "Inline Categories" or "Widget List"

  • TaxonomyDefaultcategory

    Which group of terms is listed, such as categories or tags. Custom groups registered by a plugin appear here too.

  • SeparatorDefault,

    What is printed between one term and the next. Include the spaces you want around it.

    Shown when Style is "Text"

  • Link to ArchiveDefaultOn

    Tag Cloud and Inline Categories styles always link.

    Shown when Style is "Text" or "Badge" or "Pill"

  • StyleDefaultText

    How the terms are drawn: a plain run of text for a byline, badges or pills for a card, or a stacked list for a sidebar. The rest of this panel changes with the choice.

    ChoicesTextBadgePillTag CloudInline CategoriesBare ChipsWidget List

Every Canvas block also carries the Animation, Scroll Effects and Advanced panels, which are described in Controls every Canvas block has.

Other blocks in Posts: Blog Archive Loop, Blog Loop, Blog Single Post, Post Archive Index, Post Author, Post Comments.

Was this page helpful?