{"id":1742002,"date":"2022-11-09T01:16:37","date_gmt":"2022-11-09T09:16:37","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=1742002"},"modified":"2024-10-31T23:59:04","modified_gmt":"2024-11-01T06:59:04","slug":"introducing-the-new-arcade-editor-in-arcgis-online","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online","title":{"rendered":"Introducing the new Arcade editor in ArcGIS Online"},"author":6981,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[777102,22941],"tags":[32551,673891,33371,767002],"industry":[],"product":[36551],"class_list":["post-1742002","blog","type-blog","status-publish","format-standard","hentry","category-arcade","category-mapping","tag-arcade","tag-arcgis-arcade","tag-map-viewer","tag-whats-new-november-2022","product-arcgis-online"],"acf":{"authors":[{"ID":6981,"user_firstname":"Paul","user_lastname":"Barker","nickname":"Paul Barker","user_nicename":"pbarker_esri","display_name":"Paul Barker","user_email":"PBarker@esri.com","user_url":"http:\/\/www.arcgis.com","user_registered":"2018-03-02 00:19:05","user_description":"Product Engineer for ArcGIS Online and technology enthusiast.","user_avatar":""}],"short_description":"Take a tour of the new Arcade editor available now in Map Viewer.","flexible_content":[{"acf_fc_layout":"content","content":"

Arcade as a language has steadily grown since its inception, each release finding its way into more and more places in ArcGIS and introducing a steady stream of new capabilities. While the language has evolved, the Arcade editor has largely stayed the same and in a way the language has outgrown the existing Arcade editor as users continue to write increasingly more complex and creative expressions. This has been an area of focus for the team, and we\u2019re pretty excited to show you what we\u2019ve been up to.<\/p>\n

With the latest release of ArcGIS Online, we\u2019re introducing a new Arcade editor (where you author expressions) that is built for the future and can grow into your ever-expanding needs. The new Arcade editor is currently used by Map Viewer however, over the next few releases, it will make its way just about everywhere you write Arcade across ArcGIS Online.\u00a0 While parts will look familiar there is much that has changed. So, let\u2019s dive in and look.<\/p>\n"},{"acf_fc_layout":"content","content":"

Finding your way around<\/h2>\n

To get started, open the Map Viewer and head over to the pop-up panel and click Attribute expressions. <\/strong>Then click Add expression, <\/strong>or any other place Arcade is supported in the Map Viewer (except for form authoring).<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1753772,"id":1753772,"title":"Pic01","filename":"Pic01.png","filesize":6473,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online\/pic01-2","alt":"image of the attribute expressions button","author":"6981","description":"","caption":"","name":"pic01-2","status":"inherit","uploaded_to":1742002,"date":"2022-10-31 13:27:29","modified":"2022-11-02 10:48:19","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":644,"height":206,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","medium-width":464,"medium-height":148,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","medium_large-width":644,"medium_large-height":206,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","large-width":644,"large-height":206,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","1536x1536-width":644,"1536x1536-height":206,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","2048x2048-width":644,"2048x2048-height":206,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","card_image-width":644,"card_image-height":206,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic01.png","wide_image-width":644,"wide_image-height":206}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

The first thing you\u2019ll notice is you now have much more space to write your expression. \u00a0This was the most frequently asked request from you as users. We\u2019ve structured the new editor design so that things can easily get out of the way when you need them to, helping you maximize your space.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1753812,"id":1753812,"title":"Pic02","filename":"Pic02.png","filesize":41771,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online\/pic02-2","alt":"image showing the new arcade editor's interface","author":"6981","description":"","caption":"","name":"pic02-2","status":"inherit","uploaded_to":1742002,"date":"2022-10-31 13:52:42","modified":"2022-11-02 10:48:59","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1430,"height":857,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02.png","medium-width":436,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02.png","medium_large-width":768,"medium_large-height":460,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02.png","large-width":1430,"large-height":857,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02.png","1536x1536-width":1430,"1536x1536-height":857,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02.png","2048x2048-width":1430,"2048x2048-height":857,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02-776x465.png","card_image-width":776,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic02.png","wide_image-width":1430,"wide_image-height":857}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

    \n
  1. It\u2019s important to give your expressions clear and meaningful names, not just so you can find them again when updating your map; the title is used in places like legends and pop-ups to give the expression values meaning and context.<\/li>\n
  2. Clicking the Run <\/strong>button executes the expression and shows you the results. This was previously called Test<\/strong>. It has been renamed to better reflect what the button does and to align better with some future enhancements.<\/li>\n
  3. This is the expression window where you write your Arcade expression and where you\u2019ll find some exciting improvements that we\u2019ll get to in a minute.<\/li>\n
  4. The action bar is a place to browse and access the integrated help as well as all your profile variables (previously called Globals).<\/li>\n<\/ol>\n

    Now that you have your bearings lets dive deeper in to look at what\u2019s new with the various parts.<\/p>\n"},{"acf_fc_layout":"content","content":"

    Profile Variables<\/h3>\n"},{"acf_fc_layout":"image","image":{"ID":1753822,"id":1753822,"title":"ProfileVars","filename":"ProfileVars.gif","filesize":445309,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars.gif","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online\/profilevars","alt":"image showing the profile variable list","author":"6981","description":"","caption":"","name":"profilevars","status":"inherit","uploaded_to":1742002,"date":"2022-10-31 13:53:30","modified":"2022-11-02 10:49:55","menu_order":0,"mime_type":"image\/gif","type":"image","subtype":"gif","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":586,"height":540,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars-213x200.gif","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars.gif","medium-width":283,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars.gif","medium_large-width":586,"medium_large-height":540,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars.gif","large-width":586,"large-height":540,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars.gif","1536x1536-width":586,"1536x1536-height":540,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars.gif","2048x2048-width":586,"2048x2048-height":540,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars-505x465.gif","card_image-width":505,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/ProfileVars.gif","wide_image-width":586,"wide_image-height":540}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

    One of the first things you\u2019ll notice when opening the panel is that profile variables have been renamed from Globals.\u00a0 This change was made to better reflect that these variables while global in nature are defined by the Arcade profile being used (e.g., Labelling, Styling, Pop-ups). They also now contain profile specific descriptions to help you better understand their meaning in in the context of each profile.\u00a0 If you drill into $feature you\u2019ll notice many of the same features as before, but you can now search your fields (also a frequent request from you) and there are icons to denote each field type at a glance. If your field has domains, you can now view and search the domain values to find exactly what you\u2019re looking for quickly.\u00a0 And to get you back to the where you started you can click << to jump to the start of the panel quickly no matter where you were.<\/p>\n

    Functions<\/h3>\n

    There\u2019s quite a bit about this panel that should look familiar; however, ,we\u2019ve added some things to make your life easier. Functions are now grouped into categories, and in addition to the function name, you have the function\u2019s signature at your fingertips.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1753842,"id":1753842,"title":"Pic03","filename":"Pic03.png","filesize":10566,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online\/pic03","alt":"image showing the list of functions","author":"6981","description":"","caption":"","name":"pic03","status":"inherit","uploaded_to":1742002,"date":"2022-10-31 13:55:04","modified":"2022-11-02 10:50:12","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":536,"height":334,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","medium-width":419,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","medium_large-width":536,"medium_large-height":334,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","large-width":536,"large-height":334,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","1536x1536-width":536,"1536x1536-height":334,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","2048x2048-width":536,"2048x2048-height":334,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","card_image-width":536,"card_image-height":334,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic03.png","wide_image-width":536,"wide_image-height":334}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

    If you need additional information, you can dive deeper to get more detailed help along with examples.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1753852,"id":1753852,"title":"Pic04","filename":"Pic04.png","filesize":13198,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online\/pic04","alt":"example of the detailed in app function help","author":"6981","description":"","caption":"","name":"pic04","status":"inherit","uploaded_to":1742002,"date":"2022-10-31 13:55:54","modified":"2022-11-02 10:50:27","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":525,"height":345,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","medium-width":397,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","medium_large-width":525,"medium_large-height":345,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","large-width":525,"large-height":345,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","1536x1536-width":525,"1536x1536-height":345,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","2048x2048-width":525,"2048x2048-height":345,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","card_image-width":525,"card_image-height":345,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Pic04.png","wide_image-width":525,"wide_image-height":345}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

    Functions that have multiple signatures have now been split out into their own entries in the function list as well making it easier to understand the difference at a glance.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1753862,"id":1753862,"title":"Picture5","filename":"Picture5.png","filesize":10956,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online\/picture5-19","alt":"an example image showing a function with multiple signatures","author":"6981","description":"","caption":"","name":"picture5-19","status":"inherit","uploaded_to":1742002,"date":"2022-10-31 13:56:23","modified":"2022-11-02 10:50:53","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":604,"height":314,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","medium-width":464,"medium-height":241,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","medium_large-width":604,"medium_large-height":314,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","large-width":604,"large-height":314,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","1536x1536-width":604,"1536x1536-height":314,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","2048x2048-width":604,"2048x2048-height":314,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","card_image-width":604,"card_image-height":314,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture5.png","wide_image-width":604,"wide_image-height":314}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

    Suggestions<\/h3>\n

    The Suggestion panel consolidates a few different things from the previous Arcade editor into a single panel; Templates and Existing expressions (in the case of Map Viewer).\u00a0 Existing expressions are expressions that are already being used either in the current profile or another profile.\u00a0 These make it easier to copy some or all of an expression into a new one as needed.\u00a0 Additionally, if your profile has Templates you\u2019ll see them in the Suggestions panel too. As the new editor finds its way into other applications, those apps (e.g. Dashboard, Field Maps) can take advantage of the suggestions panel to provide their own context specific examples to help you get started.\u00a0 Look for more exciting things in this panel in the future.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1753882,"id":1753882,"title":"Picture6","filename":"Picture6.png","filesize":11064,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/introducing-the-new-arcade-editor-in-arcgis-online\/picture6-18","alt":"image showing the suggestions user interface","author":"6981","description":"","caption":"","name":"picture6-18","status":"inherit","uploaded_to":1742002,"date":"2022-10-31 13:58:59","modified":"2022-11-02 10:51:12","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":500,"height":489,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6.png","medium-width":267,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6.png","medium_large-width":500,"medium_large-height":489,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6.png","large-width":500,"large-height":489,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6.png","1536x1536-width":500,"1536x1536-height":489,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6.png","2048x2048-width":500,"2048x2048-height":489,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6-475x465.png","card_image-width":475,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/10\/Picture6.png","wide_image-width":500,"wide_image-height":489}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

    Templates is an area that we want to continue to expand on and look to see more templates to help get you started with common arcade expressions we\u2019ve seen many users author.<\/p>\n

    Expression window<\/h3>\n

    This is where things really start to get exciting. A significant amount of engineering has gone on behind the scenes that comes to life in the code window. This effort has been driven by several common themes we\u2019ve seen in gathering feedback from you as users.<\/p>\n