---
sourceDocument: Australia Build workflows
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/build-workflows

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build workflows

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# Array.Object data type

# Array.Object data type {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Store a sequence of JavaScript objects in an array.

## Basic options {#array-object-data__section_hxc_yc4_dlb}

{#array-object-data__table-basic-data-options__entry__2}{#array-object-data__basic-data-label}{#array-object-data__basic-data-name}{#array-object-data__basic-data-type}{#array-object-data__basic-data-mandatory}

| Option | Description |
|-|-|
| Label | Displays the label used to identify the data variable in the Workflow Studio interface. The label can consist of any text. |
| Name | Displays the name used to identify the data variable in script calls. The name can only consist of alphanumeric and underscore characters. The system automatically converts the label into a valid name by removing or replacing any special characters. |
| Type | Indicates the type of data stored by the data variable. |
| Mandatory | Indicates whether the data variable must contain a value when configured in an action. |
[ ]

{#array-object-data__table-basic-data-options}

## Advanced options for Array variables {#array-object-data__section_djv_yc4_dlb}

{#array-object-data__table_gkd_5t3_dlb__entry__2}

| Option | Description |
|-|-|
| Hint | Provides guidance to flow or action designers on how to configure the data. |
| Max rows | Specifies the maximum number of entries to display in the Workflow Studio interface. The array can store more values than it displays. |
[ ]

{#array-object-data__table_gkd_5t3_dlb}

## Advanced options for Object variables {#array-object-data__section_e2d_tpc_glb}

{#array-object-data__table_vky_jd4_dlb__entry__2}

| Option | Description |
|-|-|
| Structure | Specifies how to structure the object hierarchy. Options include: * Create Structure Manually * Start from Template {#array-object-data__ul_mfh_nkw_jhb} Note: Creating the structure manually enables the Save as Template option. Starting from a template enables the Template option |
| Save as Template | Stores a manually created object structure for later reuse. |
| Template | Specifies the existing object structure to apply to this object. |
[ ]

{#array-object-data__table_vky_jd4_dlb}  
Note:  
For more information on using complex object variables, see [Complex data](https://servicenow-prod.fluidtopics.net/tYVT1pPJOWkjWSc3dPFAWQ "Use a graphical interface to work with collections of complex structured data. Help design users understand the organization of structured data, and add, remove, or configure its individual elements.").  

## Create a list of contacts from a list of users {#array-object-data__example_zxg_gzt_rbc}

This example uses a custom action to generate a list of contacts details from users in a specific department. To create the custom action to generate an array of objects, see [Create a custom action to generate an array of objects from a list of records](https://servicenow-prod.fluidtopics.net/XV4Ds_ed70oVcD3fOQl64Q "Generate an array of objects from a list of User records. Learn how to use a Script step to iterate through a list of records.").  
In this example, the contacts array contains three users from the Development department.

    {
        "contacts": 
            "contact": [
                {
                    "email_address": "allyson.gillispie@example.com",
                    "first_name": "Allyson",
                    "last_name": "Gillispie"
                },
                {
                    "email_address": "alva.pennigton@example.com",
                    "first_name": "Alva",
                    "last_name": "Pennigton"
                },
                {
                    "email_address": "andrew.och@example.com",
                    "first_name": "Andrew",
                    "last_name": "Och"
                }
            ]
        }
    }