What are Tag Aliases?

Reader: technical and non-technical staff

This doc contains mixed content for both devs and non-devs.

What is an Alias?

An alias is an alternative word or phrase related to any existing tag. Assuming there is a tag called 21st century design only this exact phrase will get linked. Given that we also want the plural form 21st century designs to be linked to the same content, we can create an alias for 21st century design.

Add an Alias to a Tag

In the example below, if we wanted both 21st century designs and modern designs for this century link to the same content we would add them as aliases.

Tag and alias names are unique, so using an existing name will lead to an error and not result in a successful creation of a new alias.

You can create aliases by typing into the Tag Aliases input field, ending each alias with a comma or hitting Enter. To delete an alias, click the X on the right side of it.

In each case you will need to click Save Aliases to make the changes permanent. If you try to create an alias with the same name as an existing tag, the application will raise a validation error. Saving aliases doesn’t reload the page. It is possible see outdated results. You may need to reload the page to see the latest state of the tag and its aliases.

Relations between Tag & Alias

• an Alias has one parent Tag (always)
• a Tag has many or no Aliases
• an Alias is a Tag that returns true for $tag->isAlias(), which means that it has a parent Tag assigned
• when working with Tag-s, we exclude Alias-es by default using a global scope. If we want them included we have to query with withoutGlobalScope(OnlyParentTagsScope::class)