Tags

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 page with an Add new tag button, so click on that and the Add new tag sidebar will appear on the right of the screen. If you already have tags, the button is at the top of the list.

In the sidebar, you can enter the details for the new tag and click Add new tag to complete creation.

Tag Options

The options available when adding or editing a tag are separated into groups with several options in each, as follows:

Basic Information

This section covers the basic elements for the Tag. The available options in this section are:

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. Depending on your theme, 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 generated tag lists and individual post pages; the specific tag page for the hidden tag will not be rendered.

Featured Image

The featured image of a tag is the image that can be added at the top of the Tag's page, or anytime a tag is displayed in a showcase should your theme have such a feature. The display of the image, caption and credits depends on your theme. The available options are:

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 set a featured image. 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.

SEO

SEO, or Search Engine Optimisation, refers to options that can be used to customize your Tag's page title and metadata, and provide instructions to search engines. The available options are:

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 tag 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 a custom title for the tag page, which search engines may display in search results. Leave this field blank to use the default title. This option is available regardless of whether indexing is enabled.
Meta Description - Sets a custom meta description, which search engines may use in search results. Leave this field blank to use the default description. This option is also available regardless of whether indexing is enabled.
Meta Robots Index - This option provides instructions to search engine robots, which collect information on sites for search results. Index/Noindex specifies whether the page should be indexed; Follow/Nofollow specifies whether links on the page should be followed. You can also leave this option set to use the site's global settings.
Canonical URL - Sets the preferred URL for the page. If left blank, the default Tag Page URL will be set as the canonical URL. If you enter a custom canonical URL, Publii ignores the tag page's meta robots setting.

Other Options

This section deals mainly with setting which elements of the tag page should be displayed; through the options in this section you can set whether, for example, the featured image is displayed on the tag page or not. The available options depend on your theme. Most of the options here are self-explanatory, but there is one option that should be noted:

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, use the search field at the top of the Tags screen. Searches are dynamic and will filter the list by tag name as you type, so it'll be easy to find what you're looking for.

Tags list filtered by web, with post counts, IDs and a crossed-out eye beside a hidden tag. — Search by name to find a tag. The crossed-out eye marks a hidden tag.

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. Click it and confirm the deletion:

Webdesign and hosting tags selected, with Delete and Hide actions above the list. — Select the tags you want to delete, then click Delete and confirm.

You can also delete an individual tag by opening the actions menu at the right of its row and choosing Delete.

Hiding a Tag

To hide a tag so that it will not be visible on your site (useful if you wish to sort posts into categories for your own tracking), you can follow the same steps as when deleting a tag; in the tag section that displays the list of your tags, click on the checkbox to the left of the tag(s) you wish to hide; an option to Hide the tags will appear to the right of the delete button at the top of the section; click this and the selected tags will be hidden.

To make hidden tags visible again, select them and click Unhide. You can also choose Hide or Unhide from the actions menu at the right of an individual tag's row.

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.

Click Save changes when you're finished. For an existing, visible tag, you can also use Save and preview if your theme supports tag pages.