Topic Catalog

The AudienceGPT global catalog is the master collection of all audience topics in the system. It contains every classified topic across all taxonomy types, parent categories, and subcategories. Your organization library is a curated subset of this catalog -- the topics your team has selected, imported, or classified for your specific use cases. The catalog serves as the source of truth, and you draw from it to build your library without duplicating classification work that has already been done.

Global Catalog vs. Organization Library

Understanding the distinction between these two collections is fundamental to working with AudienceGPT.

Aspect	Global Catalog	Organization Library
Scope	All topics in the system	Your org's selected subset
Ownership	Shared across all organizations	Scoped to your organization
Access	Read-only browse and search	Full management (edit, activate, export)
Population	Admin seeding, imports, classification	Added from catalog, imports, or classification
Duplicates	Deduplicated globally via embeddings	Linked to global topics (no local copies)

When you add a catalog topic to your library, AudienceGPT creates a link between your organization and the global topic record. This means that when a topic is reclassified or updated globally (for example, after an engine version upgrade), your library automatically reflects the latest data.

info

Adding a topic from the catalog does not create a copy. Your library entry points to the same global topic, so classification updates propagate automatically.

Browsing the Catalog

Navigate to Taxonomies in the sidebar or visit /taxonomies to open the global catalog browser. The catalog presents topics in a searchable, filterable table with the following columns:

• Topic Name -- the human-readable name of the audience segment
• Taxonomy Type -- one of the 13 top-level groupings (e.g., "Automotive & Vehicles", "Technology & Telecom")
• Parent Category -- one of the 41 specific types within a taxonomy type (e.g., "Auto", "Business Technology")
• Subcategory -- the subcategory label within the parent category
• Segment Type -- B2B or B2C classification
• Engine Version -- the classification engine version that produced the current data

Searching

The catalog search bar supports multi-word queries with AND matching. Each word in your query must appear somewhere in the topic record for it to match. This means more specific queries yield more precise results.

Query	Behavior
electric vehicles	Returns topics containing both "electric" AND "vehicles"
insurance health	Returns topics containing both "insurance" AND "health"
BMW	Returns all topics mentioning "BMW"

Type your search terms and press Enter or wait for the automatic search trigger. Results update in the table below.

Filtering by Facets

The catalog provides four filter facets that you can combine to narrow your results:

1. Taxonomy Type -- Select from the 13 top-level groups (e.g., "Automotive & Vehicles", "Financial Services", "Health & Wellness")
2. Parent Category -- Select from the 41 specific types within those groups (e.g., "Auto", "Health Insurance", "Fintech")
3. Segment Type -- Filter by B2B or B2C
4. Subcategory -- Filter by subcategory labels within the selected parent category

Filters are additive -- selecting a taxonomy type and a segment type shows only topics that match both criteria. Clear individual filters by clicking their remove button, or reset all filters at once.

tip

Start broad and narrow down. Select a taxonomy type first, then refine with parent category and subcategory filters to find exactly the topics you need.

Adding Catalog Topics to Your Library

Once you have found topics in the catalog, you can add them to your organization library individually or in bulk.

Individual Addition

Click on any topic row in the catalog to open its detail view. If the topic is not already in your library, you will see an Add to Library button. Clicking it links the topic to your organization immediately.

Bulk Addition

For adding multiple topics at once:

1. Use the checkboxes on the left side of the catalog table to select the topics you want
2. The selection toolbar appears at the top showing the count of selected topics
3. Click Add Selected to Library to link all selected topics to your organization in a single operation

Topics that are already in your library appear with a disabled checkbox and an "In Library" badge, preventing accidental duplicate additions. New topics (not yet in your library) are pre-selected by default when using the conversational catalog browse feature.

warning

Bulk additions are processed as a batch. If you select a large number of topics, the operation may take a few seconds to complete. Do not navigate away until the confirmation appears.

Conversational Catalog Browse

In addition to the dedicated catalog page, you can search and add catalog topics directly from the AudienceGPT chatbot on the /classify page. This feature lets you use natural language to describe the topics you need, and the system responds with an interactive card of matching results.

How It Works

1. Type a natural language query in the chat input. Phrases that trigger catalog browse include:

   • "Show me auto topics"
   • "I need insurance segments"
   • "Add all automotive topics"
   • "Find B2B technology segments"
   • "What health and wellness topics are available?"

2. Review the inline results card. AudienceGPT searches the global catalog based on your query and displays matching topics in an interactive card directly in the chat. Each topic shows its name, taxonomy type, parent category, and segment type.

3. Select topics using checkboxes. The card includes:

   • Individual checkboxes for each topic
   • A Select All / Deselect All toggle
   • Pagination controls if there are many results
   • Topics already in your library are disabled with an "In Library" badge
   • New topics are pre-selected by default

4. Add selected topics by clicking the Add N Selected button at the bottom of the card. The selected topics are linked to your organization library.

Catalog Filters in Chat

The AI assistant extracts structured filters from your natural language query. Behind the scenes, these map to the same facets available on the catalog page:

Natural Language	Extracted Filter
"auto topics"	parentCategory: "Auto"
"B2B technology"	segmentType: "B2B", taxonomyType: "Technology & Telecom"
"health insurance segments"	search: "health insurance"
"financial services"	taxonomyType: "Financial Services"

You can refine your results by sending follow-up messages. The chat maintains context, so you can say things like "now filter those to B2B only" or "show me more results" to paginate.

tip

The conversational catalog browse is the fastest way to populate your library when you know what category of topics you need. Instead of navigating to the catalog page and manually applying filters, describe what you want in plain English and select from the results.

Pre-Selection Behavior

When the catalog browse card appears in chat, the system applies intelligent pre-selection:

• New topics (not in your library) are checked by default, so you can quickly add them with a single click
• Existing topics (already in your library) are unchecked and disabled -- you cannot accidentally add them again
• You can deselect any pre-selected topics before confirming the addition

Next Steps

• Data Hygiene -- Monitor the health of your library topics and activated segments
• Platform Connections -- Set up connections to external platforms for sync and activation
• Segment Activations -- Push your library topics to DSPs as activated segments