Share widget

(Added at v2.1)

The Share widget allows you to share an app by posting it to your social media account, sending an email with a link, or embedding it in a website or blog. It also provides an easy way to define URL parameters for the app.

Configure the Share widget

This widget can be set to open automatically when an app starts. Hover over the widget and click the Do not open this widget when the app starts button to change the setting to Open this widget automatically when the app starts. (For widgets that you need to add to the app first, you can turn on this option after configuring the widget.)

To configure the Share widget, choose any of the following sharing options:

• Email
• Facebook
• Twitter
• Google+

Use the Share widget

1. Click the Share widget to open it.
2. Copy the short link under Share a link to this app and paste it into your email, instant message, and so on.

   You can also use the provided buttons to post your app to your Facebook, Twitter, or Google accounts, or to add it to an email.

3. Optionally, click Link options to include URL parameters in the short link that modify the map in the app. See Use URL parameters.
   1. Choose from the following options to add applicable URL parameters. You can see the URL change in the Link preview box.
      • Current map extent—This is used by default.
      • Click the map to define the center of the map with zoom level—Click a location in the map to specify where to center the map in the app when it opens. A point marker is added on the map, and the URL in the link preview is updated with center coordinates and the map zoom level.
      • Click the map to define the center of the map with map scale—Click a location in the map to specify where to center the map in the app when it opens. A point marker is added on the map, and the URL in the link preview is updated with center coordinates and the map scale.
      • Find the location or feature and zoom to it—Type a location in the box, such as Redlands, CA, 92373, or a feature in a searchable layer. The URL is updated with a parameter to zoom the map to the found location when the app opens.
      • Query a feature and zoom to it—Choose a layer, a field, and a value from the menus to perform a query that finds features that match. Attribute values are sorted in ascending order. Type in the search box to select from a reduced list of relevant values. The URL is updated with a parameter to show query results in the map when the app opens.
      • Add a marker on the map—Provide values for WKID, Pop-up title, Symbol, and Label. Click the point symbol and click a location in the map to add a marker with a pop-up.
      • Overwrite default screen size of mobile layout—Type the screen size in pixels. By default, when the height or width of a screen display is less than 600 pixels, the mobile layout automatically applies.
      • Set display language of the app—Choose a language code from the menu.
      • Remember layers visibility—Uses the current layer visibility of the map.

        Caution:

        If the map content has many layers, remembering layer visibility can result in a long URL that may fail to be interpreted by the server. The Share widget tries to shorten the URL by encoding the layer ID using Hash algorithms, if possible, but it does not guarantee a practicable URL. (The showLayersEncoded= or hideLayersEncoded= parameter is used in the URL if the layer ID is encoded.)

        A warning message appears when the URL exceeds 2048 characters (most servers have a limit of 2048 characters for interpreting a URL). If you see this warning, it is recommended to ignore layer visibility.

   2. Click Back to return to the main panel.

      The short link is updated to reflect the URL changes that you made.

4. Under Embed this app in a website, copy the HTML code and paste it into your website. Optionally, click Embed options and choose a size for the embedded app to update the code.