> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Audience Builder

> A centralized Audiences tab for creating, viewing, and managing all audience segments in the marketplace UI, with three methods to build audiences

export const ChangelogActions = () => {
  return <>
      <style>{`
        .changelog-actions {
          display: flex;
          justify-content: center;
          gap: 12px;
          margin-top: 2rem;
          padding-top: 1.5rem;
          border-top: 1px solid #e5e7eb;
        }
        
        [data-theme="dark"] .changelog-actions {
          border-top-color: #374151;
        }
        
        .changelog-btn {
          display: inline-flex;
          align-items: center;
          gap: 6px;
          padding: 8px 16px;
          border-radius: 9999px;
          border: 1px solid #d1d5db;
          background: transparent;
          color: #6b7280;
          font-size: 14px;
          cursor: pointer;
          transition: all 0.2s ease;
        }
        
        .changelog-btn:hover {
          border-color: #9ca3af;
          background: #f9fafb;
        }
        
        [data-theme="dark"] .changelog-btn {
          border-color: #4b5563;
          color: #9ca3af;
        }
        
        [data-theme="dark"] .changelog-btn:hover {
          border-color: #6b7280;
          background: #1f2937;
        }
      `}</style>
      <div className="changelog-actions">
        <button className="changelog-btn" onClick={() => {
    const btn = event.target.closest("button");
    btn.innerHTML = "❤️ Like";
    btn.style.borderColor = "#ec4899";
  }}>
          🤍 Like
        </button>
        <button className="changelog-btn" onClick={() => {
    const btn = event.target.closest("button");
    navigator.clipboard.writeText(window.location.href);
    const originalContent = btn.innerHTML;
    btn.innerHTML = "✓ Copied";
    btn.style.borderColor = "#22c55e";
    btn.style.color = "#22c55e";
    setTimeout(() => {
      btn.innerHTML = originalContent;
      btn.style.borderColor = "";
      btn.style.color = "";
    }, 2000);
  }}>
          ↗ Share
        </button>
      </div>
    </>;
};

<div className="cl-badge-group">
  <Badge color="gray" size="sm" icon="calendar">
    March 26, 2026
  </Badge>

  <Badge color="blue" size="sm" icon="rectangle-ad">
    Ad Platform
  </Badge>

  <Badge color="green" size="sm" icon="sparkles">
    New Feature
  </Badge>
</div>

## The Problem

Previously, Topsort offered limited ability to create audience segments in the UI, and there was no centralized place for marketplace users to view and manage all existing audiences.

## The Solution

Topsort now offers a powerful new Audience Builder feature, a central place to create and manage segments. The new **Audiences** tab in the marketplace Admin Dashboard displays every audience with its name, source type, and user count in a single table.

From the Audiences tab, marketplace users can create segments using three methods:

* **Upload via CSV**: Upload a file of opaque user IDs directly from your computer. Once processed, the audience appears in the table with its calculated size.
* **Behavioral Audiences**: Build audiences by filtering users based on their past behavior, such as views, clicks, or purchases on specific products or any products within specific categories, within the last 7, 30, or 90 days. Include filters can be combined with ANY (or) or ALL (and), and exclude filters remove unwanted users.
* **Combined Lists** (new): Create a new audience by combining previously uploaded lists using logical rules. Add up to two include groups (each with up to 3 lists) using **Any** (union) or **All** (intersection) logic, connected by OR. An optional exclude block removes users from the final audience.

All audiences, regardless of how they are created, are available to all vendors within the retailer environment and can be used as **boosters** in the campaign creation flow for every ad format. Topsort also offers the ability to [restrict audiences to specific vendors via API](/en/knowledge-base/ad-platform/vendor-management/vendor-scoped-audiences).

## How It Works

<Steps>
  <Step title="Navigate to Audiences">
    Open the **Audiences** tab in the Admin Dashboard sidebar. You'll see a table of all audiences available to your account with their source type and user count.
  </Step>

  <Step title="Create an Audience">
    Click **Create Audience** and choose your method: Upload via CSV, Behavioral Audience, or Combined Lists.
  </Step>

  <Step title="Configure Your Audience">
    Follow the guided flow for your chosen type. For CSV uploads, provide your file. For behavioral audiences, set your include/exclude filters. For combined lists, use include and exclude blocks to layer your existing uploaded lists.
  </Step>

  <Step title="Use in Campaigns">
    Your audience appears in the campaign creation flow as a booster, available across all ad formats and vendors.
  </Step>
</Steps>

<div
  style={{
margin: "3rem 0",
height: "3px",
background:
  "linear-gradient(to right, transparent, #00ff88 20%, #00d4ff 40%, #8280ff 60%, #ff6b9d 80%, transparent)",
borderRadius: "2px",
opacity: "0.6",
}}
/>

Available now. Contact your Topsort account team to enable the Audiences tab, or see the [Audience Segments documentation](/en/knowledge-base/ad-platform/campaign-targeting/segments) for full details.

<ChangelogActions />