Amazon Q Business will no longer be open to new customers starting on July 31, 2026. If you would like to use the service, please sign up prior to July 30. For capabilities similar to Q Business, explore Amazon Quick. [Learn more](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/qbusiness-availability-change.html).

# Microsoft Teams data source connector field mappings
<a name="teams-field-mappings"></a>

To help you structure data for retrieval and chat filtering, Amazon Q Business crawls data source document attributes or metadata and maps them to fields in your Amazon Q index.

Amazon Q has reserved fields that it uses when querying your application. When possible, Amazon Q automatically maps these built-in fields to attributes in your data source. If a built-in field doesn't have a default mapping, or if you want to map additional index fields, use the custom field mappings to specify how a data source attribute maps to your Amazon Q application. You create field mappings by editing your data source after your application and retriever are created.

To learn more about document attributes and how they work in Amazon Q, see [Document attributes and types in Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/doc-attributes.html).

**Important**  
Filtering using document attributes in chat is only supported through the API.

The Amazon Q Teams connector supports the following entities and the associated reserved and custom attributes.

**Note**  
You can map any Teams field to the document title or document body Amazon Q reserved/default index fields.

**Topics**
+ [Chat messages](#teams-field-mappings-chat-messages)
+ [Chat attachments](#teams-field-mappings-chat-attachments)
+ [Channel posts](#teams-field-mappings-channel-posts)
+ [Channel file attachments](#teams-field-mappings-channel-file-attachments)
+ [Wiki](#teams-field-mappings-wiki)
+ [Meeting chats](#teams-field-mappings-meeting-chats)
+ [Meeting details](#teams-field-mappings-meeting-details)
+ [Meeting notes](#teams-field-mappings-meeting-notes)
+ [Meeting files](#teams-field-mappings-meeting-files)

## Chat messages
<a name="teams-field-mappings-chat-messages"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\_subject  |  Custom  |  String  | 
|  summary  |  tms\_summary  |  Custom  |  String  | 
|  importance  |  tms\_importance  |  Custom  |  String  | 
|  messageType  |  tms\_message\_type  |  Custom  |  String  | 
|  sender  |  tms\_sender  |  Custom  |  String  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  attachments  |  tms\_attachments  |  Custom  |  String list  | 
|  reactions  |  tms\_reactions  |  Custom  |  String list  | 
|  mentions  |  tms\_mentions  |  Custom  |  String list  | 
|  deletedAt  |  tms\_last\_deleted\_at  |  Custom  |  Date  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  | 

## Chat attachments
<a name="teams-field-mappings-chat-attachments"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\_name  |  Custom  |  String  | 
|  size  |  tms\_file\_size  |  Custom  |  Long (numeric)  | 
|  title  |  tms\_title  |  Custom  |  String  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  lastModifiedBy  |  tms\_last\_modified\_by  |  Custom  |  String  | 
|  createdBy  |  tms\_created\_by  |  Custom  |  String  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  | 

## Channel posts
<a name="teams-field-mappings-channel-posts"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\_subject  |  Custom  |  String  | 
|  summary  |  tms\_summary  |  Custom  |  String  | 
|  importance  |  tms\_importance  |  Custom  |  String  | 
|  messageType  |  tms\_message\_type  |  Custom  |  String  | 
|  createdBy  |  tms\_created\_by  |  Custom  |  String  | 
|  deletedAt  |  tms\_last\_deleted\_at  |  Custom  |  Date  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  mentions  |  tms\_mentions  |  Custom  |  String list  | 
|  reactions  |  tms\_reactions  |  Custom  |  String list  | 
|  attachments  |  tms\_attachments  |  Custom  |  String list  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  | 

## Channel file attachments
<a name="teams-field-mappings-channel-file-attachments"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\_name  |  Custom  |  String  | 
|  size  |  tms\_file\_size  |  Custom  |  Long (numeric)  | 
|  channelName  |  tms\_channel\_name  |  Custom  |  String  | 
|  Title  |  tms\_title  |  Custom  |  String  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  createdBy  |  tms\_created\_by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\_last\_modified\_by  |  Custom  |  String  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  | 
|  oneNoteDocument  |  tms\_onenote\_document  |  Custom  |  String  | 
|  oneNoteSection  |  tms\_onenote\_section  |  Custom  |  String  | 
|  oneNotePage  |  tms\_onenote\_page  |  Custom  |  String  | 

## Wiki
<a name="teams-field-mappings-wiki"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  channelName  |  tms\_channel\_name  |  Custom  |  String  | 
|  fileName  |  tms\_name  |  Custom  |  String  | 
|  size  |  tms\_file\_size  |  Custom  |  Long (numeric)  | 
|  createdBy  |  tms\_created\_by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\_last\_modified\_by  |  Custom  |  String  | 
|  title  |  tms\_title  |  Custom  |  String  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  | 

## Meeting chats
<a name="teams-field-mappings-meeting-chats"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\_subject  |  Custom  |  String  | 
|  summary  |  tms\_summary  |  Custom  |  String  | 
|  importance  |  tms\_importance  |  Custom  |  String  | 
|  messageType  |  tms\_message\_type  |  Custom  |  String  | 
|  Sender  |  tms\_sender  |  Custom  |  String  | 
|  attachments  |  tms\_attachments  |  Custom  |  String list  | 
|  mentions  |  tms\_mentions  |  Custom  |  String list  | 
|  reactions  |  tms\_reactions  |  Custom  |  String list  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  deletedAt  |  tms\_last\_deleted\_at  |  Custom  |  Date  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  | 

## Meeting details
<a name="teams-field-mappings-meeting-details"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\_subject  |  Custom  |  String  | 
|  summary  |  tms\_summary  |  Custom  |  String  | 
|  importance  |  tms\_importance  |  Custom  |  String  | 
|  username  |  tms\_from\_user  |  Custom  |  String  | 
|  eventStartTime  |  tms\_event\_start\_time  |  Custom  |  Date  | 
|  eventEndTime  |  tms\_event\_end\_time  |  Custom  |  Date  | 
|  sourceURL  |  \_source\_uri  |  Default  |  String  | 

## Meeting notes
<a name="teams-field-mappings-meeting-notes"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\_name  |  Custom  |  String  | 
|  title  |  tms\_title  |  Custom  |  String  | 
|  createdBy  |  tms\_created\_by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\_last\_modified\_by  |  Custom  |  String  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  | 

## Meeting files
<a name="teams-field-mappings-meeting-files"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\_name  |  Custom  |  String  | 
|  title  |  tms\_title  |  Custom  |  String  | 
|  size  |  tms\_file\_size  |  Custom  |  Long (numeric)  | 
|  sourceUrl  |  \_source\_uri  |  Default  |  String  | 
|  createdBy  |  tms\_created\_by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\_last\_modified\_by  |  Custom  |  String  | 
|  createdAt  |  \_created\_at  |  Default  |  Date  | 
|  lastModifiedAt  |  \_last\_updated\_at  |  Default  |  Date  |