One of the ways you can share maps, apps, or a group of maps and apps is to include them in a web page such as a blog or your organization's website. ArcGIS Enterprise provides the code you need and gives you options for the layout and display. You need sharing privileges to embed maps, apps, and groups using the tools in the ArcGIS Enterprise portal.
Embed a map
To embed a public map you've opened in Map Viewer using ready-to-use HTML code, do the following:
- In Map Viewer, open a saved map.
- Verify that the map is shared with everyone (public).
Note:
If the map is not shared publicly, clicking Embed map
will automatically open the map sharing settings.See Considerations for sharing maps for more information.
- On the Contents (dark) toolbar, click Embed map .
- Optionally, in the Embed window, configure the map with the following:
- Choose a map mode (light or dark).
- Check the boxes next to the map elements you want to include on the map: map title, legend, map summary, and bookmarks.
- Turn on the Open in map viewer toggle button to enable the option to open the embedded map in Map Viewer.
- Click Copy HTML to copy the HTML code provided.
- Paste the code into the web page where you want the map to appear.
Note:
The HTML code contains a script tag and the custom element with the map to embed. Paste the script tag into the <head> of the web page. Add the custom element to the <body> of the web page where you want the map to appear.
Embed an app
You may want to embed an app in a website instead of embedding the map. Embedding an app can be useful in various scenarios. The following are some examples:
- Show an app you have created using an ArcGIS Configurable Apps template (for example, using the Basic Viewer template) that includes all the app functionality you configured.
- Show a map that includes a premium service with embedded credentials, such as the World Routing Service, by embedding an app created from the Directions template or using the Directions widget in ArcGIS Web AppBuilder.
You can embed an app in a website using the Embed in Website option when you embed a public web map. To embed the app instead of the map, modify the generated HTML code as described in the steps below. These steps can be used to embed a hosted web app or a Web AppBuilder app.
- Verify that you are signed in with an account that has privileges to share content.
- Create a map and web app.
- Copy the URL for the app from the Overview tab of the app's item page or from the address bar in your web browser when the app is open.
- In Map Viewer Classic, open the map that was used to create the app and click Share.
Note:
This functionality is currently only supported in Map Viewer Classic. It will be available in a future release of Map Viewer.
- Verify that the map is shared with everyone (public), and click Embed in Website.
If this option is not available, it means the map is not public and you cannot embed it. If you own the map, you can change its status to public.
- Choose the desired size for embedding the app.
- From the HTML code that's provided, remove the portion of the code after src= and before ></iframe> and replace it with the app URL you copied.
For example, you would remove "http://arcgis.com/apps/Embed/index.html?webmap=4cc9f0ba8e8c4d68b50c01c17efd4730" and replace it with "http://arcgis.com/apps/View/index.html?appid=6b6a075eca8d4899958fb273710a6806". The updated portion of code should look similar to the following:
<iframe width="500" height="400" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="https://arcgis.com/apps/View/index.html?appid=6b6a075eca8d4899958fb273710a6806"></iframe> - Copy and paste the entire HTML code block to the website configuration.
Tip:
You can also use URL parameters to control the look and feel or functionality of the app that you are embedding.
Embed a group of maps and web apps
Note:
The embed gallery is deprecated. Any embed code copied into a web page will continue to work until it is officially retired. Showcase group content using Instant Apps instead.
When you embed a group through the portal website, you choose a layout and how to display the group items. You can only embed public groups, and only maps and web apps display in the embedded gallery.
- Open the public group you want to embed.
- On the Overview tab, click Create web app.
- Click the Embed (deprecated) button
.If neither option is available, it means the group is not public, and you cannot embed it. Group owners, managers and those with the privileges to manage groups can change its status to public.
- Choose a layout for the group items.
- Choose how to display the maps and web app: over the embedded gallery, in a new window with a predefined gallery app, or in a new window with a configured app.
Provide a URL to the app if you chose to display the items in a new window with a configured app.
- Copy the HTML code that's provided.
- Click Done.
- Paste the code into the web page where you want the group to appear.