How to Sync Custom Fields in Asana
This article describes how to synchronize custom fields between Asana and other systems.
Custom Fields in Asana: Asana supports text, number, date, single-select, multi-select, people, and currency custom field types. All types use the same synchronization syntax.
Outgoing sync (Asana → Remote system)
To send custom fields from Asana to the remote system:
// Send all custom fields
replica.customFields = entity.customFields
// Or send specific custom fields
replica.customFields.Priority = entity.customFields.Priority
replica.customFields."Story Points" = entity.customFields."Story Points"Incoming sync (Remote system → Asana)
To receive custom fields from the remote system and set them in Asana:
// Text fields
entity.customFields."Text field".value = "Task details here"
// Number fields
entity.customFields."Story Points".value = 5
// Date fields (must use YYYY-MM-DD format)
entity.customFields."Project Start".value = "2025-12-31"
// Single-select fields
entity.customFields."Priority".value = "High"
// Multi-select fields (comma-separated)
entity.customFields."Skills".value = "JavaScript, Python"
// People fields (email addresses)
entity.customFields."Reviewer".value = "john.doe@company.com"Date Format: Date custom fields must use YYYY-MM-DD format. Multi-select fields use comma-separated values. All values must match existing options in Asana.
More information
- How to Sync Tasks in Asana
- How to Sync Projects in Asana
- Asana Fields and Entities Available for Synchronization
Have more questions? Ask the community