Tags & Filtering
Organize your menu items with custom tags for better management and filtering.
What Are Tags?
Tags are custom labels you create to organize items:
- Dietary tags - Vegetarian, Vegan, Keto
- Feature tags - Chef’s Special, New, Seasonal
- Internal tags - Needs Photo, Review Pending
- Category tags - Gluten-Free Options, Kid-Friendly
Tags help you:
- Filter the items table quickly
- Apply bulk actions to related items
- Organize items beyond menu sections
Creating Tags
From the Items Page
- Navigate to Menus > Items
- Click any item to open the edit panel
- Go to the Tags section
- Type a new tag name
- Click Create “[tag name]”
- The tag is created and applied
From Tag Management
- Navigate to Menus > Items
- Click the Tags button in the toolbar
- Click Create Tag
- Enter the tag name
- Choose a color
- Click Save
Tag Colors
Each tag has a color for visual identification:
| Color | Suggested Use |
|---|---|
| Gray | Default, neutral |
| Red | Warnings, allergen-related |
| Orange | Attention needed |
| Yellow | Seasonal, limited time |
| Green | Dietary, healthy options |
| Blue | Features, specials |
| Purple | Premium, exclusive |
| Pink | Kids, family-friendly |
Colors are for your reference; diners don’t see tag colors.
Applying Tags
To a Single Item
- Open the item edit panel
- Scroll to Tags
- Click in the tag input
- Select existing tags or create new ones
- Click Save
To Multiple Items (Bulk)
- Select items using checkboxes
- Click Add Tag in the bulk action bar
- Select the tag to apply
- Confirm the action
Removing Tags
From one item:
- Open the item
- Click the X on the tag badge
- Save
From multiple items:
- Select items
- Click Remove Tag in bulk actions
- Select the tag to remove
- Confirm
Filtering by Tags
Include Filter
Show items that HAVE specific tags:
- Click the Tags filter in the toolbar
- Select tags to include
- Table shows only items with those tags
- Select multiple tags to show items with ANY of them
Exclude Filter
Hide items that HAVE specific tags:
- Click the Exclude Tags filter
- Select tags to exclude
- Items with those tags are hidden
- Useful for hiding “Needs Review” items
Combining Filters
Use both filters together:
Include: "Vegetarian"
Exclude: "Needs Photo"
→ Shows vegetarian items that have photosSystem Tags
Atlee automatically applies certain system tags:
| Tag | Meaning |
|---|---|
_combo | Item is a combo |
_variant-option | Item is used as a variant option |
_component | Item is a combo component |
System tags:
- Start with underscore
- Cannot be edited or removed
- Help filter item types automatically
- Are hidden from public menu
Filtering System Tags
Use system tags to manage item types:
- Hide variant options: Exclude
_variant-option - Show only combos: Include
_combo - Find orphan components: Include
_component
Tag Best Practices
Naming Conventions
- Keep names short: “Vegan” not “Suitable for Vegans”
- Use consistent capitalization: “Spicy” or “spicy”, not both
- Avoid duplicates: One “Vegetarian” tag, not multiple
Organization Tips
- Create tags before you need them - Plan your tag structure
- Use sparingly - Too many tags reduces usefulness
- Review periodically - Remove unused tags
- Document internally - Team should know what each tag means
Suggested Tag Sets
By Dietary Restriction:
- Vegetarian, Vegan, Gluten-Free, Dairy-Free, Nut-Free
By Feature:
- New, Seasonal, Limited Time, Chef’s Special
By Status (Internal):
- Needs Photo, Needs Review, Price Check, Discontinued
By Meal:
- Breakfast, Lunch, Dinner, All Day
Managing Tags
Editing a Tag
- Click Tags in the toolbar
- Find the tag in the list
- Click the edit icon
- Change name or color
- Save
Changes apply to all items with this tag.
Deleting a Tag
- Click Tags in the toolbar
- Find the tag
- Click the delete icon
- Confirm deletion
The tag is removed from all items. This cannot be undone.
Before deleting, you’ll see how many items have this tag.
Tags vs. Categories
| Tags | Categories |
|---|---|
| Multiple per item | One per item |
| Flexible, ad-hoc | Structured hierarchy |
| For management | For menu display |
| Internal use | Public facing |
Use categories for menu organization (Appetizers, Entrees). Use tags for internal management (Needs Review, Seasonal).
Common Questions
Can diners see tags? No. Tags are internal only. Use item descriptions for diner-facing labels.
How many tags can an item have? No limit, but keep it reasonable (5-10 max recommended).
Can I import items with tags? Not directly via CSV. Import items first, then apply tags via bulk actions.
Do tags affect search? Yes. Search includes tag names, so “vegetarian” matches items with that tag.