{"title":"OnInsert (Table Extension) trigger","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/tableextension/devenv-oninsert-tableextension-trigger/","by":"JOP-AL","license":"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/triggers-auto/tableextension/devenv-oninsert-tableextension-trigger, 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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/triggers-auto/tableextension/devenv-oninsert-tableextension-trigger","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Runs when a user inserts a new record into the table.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"OnInsert (Table Extension) trigger","slug":"oninsert-table-extension-trigger","at":0,"chars":1158},{"level":2,"title":"Syntax","slug":"syntax","at":151,"chars":58},{"level":2,"title":"Remarks","slug":"remarks","at":209,"chars":793},{"level":2,"title":"Related information","slug":"related-information","at":1002,"chars":156}],"text":"# OnInsert (Table Extension) trigger\n> Version: _Available or changed with runtime version 1.0._\nRuns when a user inserts a new record into the table.\n## Syntax\n```al\ntrigger OnInsert()\nbegin\n    ...\nend;\n```\n## Remarks\nThis trigger is run before default insert behavior, which checks that the record to be inserted does not already exist before the insertion occurs. It runs automatically after the user chooses to insert a new record in a page from the Web client. If a user inserts a record using AL code, then the RunTrigger argument of ../../methods-auto/record/record-insert--method must be set to true for the OnInsert Trigger to run, or otherwise it will not. The new record is not inserted if an error occurs in the trigger code.\nIn tables where records are entered in pages that have the ../../properties/devenv-delayedinsert-property set to true, we recommend that you write any code that is in an OnInsert trigger so that it will always succeed. For example, this applies to journal lines.\n## Related information\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>\n../table/devenv-oninsert-table-trigger"}