# JsonArray.Insert(Integer, JsonValue) Method
> Version: _Available or changed with runtime version 1.0._
Inserts the value at the given index in the array while shifting all the values to the right by one position.
## Syntax
```al
[Ok := ]  JsonArray.Insert(Index: Integer, Value: JsonValue)
```
## Parameters
JsonArray
Type: jsonarray-data-type
An instance of the jsonarray-data-type data type.
Index
Type: ../integer/integer-data-type
Value
Type: ../jsonvalue/jsonvalue-data-type
## Return Value
*[Optional] Ok*
Type: ../boolean/boolean-data-type
true if the read was successful; otherwise, false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.
## Remarks
> NOTE
> The JsonArray is 0-based by design.
## Related information
jsonarray-data-type
Get Started with AL<../../devenv-get-started>
Developing Extensions<../../devenv-dev-overview>

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/jsonarray/jsonarray-insert-integer-jsonvalue-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/jsonarray/jsonarray-insert-integer-jsonvalue-method/
