<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Messages",
  "identifier" : "/documentation/Messages/MSConversation/insertText(_:completionHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Messages"
    ],
    "preciseIdentifier" : "c:objc(cs)MSConversation(im)insertText:completionHandler:"
  },
  "title" : "insertText(_:completionHandler:)"
}
-->

# insertText(_:completionHandler:)

Inserts text into the Messages app’s input field.

```
func insertText(_ text: String, completionHandler: (@Sendable ((any Error)?) -> Void)? = nil)
```

## Parameters

`text`

The text to be inserted.

`completionHandler`

A block that is called as soon as the insertion is complete. This block is passed the following parameter:

- error: An error object. If an error occurred, this object contains information about the error; otherwise, it is set to `nil`.

## Discussion

> Important:
> You can call this method from synchronous code using a completion handler, as shown on this page, or you can call it as an asynchronous method that has the following declaration:
> 
> ```swift
> func insertText(_ text: String) async throws
> ```
> 
> For information about concurrency and asynchronous code in Swift, see <doc://com.apple.documentation/documentation/Swift/calling-objective-c-apis-asynchronously>.

Use this method to insert text into the Message app’s input field. Users can then send the text by tapping Send. iMessage apps suport this method only in the [`MSMessagesAppPresentationContext.messages`](/documentation/Messages/MSMessagesAppPresentationContext/messages) context. If called in the [`MSMessagesAppPresentationContext.media`](/documentation/Messages/MSMessagesAppPresentationContext/media) context, the method fails with an [`MSMessageErrorCode.apiUnavailableInPresentationContext`](/documentation/Messages/MSMessageErrorCode/apiUnavailableInPresentationContext) error.

This method operates asynchronously. Although the method returns immediately, the actual work is deferred and performed in the background. As soon as the attachment is inserted, the system calls the completion block on a background queue.

> Note:
> This method does not send the text message. It inserts the text into the Messages app’s input field. The text is not sent until the user taps Send.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)