The Array method push() in Apps Script

The Array method push() adds elements to the end of an array. It returns the new length of the array after the elements are added to it.

Syntax

array.push(element1, element2, …, elementN)

Parameters

The elements to be added to the array. These will be added to the end of the array.

Return value

The push() method returns the new length of the array after elements are added to it.

Example

The code below uses the push() array method to add two new elements to the array colors.

var colors = ["red", "blue", "green", "black", "orange", "purple"];
Logger.log(colors);
Logger.log(colors.length);
var newLength = colors.push("indigo", "violet");
Logger.log(colors);
Logger.log(newLength);

Output

[red, blue, green, black, orange, purple]

6.0

[red, blue, green, black, orange, purple, indigo, violet]

8.0

Conclusion

In this tutorial, you learned how to use the push() array method to add elements to the end of an array.

Stay up to date

Follow me via email to receive actionable tips and other exclusive content. I'll also send you notifications when I publish new content.
By signing up you agree to the Privacy Policy & Terms.

Have feedback for me?

I'd appreciate any feedback you can give me regarding this post.

Was it useful? Are there any errors or was something confusing? Would you like me to write a post about a related topic? Any other feedback is also welcome. Thank you so much!