# INSetMessageAttributeIntent A request to modify the attributes of a message. ``` class INSetMessageAttributeIntent ``` ## Overview Siri creates an [`INSetMessageAttributeIntent`](/documentation/Intents/INSetMessageAttributeIntent) object when the user asks to modify the attributes of one or more messages. Attributes represent information about the message such as whether the user read or flagged the message. This intent object includes the messages to modify and which attributes to change. To handle this intent, the handler object in your Intents extension must adopt the [`INSetMessageAttributeIntentHandling`](/documentation/Intents/INSetMessageAttributeIntentHandling) protocol. Your handler should confirm the request and create an [`INSetMessageAttributeIntentResponse`](/documentation/Intents/INSetMessageAttributeIntentResponse) object with the results of modifying the messages. ### Additional Intent Attributes The following table lists additional attributes of this intent object: |Attribute |Description | |-------------------------------|------------| |Supported by |Siri Intents| |Always requires unlocked device|No | Apps can optionally ask the user to unlock the device before handling this intent. To require unlocking of the device, include the name of this class in the `IntentsRestrictedWhileLocked` key of your Intents extension’s `Info.plist` file. ### Example Phrases Users can ask Siri to set the attributes of a message in a variety of ways. The table below provides a few sample phrases in different languages. You can use these phrases during testing to trigger your intents. This list is not exhaustive and Siri may recognize many other phrases. |Locale|Example 1 |Example 2 | |------|-----------------------------------------------|-----------------------------------------------------| |en |Read my messages from Bob using `` | | |zh_CN |读一下来自李宏辉的``信息 |读一下``上李宏辉的信息 | |zh_HK |用``讀Jeffrey俾我嘅訊息 |讀出``上邊嘅訊息 | |zh_TW |朗讀我``的訊息 |在``上朗讀我的訊息 | |yue_CN|用``读Jeffrey俾我嘅讯息 |朗读``嘅信息 | |ar |إقرأ رسائل `` من عامر |قراءة آخر رسالة `` لرنا | |da |læs mine nye `` beskeder |læs mine nye `` beskeder | |de |Die `` Nachricht vorlesen |Lies meine `` Nachricht vor | |es |Leer los mensajes de Sandra usando `` |Léeme los mensajes que me mandó Pedro por ``| |fi |Lue mun `` viestit Paavolta |Lue Julialta tulleet `` viestit | |fr |Lis mes messages de Jean sur `` |Lis mes messages écrits par Henri sur `` | |he |תקרא את ההודעות מדויד באמצעות `` |באמצעות `` תקרא את ההודעות מדויד | |it |Leggi i miei messaggi da Rosanna su ``|Leggi i miei messaggi su `` | |ja |``で太郞からのメッセージを読んで |太郞からの``メッセージを読み上げて | |ko |내 새로운 `` 메시지를 읽어줘 |나의 `` 메시지 읽어줘 | |ms |Baca mesej `` saya |Baca teks dari Dini dalam `` | |nb |Les mine nye `` meldinger |Les meldingen i `` | |nl |Lees mijn nieuwe `` berichten |Lees mijn nieuwe `` berichten | |pt |Leia minha mensagem do João no `` |Leia a última mensagem recebida no `` | |ru |Прочти мои новые `` сообщения |Прочитай новые сообщения в`` | |sv |Läs mina nya `` meddelanden |Läs upp nya meddelanden på `` | |th |อ่านข้อความจาก `` ของสมชาย |อ่านข้อความของสมชายที่ส่งมาจาก `` | |tr |``’den gelen mesajı oku |`` uygulamasındaki mesajı oku | In the preceding examples, `` represents the name of the app whose Intents extension modifies the message attributes. ## Topics ### Initializing the Intent Object [`init(identifiers:attribute:)`](/documentation/Intents/INSetMessageAttributeIntent/init(identifiers:attribute:)) Initializes the set message attribute intent object with the specified identifiers and attribute. ### Getting the Attribute Details [`attribute`](/documentation/Intents/INSetMessageAttributeIntent/attribute) The attribute to apply to the messages. [`identifiers`](/documentation/Intents/INSetMessageAttributeIntent/identifiers) The array of message identifiers. --- Copyright © 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)