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

# Audiences: Group Students with Lists and Segments

> Group students into manually curated Lists and self-updating rule-based Segments, then target them across course access and the Newsfeed

Audiences let you group your students so you can act on them as a set: grant a group access to a course, or send them a targeted Newsfeed post. You build audiences from the **People** area of your academy, which has three tabs: **Students**, **Lists**, and **Segments**. Lists are groups you curate by hand. Segments are saved filters that recompute themselves as students match your rules.

<CardGroup cols={2}>
  <Card title="Lists" icon="users">
    A curated group of students you add and remove yourself, by hand or via CSV import. Membership only changes when you change it.
  </Card>

  <Card title="Segments" icon="filter">
    A saved filter (for example, "stalled in Sales 101"). Membership is computed from your rules and stays current as students enroll, progress, and complete.
  </Card>
</CardGroup>

## Where to find audiences

Open **People** from the owner sidebar. The tab bar switches between your **Students**, your **Lists**, and your **Segments**. Lists and Segments both live under the same People area, so you are always looking at three views of the same people.

## Lists

A List is a hand-picked group of students. Use one whenever you want a stable set you control directly, such as VIP clients, a cohort, or a beta group.

### Create a list

<Steps>
  <Step title="Open the Lists tab">
    In **People**, select **Lists**, then choose **New list**.
  </Step>

  <Step title="Name it">
    Give the list a name (for example, "VIP clients") and an optional description so you remember what it is for.
  </Step>

  <Step title="Add members">
    You land on the new list, ready to add students.
  </Step>
</Steps>

### Add and remove members

From a list's detail page, use **Add members** to choose how members join:

<CardGroup cols={2}>
  <Card title="Add students" icon="user-plus">
    Pick from your existing academy students. Only people who are already students in this academy appear in the picker, and anyone already on the list is filtered out.
  </Card>

  <Card title="Import from CSV" icon="upload">
    Upload a CSV with an `email` column (a `name` column is optional). Emails that match an existing academy student are added; any that do not match are reported back to you so you can follow up.
  </Card>
</CardGroup>

To remove someone, use the remove control on their row. Removing a member, or deleting the whole list, never touches the student's account, enrollments, or course progress. It only changes who the list targets, and you can add a member back at any time.

<Note>
  Lists populated by CSV or from outside the app show a source badge (**CSV import** or **Synced**); hand-curated lists show no badge. Lists created and managed through the API show as **Synced**.
</Note>

### Lists and course access

To give a group of students course access, grant them an [offer](/docs/payments/offers): from each student's **Access** tab, or by attaching the offer to their invitations so they arrive with it. Access granted this way is per student, so you stay in control of exactly who holds what.

You can also connect an offer directly to a manual List from the offer's **Members** tab. Everyone on that List holds the offer for as long as they remain a member. Add someone and the covered courses unlock; remove them and that path to access ends.

<Warning>
  Because a list can carry access this way, deleting one ends whatever its members were getting through it.
</Warning>

Offers students purchase manage their own member lists automatically; those do not appear here. See [Managing Students](/docs/students/managing-students) for access and progress.

## Segments

A Segment is a saved filter that defines its membership from rules instead of a hand-picked list. You never add or remove members directly: students fall in and out of a segment automatically as they match (or stop matching) the rules. Segments are computed on demand from current enrollment, progress, and completion data, and they always include only students with active access in your academy.

### Build a segment

<Steps>
  <Step title="Start a new segment">
    In **People**, select **Segments**, then choose **New segment**.
  </Step>

  <Step title="Name it and add conditions">
    Give it a name (for example, "Stalled in Sales 101") and add one or more conditions.
  </Step>

  <Step title="Choose how conditions combine">
    Set **Include students matching** to **All** (students must meet every condition) or **Any** (students who meet at least one).
  </Step>

  <Step title="Check the live preview, then save">
    As your conditions become valid, a live preview shows how many students currently match plus a small sample. Save when it looks right.
  </Step>
</Steps>

### Available conditions

You can build a segment from these rules:

<AccordionGroup>
  <Accordion title="Enrollment">
    * **Enrolled in course**: actively enrolled in a chosen course
    * **Enrolled before date**: enrolled before a date you pick
    * **Enrolled after date**: enrolled on or after a date you pick
    * **Enrolled in last N days**: enrolled within a rolling window of days
  </Accordion>

  <Accordion title="Progress and completion">
    * **Completed course**: finished a chosen course
    * **Completed lesson**: finished a chosen lesson
    * **Course progress**: progress in a chosen course compared against a percentage (for example, less than 25%)
  </Accordion>
</AccordionGroup>

<Tip>
  Combine conditions with **All** to narrow a segment (enrolled in a course **and** under 50% progress), or **Any** to widen it (completed course A **or** course B).
</Tip>

<Note>
  If a condition points at a course or lesson you later delete, that condition simply matches nobody, and the segment editor flags it so you can fix or remove it.
</Note>

## Targeting an audience

Once a list or segment exists, you can target it in two places:

<CardGroup cols={2}>
  <Card title="Course access (Lists only)" icon="shield-check">
    A List can carry an [offer](/docs/payments/offers): use **Grant to a list** on the offer's Members tab, and membership drives who holds it (see above). Segments cannot gate access; they are for messaging and insight.
  </Card>

  <Card title="Newsfeed posts" icon="megaphone">
    In the [Newsfeed](/docs/engagement/newsfeed) composer, send a post to **Everyone** or target specific Lists or Segments.
  </Card>
</CardGroup>

## Manage lists from the API

The same Lists you see in the People area are exposed through the public [Lists API](/docs/api-reference/lists). The API and the UI operate on one set of lists: a list created or updated through the API appears here (marked as synced), and a list you build here can be read and updated through the API. Use the UI for hands-on curation and the API when you want another system to keep a list in sync.

<Info>
  Creating audiences can be subject to your plan's entitlements. If you hit a limit while creating one, the app will tell you and point you to your plan.
</Info>