Skip to content

Import a segment

CSV import allows you to create a segment by uploading a file containing User IDs or Hardware IDs (HWIDs) without needing to specify filtering conditions. This is useful when you have a predefined list of users from external sources.

How to import a segment

Anchor link to

To import a segment from a CSV file:

  1. Go to AudienceSegments, click Create Segment, and select Import segment.
Import segment modal showing Upload CSV step with file upload area
  1. Upload your CSV file. Ensure your CSV file meets the following requirements:
    • Contains User IDs or Hardware IDs (HWIDs) registered for your project. If the CSV file does not contain any User ID or HWID, it won’t create any segment.
    • File size is less than 100 MB
    • If User IDs or HWIDs are not registered for your project, they will be skipped during import.
Upload CSV step completed with option to upload another CSV file
  1. In the Preparing for import step:
    • Enter a Segment name (e.g. vip_clients).
    • Under CSV column with identifiers, select the column that contains User IDs or HWIDs (the identifier values registered in your project). The values in that column must be the actual User IDs or HWIDs.
    • Under System identifier, choose User ID or Hardware ID (HWID) to map that column to Pushwoosh.
    • Click Import.
Import segment modal at Preparing for import step with Segment name, CSV column with identifiers, and System identifier dropdowns
  1. Wait for the import to complete. Processing the CSV file might take some time. You can leave the page while the import completes.
Segments list showing user counts, refresh times, and segment conditions

After the import is finished, the segment will appear in the Segments list.

CSV import tag

Anchor link to

After import, Pushwoosh tags all users or devices from the file with a “CSV import” tag (value is the import timestamp).

CSV import tag shown in segment definition (Seglang) in Segments list

You see this in the Segments list under the segment name and in each user’s profile in User Explorer.

View imported segments

Anchor link to

In the Segments list, you’ll see the segment name, the segment definition, the number of users, the last time the segment size was refreshed, and the modified date.