Back

delete()

Name	Type	Required	Default	Description
parameterize	any	No	true	Set to `true` to use `cfqueryparam` on all columns, or pass in a list of property names to use `cfqueryparam` on those only.
transaction	string	No	[runtime expression]	Set this to `commit` to update the database, `rollback` to run all the database queries but not commit them, or `none` to skip transaction handling altogether.
callbacks	boolean	No	true	Set to `false` to disable callbacks for this method.
includeSoftDeletes	boolean	No	false	Set to `true` to include soft-deleted records in the queries that this method runs.
softDelete	boolean	No	true	Set to `false` to permanently delete a record, even if it has a soft delete column.

Example 1: Delete a single object
<cfscript>
post = model("post").findByKey(33);
success = post.delete();
</cfscript>

Deletes the post with ID 33 from the database.

Returns true if deletion succeeds.

Example 2: Scoped delete via association
<cfscript>
post = model("post").findByKey(params.postId);
comment = model("comment").findByKey(params.commentId);

// Calls comment.delete() internally
post.deleteComment(comment);
</cfscript>

If post has a hasMany association to comment, this uses the association method to delete a related comment.

Example 3: Permanent deletion (bypass soft-delete)
<cfscript>
post = model("post").findByKey(33);
post.delete(softDelete=false);
</cfscript>

Forces a hard delete even if the model uses soft-delete columns.