WiscWeb - Embed an ArcGIS visualization

The following document will walk a user through how to embed ArcGIS maps into a WiscWeb site.


    Map types

    At this time, the ArcGIS embed may only work for maps that include "arcgis.com" in the URL. If you have a need to embed something else, please contact us and let us know. You will need to provide a URL to your existing ArcGIS configuration so that we can review it.

    Why? Our embeds are based on the URL structure for the tooling. 

    Publishing views

    Only publicly accessible maps will work for this embed option. Private maps will not embed.

    Why? If a map is private or protected, there is nothing to show on the page. Instead of embedding, link directly to those maps.


    High quality images

    We highly recommend high quality imagery for your ArcGIS maps. This will not only improve the general user experience, but also helps ensure your maps remain as accessible as possible.

    Providing direct link to map

    Depending on the map, it may be a better user experience to link directly to the map rather than embed. Consider doing some user testing to determine which approach makes the most sense.


    Locate the URL

    Ensure that your ArcGIS map is published to “Public.” Copy the URL of your ArcGIS map that appears in your browser’s address bar.

    An address bar that includes a URL for an ArcGIS storymap.

    Add URL to Text Block

    Once you've located and copied your map URL, simply paste that into a Text Block on your site.

    A text block in WiscWeb depicting a URL that has been copied and pasted in.

    Accessibility and usability barriers

    ArcGIS maps have some accessibility barriers:

    In addition to these barriers (and the workarounds provided), we highly recommend visiting the vendor website for additional accessibility tips. This documentation helps guide users through accessible styling options for ArcGIS maps. Here's some highlights:

    And, as with any tool, please consider an alternative display option for the content for those that might be navigating with a screen reader. 

    Clickable data points

    If a mouse user clicks on the data points on an ArcGIS map, a tooltip displays more information. These data points and tooltips do not appear to be accessible via keyboard and screen reader.

    Recommendation: Export the data tables for layers of your web map. This is a more screen reader-friendly option for users.

    Unexpected scrolling

    When navigating via keyboard, the map will occasionally jump/scroll to another location as the user moves the slider across the screen.

    Recommendation: The user will have to move the slider back and forth and eventually, the map will catch up.

    KeywordsarcGIS, visualization, map, embed, analysis, storymap   Doc ID131728
    OwnerJenna K.GroupWiscWeb
    Created2023-09-27 12:00:38Updated2024-02-22 10:18:16
    SitesDoIT Help Desk, WiscWeb
    Feedback  0   0