Docs / Data extensions

UpsertData()

UpsertData is an AMPscript function in the data extensions category. Returns rows affected.

Syntax

UpsertData(de, numKeys, keyCol, keyVal, ..., col, value, ...)

Example

%%=UpsertData("Loyalty", 1, "EmailAddress", emailaddr, "Points", 1300)=%% row written
Rendered output
1 row written

Output produced by AmpSend's AMPscript engine (validated against Salesforce's own test corpus) - not a hand-written result.

Try UpsertData in the editor - free, no signup

AmpSend runs AMPscript entirely in your browser: instant preview, named test scenarios, shared content blocks and data extensions, and an AI assistant that knows every supported function. Nothing leaves your machine.

Official Salesforce documentation

UpsertData in the official AMPscript reference - or browse the official index of AMPscript functions for platform behavior and edge cases.

Related data extensions functions

LookupLookupRowsLookupRowsCSLookupOrderedRowsLookupOrderedRowsCSDataExtensionRowCountRowCountRowFieldInsertDEInsertDataUpdateDEUpdateDataUpsertDEDeleteDEDeleteData