Custom tags allow you to create and apply custom properties/metadata that go beyond those already supported in ItemLogic (e.g., Grade, Subject, Flesch-Kincaid, etc.). For example, you can create tags for additional custom properties such as "Passage Copyright Expires Date" or "Item Content Focus" or whatever properties you need for any asset. Once custom tags are created, developers and others with editing access can apply the tags to items, resources (passages, videos, graphics) or assessments.
Tags are flexible. They can be textural, numeric, or date-based. A tag can be used on any type of asset (items, resources, tests/assessments) or can be restricted to only certain types.
Creating a Custom Tag
To create a new tag:
Click the Globe icon on the navigation bar, and choose a workspace.
From the left side, select the Tags panel.
Click into the text box that says “Add new tag…”
Editable properties for the tag appear.
Fill in the properties as follows:
- In “Tag Label…” field , enter a name for the tag. (Required)
- If the values for this tag are to be numeric or date-based rather than textural, choose “Numeric” or “Date” instead of “Text” from the drop-down menu .
- Select all options that apply : Permitted (able to be applied to an asset - checked by default), Required (alerts editors that this must be applied to an asset), Multi-Valued (more than one value is allowed for this tag)
- In the “Description” field , enter some text that describes this tag. When the tag becomes available for applying to an asset, this description will appear as a tooltip for the asset. This lets users know the intention of the tag.
- In the “Allowed Values” field , enter possible values for the tag, hitting enter after each value. Each value becomes a chip in the field.
- Restrict to asset types : Select a type of asset in the “Restrict to asset types” field if this tag should not apply to all assets.
Click Save. The tag appears on the listing.
If "Permitted" is checked, it becomes available to all users once you save it.
The tag listing shows the number of assets on which the tag is applied:
Editing a Tag
Tags may be edited, but there is one restriction and other considerations:
- You may edit a tag’s description and values, but you cannot change the data type. For example, if you created the tag as a text type, you cannot change it to numeric. Instead, create a new tag with the correct text type and delete the other one.
- If you change a tag that has already been applied to an asset, bear in mind the following:
- If you deselect the “Permitted” field, the tag is no longer available for applying to assets. However, any assets that already have the tag applied to it will keep the tag. You may want to consider removing a tag from any assets to which it is applied if you are not permitting it to be applied to assets going forward.
- If you change a tag's restriction so that it no longer applies to an asset already having the tag, the asset will keep the tag. You may want to consider removing the tags from any assets to which they are applied if you are no longer allowing the tags to be applied to that type of asset.
To edit a tag:
- Click the navigation bar Globe icon, and choose a workspace.
- Select the Tags panel.
- Click the tag you want to edit. The property fields and values appear.
- Make necessary changes and click Save.
Updated tag values are immediately available for applying to assets.