Skip to main content

Features > Search Tags: What They Are & How to Use Them

A step-by-step guide to creating, categorizing, and applying app search tags.

Written by Breakthrough Team

Tags are how your content gets found inside your app. They power three different ways users discover what they need — from manual browsing to AI-driven recommendations. This guide walks you through how to think about tags, how to set them up, and how to apply them to your content.

The Filing Cabinet Analogy

Think of your search tags like a simple filing cabinet:

  • Category (the drawer) — the broad theme labeled on the outside. Examples: Difficulty, Focus, Target Area.

  • Tag (the folder) — the specific folder inside that drawer. Examples: Beginner, Stress Relief, Upper Body.

Where Your Tags Go to Work

Organizing your content this way powers three major app features:

  1. Explore Screen (Manual Search) — lets users filter your library directly (e.g., finding a "Beginner" class for "Stress Relief").

  1. Recommended Content Widget — connects user onboarding answers to your content, automatically surfacing relevant items on the Home screen.

  1. Smart Search AI — uses tags to help interpret user requests, especially important for duration-based queries.

Step 1: Plan Your Categories and Tags

Organize tags by Category (broad bucket) and Tags (specific labels). Some examples to start from:

  • Focus / Goal — Stress Relief, Better Sleep, Strength

  • Difficulty — Beginner, Intermediate, Advanced

  • Style — Vinyasa, Pilates, HIIT

  • Target Area — Upper Body, Core, Full Body

  • Time / Duration — Quick, 5 minutes, 60 minutes

⚠️ Duration tags are critical for Smart Search. The AI reads your video transcripts, titles, and descriptions to understand meaning, but it doesn't automatically check the video's actual length. Time tags are what let it pull the right content for duration-based requests like "give me a 10-minute class."

Suggested Prompt to generate your starter tag list

Paste this into your AI assistant of choice:

"I am building a wellness app. Here is my app's description and typical content: [insert description + any other relevant info]. Please provide a list of 15–20 search tags organized by category (Focus, Difficulty, Style, Body Part, Duration). These tags will categorize my content and help recommend it to users."

Step 2: Create the Tags in the Portal

  1. Go to Features → Search Tags

  2. Click + Add Search Tag Category to create your broad buckets

  3. Click the + icon next to your new category to add individual tags

Step 3: Apply Tags to Your Content

Tags don't do anything until they're attached to media. To tag a piece of content:

  1. Go to Content → Library

  2. Select the type of content you want to update (Video Classes, Audio Classes, Routines, etc.)

  3. Click the edit (pencil) icon next to the piece of content

  4. Scroll to the Search Tags section and select all tags that apply

  5. Click Update to save

💡 Quick tip: Tag every piece of content with at least one tag from each major category (Focus, Difficulty, Style, Duration). The more complete your tagging, the better all three features perform.


Did this answer your question?