{"id":230982,"date":"2019-05-21T20:07:14","date_gmt":"2019-05-22T03:07:14","guid":{"rendered":"https:\/\/www.esri.com\/about\/newsroom\/?post_type=arcuser&p=230982"},"modified":"2019-05-21T20:07:14","modified_gmt":"2019-05-22T03:07:14","slug":"make-your-work-easy-to-find-understand-and-use-by-others","status":"publish","type":"arcuser","link":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others","title":{"rendered":"Make Your Work Easy to Find, Understand, and Use by Others"},"author":1031,"featured_media":0,"menu_order":0,"template":"","format":"standard","meta":{"_acf_changed":false,"sync_status":"","episode_type":"","audio_file":"","castos_file_data":"","podmotor_file_id":"","cover_image":"","cover_image_id":"","duration":"","filesize":"","filesize_raw":"","date_recorded":"","explicit":"","block":"","itunes_episode_number":"","itunes_title":"","itunes_season_number":"","itunes_episode_type":"","_links_to":"","_links_to_target":""},"categories":[10392,25022],"tags":[11272,346342],"arcuser_issues":[339722],"class_list":["post-230982","arcuser","type-arcuser","status-publish","format-standard","hentry","category-arcgis-online","category-hands-on","tag-demographics","tag-matadata","arcuser_issues-spring-2019"],"acf":{"short_description":"Filling out the Details page for items you create in ArcGIS Online makes those items more valuable to you and others in your organization.","pdf":{"host_remotely":false,"file":"","file_url":""},"flexible_content":[{"acf_fc_layout":"pdf","file":231012},{"acf_fc_layout":"blockquote","content":"

You\u2019ve put the finishing touches on your layer, web map, or configurable app. You\u2019re ready to share it with the world, right? Well\u2026maybe you are if you\u2019ve been updating your item\u2019s Details page as you\u2019ve been working. If you\u2019re like me, you leave this important step until the end. Don\u2019t omit it.<\/strong><\/p>"},{"acf_fc_layout":"content","content":"

What Is a Details Page?<\/h2>\r\n

The Details page is the place where you let other ArcGIS users know what your item\u2014your layer, web map, or configurable app\u2014is all about. The title, the summary, and the description answer the question, what is this? in progressively more descriptive ways. The Details page is also the place to provide the source, the terms of use, any data footnotes or field definitions, and the general metadata that would be hidden when viewing the item.<\/p>\r\n

<\/p>"},{"acf_fc_layout":"image","image":231032,"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Every ArcGIS Online Item Has a Details Page<\/h2>\r\n

Layers, web maps, scenes, configurable apps, story maps, even tables and images that have been uploaded to your ArcGIS account all have a Details page. A very common workflow is to first author a data layer, then create a web map from this layer, then display the web map along with some context in a configurable app or story map. The layer, the web map, and the app each have a Details page. Ideally, each Details page has been filled out\u2014not just the Details page for the app. That way, the building blocks of your app\u2014the layers and web maps\u2014can stand alone. This can be helpful when a colleague or external GIS user wants to use a part of your app or story map.<\/p>\r\n

ArcGIS Online provides some basic guidance on the page with the scoring bar. Rather than providing specific numbers, the scoring bar simply displays progress on a spectrum from low to high. If your page is scoring on the low side, it lists suggestions for top improvements.<\/p>\r\n

<\/p>"},{"acf_fc_layout":"image","image":231042,"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Why Document Your Item?<\/h2>\r\n

Those who use your item will thank you! A complete Details page for every item not only makes your work easy to find, understand, and use by others but it also makes your item more credible. And it\u2019s required when nominating an item for inclusion in ArcGIS Living Atlas of the World and it makes your web map social media ready. For example, when I shared a map entitled \u201cWhere Are the Households with No Vehicles Available\u201d on Twitter, the title, image, and blurb right from my Details page were picked up by Twitter.<\/p>\r\n\r\n

Six Tips to Document Your Item<\/span><\/h2>\r\n

1. Document as you work.<\/h3>\r\n

It\u2019s part of the process when publishing a layer or web map from ArcGIS Pro, as you\u2019re prompted for the basics such as title, tags, and summary before your item even exists in ArcGIS Online. Similarly, when creating a new item or adding an item from your computer, you are prompted for tags and a summary. You could skip this step in the moment, but by filling it out immediately, you will avoid having to go back and do it later. If you\u2019re unsure of what your final title or summary will be, that\u2019s okay. You can always edit it later.<\/p>\r\n\r\n

2. Cite the original data source in the Credits (Attribution) section.<\/span><\/h3>\r\n

Be a responsible data user. Give credit where credit is due. Doing this makes your item look more trustworthy. Providing a link to the original data source in the Description section could inspire other users who want to build on your work. Besides, including the source moves that scoring bar toward the high end.<\/p>\r\n\r\n

3. Think of someone who comes across your item online.<\/h3>\r\n

What information would you need to tell that person about your work? Why is this item valuable? Is there jargon or acronyms that are obvious to you that may not be so obvious to a lay audience? Are there any acronyms that you can spell out in the description? Are there any field definitions or data footnotes that should be noted?<\/p>\r\n\r\n

4. Choose effective tags that make your item discoverable.<\/h3>\r\n

What question does your item answer? This can be a great place to start thinking about tags. For example, my map on the teen employment rate answers questions about youth, the workforce, labor supply, and even policy\u2014those are all great tags. There might be reasons to use the geography level, such as census tracts or counties, as tags. Similarly, there might be a reason to include the source as a tag.<\/p>\r\n

Review any tags that have been automatically generated. If you\u2019ve performed analysis or geoenrichment, you will have automatically generated tags such as analysis result or enriched layer. While these tags are often helpful to the map author, they are not helpful to the viewer of the final web map or app, so delete them as appropriate.<\/p>\r\n\r\n

5. Take the time to make a nice thumbnail.<\/h3>\r\n

This is especially important for top-tier content that you share publicly. A picture is worth a thousand words, right? For best results, the thumbnail should be 600 by 400 pixels.<\/p>\r\n\r\n

6. Use markup, formatting, indentation, color, and images to your advantage.<\/h3>\r\n

It\u2019s easy to change the color of text in the Description section so that it can match your legend, or even add images.<\/p>\r\n

Let\u2019s look at some tips for web maps, apps, and story maps. <\/span><\/p>\r\n\r\n

Web Maps<\/h2>\r\n

My web map, What Are Children\u2019s Living Arrangements?, displays the predominant type of family by state, county, and tract. By taking a screenshot of this map with an open pop-up, hosting it as an image, and using it in the description, I can communicate the legend and pop-up information at the same time.<\/p>\r\n\r\n

Apps and Story Maps<\/h2>\r\n

Occupations Vulnerable to Extreme Heat, a tabbed story map, shows four different categories of workers, one tab for each category, and then a final predominance map showing all four. The app\u2019s Details page uses the same color map as the ones used in the map for the details about each occupation category, with links to the authoritative source on occupation definitions.<\/p>\r\n

<\/p>"},{"acf_fc_layout":"image","image":231052,"image_position":"left","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

More Reasons to Love the Details Page<\/h2>\r\n

Up until now, I\u2019ve discussed only the Overview tab. There\u2019s also a Usage tab that lets you track the number of views your item is getting. The Settings tab lets you turn on delete protection, mark the status, set the extent, and control the user experience for your item. For layers, a Data tab and Visualization tab let you do some quick checks without having to open the layer in a map. All the metadata on the Details page helps you as the item\u2019s creator and helps others collaborate across the entire ArcGIS platform.<\/p>\r\n

For more information, visit the ArcGIS Online documentation topic \u201cItem details<\/a>.\u201d<\/p>"}],"references":null},"yoast_head":"\nMake Your Work Easy to Find, Understand, and Use by Others<\/title>\n<meta name=\"description\" content=\"The Details page is also the place to provide the source, the terms of use, any data footnotes or field definitions, and the general metadata that would be hidden when viewing the item. Don\u2019t omit it.\" \/>\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.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Make Your Work Easy to Find, Understand, and Use by Others\" \/>\n<meta property=\"og:description\" content=\"The Details page is also the place to provide the source, the terms of use, any data footnotes or field definitions, and the general metadata that would be hidden when viewing the item. Don\u2019t omit it.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others\" \/>\n<meta property=\"og:site_name\" content=\"Esri\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/esrigis\/\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2019\/05\/uq219_itemdetails_card.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@Esri\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\n\t \"@context\": \"https:\/\/schema.org\",\n\t \"@graph\": [\n\t {\n\t \"@type\": \"WebPage\",\n\t \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others\",\n\t \"url\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others\",\n\t \"name\": \"Make Your Work Easy to Find, Understand, and Use by Others\",\n\t \"isPartOf\": {\n\t \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#website\"\n\t },\n\t \"datePublished\": \"2019-05-22T03:07:14+00:00\",\n\t \"description\": \"The Details page is also the place to provide the source, the terms of use, any data footnotes or field definitions, and the general metadata that would be hidden when viewing the item. Don\u2019t omit it.\",\n\t \"breadcrumb\": {\n\t \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others#breadcrumb\"\n\t },\n\t \"inLanguage\": \"en-US\",\n\t \"potentialAction\": [\n\t {\n\t \"@type\": \"ReadAction\",\n\t \"target\": [\n\t \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others\"\n\t ]\n\t }\n\t ]\n\t },\n\t {\n\t \"@type\": \"BreadcrumbList\",\n\t \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others#breadcrumb\",\n\t \"itemListElement\": [\n\t {\n\t \"@type\": \"ListItem\",\n\t \"position\": 1,\n\t \"name\": \"Home\",\n\t \"item\": \"https:\/\/www.esri.com\/about\/newsroom\"\n\t },\n\t {\n\t \"@type\": \"ListItem\",\n\t \"position\": 2,\n\t \"name\": \"Make Your Work Easy to Find, Understand, and Use by Others\"\n\t }\n\t ]\n\t },\n\t {\n\t \"@type\": \"WebSite\",\n\t \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#website\",\n\t \"url\": \"https:\/\/www.esri.com\/about\/newsroom\/\",\n\t \"name\": \"Esri\",\n\t \"description\": \"Esri Newsroom\",\n\t \"potentialAction\": [\n\t {\n\t \"@type\": \"SearchAction\",\n\t \"target\": {\n\t \"@type\": \"EntryPoint\",\n\t \"urlTemplate\": \"https:\/\/www.esri.com\/about\/newsroom\/?s={search_term_string}\"\n\t },\n\t \"query-input\": {\n\t \"@type\": \"PropertyValueSpecification\",\n\t \"valueRequired\": true,\n\t \"valueName\": \"search_term_string\"\n\t }\n\t }\n\t ],\n\t \"inLanguage\": \"en-US\"\n\t },\n\t {\n\t \"@type\": \"Person\",\n\t \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/82e5143bcdebadf8fd64d84e503ca468\",\n\t \"name\": \"Monica Pratt\",\n\t \"image\": {\n\t \"@type\": \"ImageObject\",\n\t \"inLanguage\": \"en-US\",\n\t \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/image\/\",\n\t \"url\": \"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg\",\n\t \"contentUrl\": \"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg\",\n\t \"caption\": \"Monica Pratt\"\n\t },\n\t \"description\": \"Monica Pratt is the founding and current editor of ArcUser magazine, the executive editor of ArcNews magazine, the editor of Esri Globe and head of the Publications team at Esri. She has been writing on technology topics, specializing in GIS, for more than 30 years. Before joining Esri in 1997, she worked for newspapers and in the financial industry.\",\n\t \"sameAs\": [\n\t \"https:\/\/x.com\/ArcUser\"\n\t ],\n\t \"url\": \"\"\n\t }\n\t ]\n\t}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Make Your Work Easy to Find, Understand, and Use by Others","description":"The Details page is also the place to provide the source, the terms of use, any data footnotes or field definitions, and the general metadata that would be hidden when viewing the item. Don\u2019t omit it.","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.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others","og_locale":"en_US","og_type":"article","og_title":"Make Your Work Easy to Find, Understand, and Use by Others","og_description":"The Details page is also the place to provide the source, the terms of use, any data footnotes or field definitions, and the general metadata that would be hidden when viewing the item. Don\u2019t omit it.","og_url":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others","og_site_name":"Esri","article_publisher":"https:\/\/www.facebook.com\/esrigis\/","og_image":[{"url":"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2019\/05\/uq219_itemdetails_card.jpg","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_site":"@Esri","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others","url":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others","name":"Make Your Work Easy to Find, Understand, and Use by Others","isPartOf":{"@id":"https:\/\/www.esri.com\/about\/newsroom\/#website"},"datePublished":"2019-05-22T03:07:14+00:00","description":"The Details page is also the place to provide the source, the terms of use, any data footnotes or field definitions, and the general metadata that would be hidden when viewing the item. Don\u2019t omit it.","breadcrumb":{"@id":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/make-your-work-easy-to-find-understand-and-use-by-others#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.esri.com\/about\/newsroom"},{"@type":"ListItem","position":2,"name":"Make Your Work Easy to Find, Understand, and Use by Others"}]},{"@type":"WebSite","@id":"https:\/\/www.esri.com\/about\/newsroom\/#website","url":"https:\/\/www.esri.com\/about\/newsroom\/","name":"Esri","description":"Esri Newsroom","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.esri.com\/about\/newsroom\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/82e5143bcdebadf8fd64d84e503ca468","name":"Monica Pratt","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/image\/","url":"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg","contentUrl":"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg","caption":"Monica Pratt"},"description":"Monica Pratt is the founding and current editor of ArcUser magazine, the executive editor of ArcNews magazine, the editor of Esri Globe and head of the Publications team at Esri. She has been writing on technology topics, specializing in GIS, for more than 30 years. Before joining Esri in 1997, she worked for newspapers and in the financial industry.","sameAs":["https:\/\/x.com\/ArcUser"],"url":""}]}},"sort_order":"18","_links":{"self":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser\/230982","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser"}],"about":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/types\/arcuser"}],"author":[{"embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/users\/1031"}],"version-history":[{"count":0,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser\/230982\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/media?parent=230982"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/categories?post=230982"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/tags?post=230982"},{"taxonomy":"arcuser_issues","embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser_issues?post=230982"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}