# Segments

<figure><img src="https://2886427578-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_L2jrbLGTIbcnHMUrm%2Fuploads%2Fcey1Qgb9n1IyOmPoPgzX%2FSegmenty.png?alt=media&#x26;token=944796d2-0c52-4b67-b7f7-a0a62fd7943d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can create up to 5 segments in each project.
{% endhint %}

Segments allow you to create conditions based on [Labels](https://docs.pushpushgo.company/subscribers/labels). The latter determine if a subscriber belongs to a given segment.

Each segment has its properties:

&#x20;\- **name** - unique within a project

&#x20;\- **status** (draft, building, or ready) - every created segment is in the ‘building’ status and becomes ‘ready’ after it's calculated

&#x20;\- **audience** - a precise number of current subscribers in a segment

After defining a segment, the building process begins. It may take a while - we need to scan each subscriber in the base and match them with the segment conditions. When the process ends, the segment switches to ‘ready’. It displays the number of subscribers within it. You can send messages to them.

Every time you change or add labels to a subscriber, it causes changes in the segments. They are rebuilding in real-time, following new subscriber descriptions per labels.

Segments allow you to send a push to a selected group much faster than [other targeting options](https://docs.pushpushgo.company/campaigns/push-campaign).

You can find segments defined for a project in the Segments view.:

<figure><img src="https://2886427578-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_L2jrbLGTIbcnHMUrm%2Fuploads%2FMTJLvhrZo5OcHUKzrY6m%2Fimage.png?alt=media&#x26;token=6601417b-3a7e-4521-b9c9-e6334403d02e" alt=""><figcaption></figcaption></figure>

You can search segments by name or sort them, either alphabetically or chronologically (by creation date). The view allows you to delete, copy, and edit segments. You can create a campaign for a given segment with a ‘ready’ status by clicking on a green button with an arrow sign.

<figure><img src="https://lh4.googleusercontent.com/0EkP-2EESEz2dqpRVtJLp_lOAxtXpoqUEfsTm33OdkOEVRUloXkZT35jei5Yz7ioagxFZh83WgnucAqdkB8lzZZ2tLCHU3Bygse_u7XC0EmiTFCFEopSIcSRxR1SeJj6mrzNvzCddb7tctL-CseSGghKNxsHVuvCl4FZoVu0EQp4hWyd2Fnv1ZgREw" alt=""><figcaption></figcaption></figure>

Deleting a segment won't be possible if it’s currently used in a planned campaign, a saved draft, or in a campaign that’s being sent. It prevents unnecessary complications and errors in campaigns.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pushpushgo.company/subscribers/segments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
