Basic Usage
1. Drag the Tag Input Pro element onto your page.
2. Configure the appearance and behavior in the property editor.
3. Users can start typing to create tags.

Creating Tags

Tags can be created using the separators you enable in the element settings:

• Enter  
• Comma  
• Tab  
• Space  

All separators are optional and can be enabled or disabled individually.

Removing Tags

Click the delete icon on a tag.

Reordering Tags

Enable drag mode to allow users to reorder tags by dragging them.

States

The element exposes several states that can be used in workflows:

• tags_list — list of all tags  
• tags_json — tags formatted as JSON  
• tags_csv — tags formatted as comma-separated text  
• tags_count — number of tags currently present  
• input_value — current value typed in the input field  
• input_length — number of characters currently typed  
• is_typing — indicates whether the user is currently typing  

Events

The element triggers the following events:

• tag_added — triggered when a tag is created  
• tag_removed — triggered when a tag is removed  
• tags_changed — triggered whenever the tag list changes  
• typing — triggered while the user is typing  

Element Actions

The plugin includes actions that allow workflows to control the element:

• Add Tag — add a tag programmatically  
• Remove Tag — remove a specific tag  
• Set Tags — replace the current tags with a new list  
• Clear Tags — remove all tags  
• Clear Input — clear the current text inside the input field  

These actions allow tags to be controlled from workflows.

Building Custom Suggestions

You can create your own autocomplete dropdown using Bubble elements such as Group Focus or Repeating Groups.

Use the input_value state to search your database or API and display suggestions.

Example approach:

1. Show a suggestion group when is_typing is yes.
2. Search your database using input_value.
3. Display results in a repeating group.
4. When a user clicks a suggestion, trigger the Add Tag action.

This allows you to build fully custom suggestion interfaces using Bubble's native design tools.