Subject: Guidance Required – upsert_array_replace Support for Batch Ingestion | Community
Skip to main content
S
SivagamiR1
Level 1
June 28, 2026
Question

Subject: Guidance Required – upsert_array_replace Support for Batch Ingestion

  • June 28, 2026
  • 1 reply
  • 27 views

Subject: Guidance Required – upsert_array_replace Support for Batch Ingestion
Hi everyone,
Good evening.
I need some guidance regarding the behavior of upsert_array_replace with Batch Ingestion in Adobe Experience Platform.
I am trying to update an array field in an existing Profile using Batch Ingestion (Upsert). However, instead of replacing the existing array values, the new values are getting appended.
I have gone through the available Adobe documentation and tested different approaches, but I couldn't find any confirmation on whether upsert_array_replace is supported for Batch Ingestion.
From the documentation, I could confirm that upsert_array_replace is supported for Streaming Ingestion, but I couldn't find any mention of Batch Ingestion.
Could someone please help clarify:
Is upsert_array_replace supported for Batch Ingestion?
If not, is there any alternative approach to completely replace array/object-array values during Batch Upsert?
Is there any official Adobe documentation that explicitly states that upsert_array_replace is not supported for Batch Ingestion?
I have attached the relevant documentation/reference for context.
Any guidance from the Adobe team or anyone who has worked on this scenario would be greatly appreciated. This information is important for our implementation, and we'd really appreciate any clarification or documentation you can share.
Thank you in advance for your time and support!

    1 reply

    DavidKangni
    Community Advisor
    DavidKangniCommunity Advisor
    Community Advisor
    June 29, 2026

    ​@SivagamiR1 

    The default behavior is to replace the field in AEP. So if you have the full array in your batch, no need to use upsert_arrat_replace.

    In case in your data you only have identities and the array fields, then create a separate batch dataset to update only the array.

    Thanks,

    David

    David Kangni
    S
    SivagamiR1Author
    Level 1
    June 30, 2026

    Hi David,

    Thank you for your response.

    In our case, during Batch Ingestion, the existing array values are getting appended instead of being replaced, even when using "upsert_array_replace".

    Could you please clarify whether "upsert_array_replace" is supported for Batch Ingestion? If it is not supported, could you please confirm that and, if available, share any official reference or documentation regarding this behavior?

    Also, when you mentioned that the default behavior is to replace the field in AEP, could you please explain under what conditions this applies? In our testing, we consistently observed append behavior for array/object-array fields during Batch Ingestion.

    Thanks!

    Terms & ConditionsAccessibility statement

    Loading footer...