Tag Categories

Instead of standard categories that you may be used to, Publii uses Tags, which are keywords that apply to a post. A post can have multiple tags attached to it, so even if your post covers many subjects readers will be able to find it.

To create a new tag, click on the Tags option in the left-sidebar menu. If you haven't got any tags, then you'll see a plain page with a big Add new tag button, so click on that and the Add new tag sidebar will appear on the right of the screen.

There are view options available for each tag, as follows:

  • Name - Enter the name for your tag here.
  • Description - Put a description for your tag here, such as the type of content that it is associated with. The text entered here will be shown on the individual tag page on your site, which lists all the posts in a particular tag.
  • Hide Tag - This option allows you to hide a tag from all post listings and individual post pages. Also, the page with the hidden tag doesn't render.
  • Featured Image - The featured image usually appears at the top of the tag page and is also used as the tag-preview picture. To add a featured image to your tag you can either drag and drop an image onto the Featured Image box, or click on the Choose File button to open a file explorer window to select a photo from your computer.
  • Alternative Text - This option is only available if you have a featured image set. Here, you can add text that will be displayed if the image cannot load, or read by a screen-reader used by visually-impaired users to describe the photo.
  • Caption - Another featured-image-only option, text added here will be added as a caption under the photo.
  • Credits - Name or other text added here will appear as a credit, letting people know who took the picture or owns the copyright if it is not your own.
  • Slug - The name you enter here should be link-friendly; that is, it shouldn't contain any spaces or special characters as it will be used for links on your website e.g. if you have a category called "Latest News", then the slug might be "latest_news". The slug will be generated automatically if this field is left empty.
  • Page Title - Sets the meta title (which is used for SEO purposes and will be displayed in search engine results); indexing must be enabled in the Publii settings before this option can be used.
  • Meta Description - Set the meta description, which functions similarly to the meta title. Again, indexing must be enabled to use this option.
  • Custom Template - Sets the template layout to be used by the tag page; different themes may include only one default template, or multiple alternatives.

Finding a Tag

As you add new tags they will be listed on the opening Tags screen that you see when clicking on the Tags option in the left-sidebar. By default, the tags are listed from newest to oldest, but you can easily switch the order by clicking on the column header e.g. by clicking on the ID header, you can sort your tags by order of creation (as each new tag is created it is assigned an ID, starting from '1' for the first tag). 

If you have a large number of tags and need to find a specific one, you may use the Search option by clicking on the magnifying glass icon that is next to the Tags title at the top of the page. Searches are dynamic and will filter the list as you type, so it'll be easy to find what you're looking for.  

Deleting a Tag

To delete a tag, on the list of tags that you first see when opening the tag page, click on the checkbox to the left of the tag you want to delete; once a check is added the delete option will appear as a Delete button at the top of the section:

Deleting tags

Editing a Tag

Editing a tag is basically the same as adding a tag, except that the options are already filled out! To open the Edit Tag sidebar, simply click on the name of the tag that you wish to modify.