How to Sync Milestones in Asana

    How to Sync Milestones in Asana

    This article describes how to mark tasks as milestones in Asana through synchronization scripts.

    Milestones in Asana: Milestones are tasks that represent important project checkpoints. They appear with a diamond icon and are displayed prominently in Timeline views.

    Incoming sync (Remote system → Asana)

    To mark a task as a milestone in Asana:

    entity.customFields."milestone".value = "true"

    To convert a milestone back to a regular task:

    entity.customFields."milestone".value = "false"

    Outgoing sync (Asana → Remote system)

    To send milestone status from Asana to the remote system:

    replica.customFields = entity.customFields

    Reading milestone status

    To check if an incoming task is a milestone:

    def isTaskMilestone = replica.customFields."milestone"?.value == "true"
    
    if (isTaskMilestone) {
        // Handle milestone logic
        entity.summary = "🔷 " + replica.summary
    }

    More information

    Have more questions? Ask the community