SharePoint List Formatting
Back to view formats
View formattingSharePoint Online

Teams Group Chat Links

This sample uses Microsoft Teams deep links to create Teams chat group based on selected users with associated Group name and message.

Get this format View on GitHub

Shared by André Lage
Updated Dec 31, 2021

Teams Group Chat Links formatting preview
Sample preview · View original animation

Copy. Apply. Make it yours.

Get this format

1 definition

Review the requirements below, then paste this JSON into the matching formatting panel. Show me where.

Use your list's internal column names and replace any tenant-specific URLs or flow IDs. Formatting is presentation, not a way to secure data.

View formatting
Download JSON
{
  "$schema": "https://developer.microsoft.com/json-schemas/sp/v2/row-formatting.schema.json",
  "hideColumnHeader": true,
  "hideFooter": true,
  "hideSelection": true,
  "rowFormatter": {
    "elmType": "div",
    "style": {
      "float": "left",
      "position": "relative",
      "box-shadow": "0 10px 16px 0 rgba(0,0,0,0.2),0 6px 20px 0 rgba(0,0,0,0.19)",
      "margin": "10px",
      "width": "300px"
    },
    "children": [
      {
        "elmType": "div",
        "children": [
          {
            "elmType": "div",
            "attributes": {
              "class": "ms-fontSize-16 ms-bgColor-themeTertiary ms-fontColor-white ms-fontWeight-semibold"
            },
            "style": {
              "width": "300px",
              "padding": "15px 0px"
            },
            "children": [
              {
                "elmType": "div",
                "style": {
                  "padding": "0px 15px"
                },
                "txtContent": "[$Title]",
                "inlineEditField": "[$Title]"
              }
            ]
          },
          {
            "elmType": "div",
            "attributes": {
              "class": "ms-fontSize-14"
            },
            "style": {
              "justify-content": "left",
              "padding": "10px",
              "align-items": "baseline",
              "max-width": "300px",
              "height": "30px",
              "max-height": "30px"
            },
            "txtContent": "[$Chat]",
            "inlineEditField": "[$Chat]"
          },
          {
            "elmType": "div",
            "children": [
              {
                "elmType": "div",
                "style": {
                  "display": "inline-block"
                },
                "children": [
                  {
                    "elmType": "span",
                    "attributes": {
                      "class": "ms-fontSize-20  ms-fontColor-themePrimary",
                      "iconName": "Feedback"
                    },
                    "style": {
                      "padding": "0px 15px"
                    }
                  }
                ]
              },
              {
                "elmType": "div",
                "style": {
                  "display": "inline-block"
                },
                "attributes": {
                  "class": "ms-fontSize-24  ms-fontColor-themePrimary"
                },
                "children": [
                  {
                    "elmType": "span",
                    "txtContent": "Group chat users:"
                  }
                ]
              }
            ]
          },
          {
            "elmType": "div",
            "inlineEditField": "[$PersonChat]",
            "style": {
              "max-width": "235px",
              "height": "80px",
              "overflow": "hidden",
              "display": "inline-block",
              "float": "left"
            },
            "children": [
              {
                "forEach": "personIterator in [$PersonChat]",
                "elmType": "div",
                "style": {
                  "display": "=if(length([$PersonChat])>2 && loopIndex('personIterator')>=2, 'none', 'inline-block')",
                  "padding": "10px",
                  "text-align": "center",
                  "width": "58px"
                },
                "children": [
                  {
                    "elmType": "div",
                    "children": [
                      {
                        "elmType": "img",
                        "style": {
                          "width": "38px",
                          "border-radius": "50%"
                        },
                        "defaultHoverField": "[$personIterator]",
                        "attributes": {
                          "src": "=getUserImage('[$personIterator.email]','small')"
                        }
                      },
                      {
                        "elmType": "div",
                        "style": {
                          "text-overflow": "ellipsis",
                          "overflow": "hidden",
                          "white-space": "nowrap"
                        },
                        "txtContent": "[$personIterator.title]"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "elmType": "div",
            "style": {
              "display": "=if(length([$PersonChat])>3,'inline-block','none')",
              "width": "60px",
              "padding-top": "10px",
              "float": "left",
              "text-align": "center",
              "cursor": "pointer"
            },
            "attributes": {
              "class": "ms-fontSize-32 ms-fontWeight-semibold ms-fontColor-themePrimary"
            },
            "txtContent": "='+'+(length([$PersonChat])-2)",
            "customCardProps": {
              "openOnEvent": "click",
              "formatter": {
                "elmType": "div",
                "children": [
                  {
                    "forEach": "personIterator in [$PersonChat]",
                    "elmType": "div",
                    "style": {
                      "padding": "10px",
                      "text-align": "center"
                    },
                    "children": [
                      {
                        "elmType": "div",
                        "defaultHoverField": "[$personIterator]",
                        "children": [
                          {
                            "elmType": "img",
                            "style": {
                              "width": "38px",
                              "border-radius": "50%"
                            },
                            "attributes": {
                              "src": "=getUserImage('[$personIterator.email]','small')"
                            }
                          },
                          {
                            "elmType": "div",
                            "txtContent": "[$personIterator.title]"
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            }
          },
          {
            "elmType": "a",
            "attributes": {
              "href": "='https://teams.microsoft.com/l/chat/0/0?users='+if(length([$PersonChat.sip])>1,replace([$PersonChat.sip],';',',') ,replace([$PersonChat.email],';',','))+'&message='+[$Chat]+if(length([$PersonChat]) > 2,'&topicName='+[$Title],'')",
              "target": "_blank"
            },
            "style": {
              "display": "inline-block",
              "width": "300px"
            },
            "children": [
              {
                "elmType": "div",
                "attributes": {
                  "class": "ms-bgColor-themePrimary ms-fontColor-white ms-bgColor-themeTertiary--hover"
                },
                "style": {
                  "border": "none",
                  "padding": "15px 0px",
                  "text-align": "center",
                  "text-decoration": "none",
                  "display": "inline-block",
                  "font-size": "16px",
                  "cursor": "pointer",
                  "width": "300px"
                },
                "children": [
                  {
                    "elmType": "div",
                    "attributes": {
                      "iconName": "OfficeChat",
                      "class": "ms-fontSize-24"
                    }
                  },
                  {
                    "elmType": "div",
                    "txtContent": "Go to chat"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}
View sourceLink to this definitionteams-group-chat-links.json

From the contributor

How to use this sample

Summary

This sample uses Microsoft Teams deep links to create Teams chat group based on selected users with the associated Group name and message.

screenshot of the sample

View requirements

  • The format expect the following fields:
Field Type
Title Single line of text
Chat Multiple lines of text
PersonChat Person - check to yes, Allow multiple selections

Sample

Solution Author(s)
teams-group-chat-links.json André Lage

Version history

Version Date Comments
1.0 December 31, 2021 Initial release

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.

Additional notes

None

Keep exploring

More formats like this

Key Dates Timeline Checklist

A modern horizontal timeline view that displays key dates or milestones as monthly columns.

Explore format

Sports Card

This SharePoint JSON view formatting sample transforms list items into vertical sports trading cards with header bar, country badge, player silhouette, name band, star rating and three stat bars.

Explore format

Credit / Loyalty Card

Transforms list items into realistic credit / loyalty cards with a brand name, tier pill, EMV chip, contactless symbol, embossed card number, cardholder, expiry, and network logo. The card colour is driven by the Tier value.

Explore format