ML Tag List

The ML Tag List is a lightweight property editor for managing a simple collection of text entries, often used for tags, keywords, or simple lists.

⚙️ Configuration

Configure the editor in the Umbraco Data Type settings:

• Max Items: Maximum number of items allowed in the list.
• Max Length: Maximum characters allowed per individual item.
• Allow Duplicates: If enabled, the same value can be added multiple times.
• Sort Alphabetically: If enabled, the list will be automatically sorted A-Z.
• Display as Tags: Show the items as interactive pills/tags instead of a simple vertical list (Default: true).

💻 C# Data Retrieval (Value Converter)

The ML Tag List comes with a built-in Value Converter that returns a collection of strings:

var tags = content?.Value<IEnumerable<string>>("myTagList");
// Example Result: ["Umbraco", "CMS", "ModuLabry"]

✅ Validation

The ML Tag List fully integrates with the Umbraco validation system:

• Support for mandatory state (must have at least one item).
• Enforces the Max Items limit.
• Individual items are validated against the Max Length setting.

📝 Storage Note

In the database, the values are stored as a semicolon-separated string. The Value Converter automatically handles the conversion to IEnumerable<string> for you.

✨ Features

• Quick Entry: Add items by typing and pressing Enter.
• Interactive Pills: Optionally render entries as stylised tags for better visual feedback.
• Duplicate Prevention: Configurable option to ensure unique entries.
• Auto-Sorting: Keep your list organized alphabetically.