Register segments using a taxonomy file

Integration Partners
Last Updated: July 30, 2026•

Before you begin: Grant Index access to your Amazon S3 bucket or your Google Cloud Storage bucket.

Register all your segments in the Index ecosystem. If the segment data file contains any new segments, you must first register them using a taxonomy file. The taxonomy file has a maximum size of 30 kB. If all segments cannot fit within this limit, we recommend using multiple taxonomy files. Both the externalSegmentID and externalSegmentName are limited to 255 characters and must use UTF-8 encoding.

  1. Create the taxonomy file using the valid taxonomy file structure. Taxonomy files must be valid JSON and follow this structure:

    { 
	"version": "2.0", // The version which must be "2.0"
	"segments": [  
		{ 
			"externalSegmentID": "segment_id_1", // The external-facing segment identifier
			"externalSegmentName": "Segment Name 1", // The human-readable name
			"accountID": 1234567 // The Index generated account ID for the owner of the segment.
		}, 
		{ 
			"externalSegmentID": "segment_id_2", // The external-facing segment identifier
			"externalSegmentName": "Segment Name 2", // The human-readable name
			"accountID": 2345678 // The Index generated account ID for the owner of the segment.
		} 
	] 
}

  2. Upload the taxonomy file to your designated bucket and the specific metafiles/ folder.

    After you finish: Create the segment data files to upload.