{"id":86,"date":"2018-06-01T03:27:04","date_gmt":"2018-06-01T10:27:04","guid":{"rendered":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/"},"modified":"2024-07-31T09:31:18","modified_gmt":"2024-07-31T16:31:18","slug":"comment-your-powerapps-code","status":"publish","type":"power-apps","link":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/","title":{"rendered":"Comment your PowerApps code!"},"content":{"rendered":"<p>We are happy to announce the formula commenting feature for PowerApps. Have you ever inspected a PowerApps formula and wondered just what the author was trying to accomplish? Or, maybe you\u2019ve wondered what even you, yourself, were trying to accomplish in a formula you wrote six months ago? But, without a formula commenting feature, authors can\u2019t leave hints, guidance, or help in the formula itself.<\/p>\n<p>Now anyone can comment a formula to provide help to those who inspect it later.<\/p>\n<p>Commenting Styles<\/p>\n<p>We make two commenting styles possible: line and block.<\/p>\n<p><b>Line Comments<\/b><\/p>\n<p>A line comment is one that comes at the end of a formula and takes up the rest of the line. For instance, if your formula looks like the following:<\/p>\n<p><a href=\"https:\/\/pwrappscdn.azureedge.net\/mediahandler\/blog\/media\/PowerApps\/blog\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-122684 size-full\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg\" alt=\"clip image 02\" width=\"244\" height=\"40\" \/><\/a><\/p>\n<p>You can add line comments by adding a \u201c\/\/ &lt;your comment here&gt;\u201d at the end of the line like so:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-122683\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1089e1a0-b6f0-4726-847a-d86a6839016a.jpg\" alt=\"clip image 004\" width=\"244\" height=\"78\" \/><\/p>\n<p>You can\u2019t put any code at the end of the comment \u2013 the comment runs all the way to the end of the line. And, the formula assumes that the next line picks up where the comment on the previous line began.<\/p>\n<p><b>Block Comments<\/b><\/p>\n<p>The other style of comment is block comment. As shown below, it starts with the special key combination of forward slash and an asterisk and continues until explicitly terminated with the opposite key combination of asterisk forward slash.<\/p>\n<p><a href=\"https:\/\/pwrappscdn.azureedge.net\/mediahandler\/blog\/media\/PowerApps\/blog\/a8c5ee2d-717d-4a31-b721-3173d77a4798.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-122685\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/a8c5ee2d-717d-4a31-b721-3173d77a4798.jpg\" alt=\"clip image 004\" width=\"244\" height=\"75\" \/><\/a><\/p>\n<p>Note that you can use the block style comment at the end of a line as well. But the line style comment is easier to use for an end of line comment.<\/p>\n<p>And, sometimes people use the end of line comment in the same way the block style comments are used.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-122686\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/d5af8c19-21b7-42e9-8b62-c093e376a579.jpg\" alt=\"clip image 008\" width=\"244\" height=\"70\" \/><\/p>\n<p>But, it\u2019s up to you. Pick a style that works for your formulas in your PowerApp. We\u2019d love to hear from you about this feature in the <u><a href=\"https:\/\/powerusers.microsoft.com\/t5\/PowerApps-Community\/ct-p\/PowerApps1\">PowerApps Community<\/a><\/u>.<\/p>\n<p>Thanks,<\/p>\n<p>The PowerApps team.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are happy to announce the formula commenting feature for PowerApps. Have you ever inspected a PowerApps formula and wondered just what the author was trying to accomplish? Or, maybe you\u2019ve\u2026<\/p>\n","protected":false},"author":105,"featured_media":0,"comment_status":"open","ping_status":"open","template":"","power-apps-category":[1549,1617],"power-apps-tag":[],"coauthors":[2340],"class_list":["post-86","power-apps","type-power-apps","status-publish","hentry","power-apps-category-building-power-apps","power-apps-category-formulas"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Comment your PowerApps code! - Microsoft Power Platform Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Comment your PowerApps code! - Microsoft Power Platform Blog\" \/>\n<meta property=\"og:description\" content=\"We are happy to announce the formula commenting feature for PowerApps. Have you ever inspected a PowerApps formula and wondered just what the author was trying to accomplish? Or, maybe you\u2019ve\u2026\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/\" \/>\n<meta property=\"og:site_name\" content=\"Microsoft Power Platform Blog\" \/>\n<meta property=\"article:modified_time\" content=\"2024-07-31T16:31:18+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 min read\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"Lance Delano\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/\",\"name\":\"Comment your PowerApps code! - Microsoft Power Platform Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg\",\"datePublished\":\"2018-06-01T10:27:04+00:00\",\"dateModified\":\"2024-07-31T16:31:18+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#primaryimage\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg\",\"contentUrl\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg\",\"width\":244,\"height\":40,\"caption\":\"clip image 02\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Power Apps\",\"item\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Comment your PowerApps code!\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/\",\"name\":\"Microsoft Power Platform Blog\",\"description\":\"Innovate with Business Apps\",\"publisher\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization\",\"name\":\"Microsoft Power Platform Blog\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png\",\"contentUrl\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png\",\"width\":194,\"height\":145,\"caption\":\"Microsoft Power Platform Blog\"},\"image\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Comment your PowerApps code! - Microsoft Power Platform Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/","og_locale":"en_US","og_type":"article","og_title":"Comment your PowerApps code! - Microsoft Power Platform Blog","og_description":"We are happy to announce the formula commenting feature for PowerApps. Have you ever inspected a PowerApps formula and wondered just what the author was trying to accomplish? Or, maybe you\u2019ve\u2026","og_url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/","og_site_name":"Microsoft Power Platform Blog","article_modified_time":"2024-07-31T16:31:18+00:00","og_image":[{"url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 min read","Written by":"Lance Delano"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/","name":"Comment your PowerApps code! - Microsoft Power Platform Blog","isPartOf":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#primaryimage"},"image":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#primaryimage"},"thumbnailUrl":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg","datePublished":"2018-06-01T10:27:04+00:00","dateModified":"2024-07-31T16:31:18+00:00","breadcrumb":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#primaryimage","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg","contentUrl":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2018\/06\/1586aae2-5ade-4bff-8745-353f542b62bd.jpg","width":244,"height":40,"caption":"clip image 02"},{"@type":"BreadcrumbList","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/comment-your-powerapps-code\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/"},{"@type":"ListItem","position":2,"name":"Power Apps","item":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/"},{"@type":"ListItem","position":3,"name":"Comment your PowerApps code!"}]},{"@type":"WebSite","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/","name":"Microsoft Power Platform Blog","description":"Innovate with Business Apps","publisher":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization","name":"Microsoft Power Platform Blog","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png","contentUrl":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png","width":194,"height":145,"caption":"Microsoft Power Platform Blog"},"image":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/"}}]}},"msxcm_display_generated_audio":false,"distributor_meta":false,"distributor_terms":false,"distributor_media":false,"distributor_original_site_name":"Microsoft Power Platform Blog","distributor_original_site_url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog","push-errors":false,"_links":{"self":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-apps\/86","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-apps"}],"about":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/types\/power-apps"}],"author":[{"embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/users\/105"}],"replies":[{"embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/comments?post=86"}],"version-history":[{"count":1,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-apps\/86\/revisions"}],"predecessor-version":[{"id":122688,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-apps\/86\/revisions\/122688"}],"wp:attachment":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/media?parent=86"}],"wp:term":[{"taxonomy":"power-apps-category","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-apps-category?post=86"},{"taxonomy":"power-apps-tag","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-apps-tag?post=86"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/coauthors?post=86"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}