Configure home page

The home page is the landing page of your organization's website and serves as a gateway for your user community. The home page provides helpful resources and content for organization members and, if you allow outside access, for the public. You can configure a modern and professional-looking home page that reflects your organization's branding and mission and showcases the maps, scenes, apps, and layers that are most important to your community.

Using the customizable components in the home page editor, default administrators and those with the appropriate privileges can design, preview, and deploy a responsive home page that is optimally displayed in both desktop and mobile browsers.

Create a home page

Use the home page editor to create a home page for your ArcGIS Enterprise organization. The home page editor includes a flexible set of components and options that allow you to create a unique entry point to your site. As you configure your page using the home page editor, a live preview of your design choices helps you achieve the look and functionality you want. Use the view options at the bottom of the home page editor to see how your page will appear on different devices.

The following steps and information describe the modern home page configuration experience introduced at 10.9.

If your organization was upgraded to 10.9 from a previous version of ArcGIS Enterprise, see the Legacy home page section below to learn how to transition to the new home page experience. The legacy home page configuration will not be maintained in future upgrades, so it is recommended that you configure the new home page at 10.9 and switch to it when it is ready.

If your ArcGIS Enterprise organization is new at 10.9, you will only see the following home page editor, and the legacy home page configuration options will not be visible.

1. Verify that you are signed in as a default administrator or custom role with administrative privileges to manage the organization website.
2. At the top of the site, click Organization and click the Settings tab.
3. Click Home page on the side of the page.
4. In the Home page editor section, click Launch editor.
5. Configure the elements of your home page as follows:
   • Header—Title, logo, and cover image
   • Body—Item galleries, text, and links
   • Footer—Contact information, custom footer text and links, and footer styling
6. Use the desired View options to preview how your home page will be displayed on desktop, tablet, and mobile devices.
7. Click Save to apply your home page configuration.
8. Click the Close button to close the home page editor.
9. At the top of the site, click Home to see your home page.

Header

The home page header can include any of the following elements: a cover image, an organization title, and an organization logo.

To configure the home page header, do the following:

1. Follow the first four steps of the Create a home page section above.
2. Under Contents, click Header.
3. Optionally, include the title of your organization in the header.
   1. Turn on the Show organization title toggle button.
   2. In the Organization title text box, keep the title (imported from your organization profile settings) or type a new one.
   3. From the Title color drop-down menu, select a color for the title text.
4. Optionally, include an organization logo in the header.
   1. Turn on the Show organization logo toggle button.
   2. Click Choose file and browse to the image file on your desktop.

      Acceptable image formats are PNG, GIF, and JPEG. For best results, the logo should be 300 pixels wide by 300 pixels high.

   3. Pan and zoom to what you want to appear in your logo.

      Depending on the size and resolution of your image file and how far you zoom in to customize the thumbnail, the image can be resampled and scaled when it's saved.

   4. Click Save.
5. Optionally, include a cover image in the header.
   1. Turn on the Show cover image toggle button.
   2. Use one of the following options to select a cover image option:
      • Use a stock cover—Apply a ready-to-use stock cover image. Select an image from the drop-down menu.
      • Upload a custom cover—Upload a custom cover image. Click Choose file and browse to an image file on your desktop. Acceptable image formats are PNG, GIF, and JPEG. Click Save.

        Note:

        Consider the size of your image file before uploading it. Large file sizes may affect performance for some users of the website.

6. Click Layout Options and do any of the following:
   • Select a height for the cover image.
   • Adjust the focal point of the cover image by clicking in the image preview window. The focal point you specify determines the center of the image on all screen sizes.
   • Adjust the opacity of the cover image using the Overlay opacity slider.
   • Adjust the vertical alignment of the title and logo and their horizontal position in relation to the cover image.

     Note:

     If you choose Align left, the alignment of the title adjusts dynamically based on the screen size. If you make the screen size narrow on a desktop device, the title becomes more centered. On a tablet or phone, the title is always centered regardless of the alignment option you choose.

7. Click Save to save your header configuration.

Body

The body of the home page can include up to 15 blocks of content, including text, item galleries, and links. Use text blocks to configure headlines and other text-based content about your organization. Configure item galleries to showcase maps, scenes, apps, and other content items. Add blocks of custom links to help members and visitors discover more content.

When you configure an item gallery, you specify a group that contains the items you want to display. This allows you to configure custom galleries to display different content for different audiences. For example, an organization that allows anonymous access may want some items to be visible only to organization members and hidden from nonmember visitors to the site.

You can control the visibility of item galleries and individual gallery items using a combination of group settings (Who can view this group?) and item sharing levels as follows:

Who is the item gallery for?	Make group viewable by	Set item sharing level to
Everyone (public)	Everyone (public)	Everyone (public)
All organization members	People in the organization	Organization
Specific organization members	People in the organization	Item gallery group and other specific groups

If an item gallery has no visible items for someone viewing the home page, the gallery does not appear. For example, nonmembers will not see a gallery that only contains items shared at the organization level.

When configuring a link block, you can include up to eight links. You can use website URLs and email addresses for your links. Valid HTTPS URLs and mailto link syntax must be used. You can configure the links to appear as underlined text or as buttons.

Each content block can be customized to meet the needs of your organization and user community. Once configured, the blocks can be reordered on the page and edited as needed.

To configure the body of the home page, do the following:

1. Follow the first four steps of the Create a home page section above.
2. Under Contents, click Body.
3. To add a text block, do the following:
   1. Click Add block and click Text.
   2. To include a headline, turn on the Show headline toggle button and type a headline.
   3. To include body text, turn on the Show body copy toggle button and enter the body text in the Body copy text box.

      To include hyperlinks in your body text, click Add link. In the Add link window, enter a link title and a link destination and click Add. The link destination must be a valid HTTPS URL—for example, https://www.arcgis.com/home—or a mailto link—for example, mailto:[e-mail]. The link is added to the Body copy text box using markdown syntax.

   4. Choose an alignment option for your text.
   5. From the Background color drop-down menu, select a background color for the text block.
   6. Click Save to save the text block configuration.
   7. Repeat these steps for each text block.
4. To configure an item gallery, do the following:
   1. Click Add block and click Item gallery.
   2. Click the Group box and find and select a group whose content you want to feature in the gallery.
   3. To include a title, turn on the Show title toggle button and type a title.
   4. To include a summary, turn on the Show summary toggle button and type a summary in the Summary text box.

      To include hyperlinks in the gallery summary, click Add link. In the Add link window, enter a link title and a link destination and click Add. The link destination must be a valid HTTPS URL—for example, https://www.arcgis.com/home—or a mailto link—for example, mailto:[e-mail]. The link is added to the Summary text box using markdown syntax.

   5. Choose an alignment option for the title and summary text.
   6. Select a number from the Number of items displayed drop-down menu.
   7. To change how the items are sorted, select an option in the Sort items by drop-down menu. For example, you can sort items by view count or owner. To order the items in descending order instead of ascending order, uncheck the Sort ascending check box.
   8. From the Display item types drop-down menu, select the type of items to display—for example, Maps or Apps—or select All to display all item types in the gallery.
   9. In the Display preferences section, specify the information you want to display on the item cards. For example, you can turn off the Show item type and Show summary toggle buttons to hide this information. From the Background color drop-down menu, select a different background color for the gallery as needed.
   10. Repeat these steps for each gallery.
5. To add a link block, do the following:
   1. Click Add block and click Link.
   2. In the Link title text box, type a title for the link.
   3. In the Link destination text box, enter a valid website HTTPS URL or email link.

      Tip:

      Valid syntax for email links is mailto:[e-mail].

   4. Click Save to add the link.
   5. Repeat the previous steps to add links to the block.

      Each link block can contain up to eight links.

   6. To display each link as a button, turn on the Show button outlines toggle button. Turn off the toggle button to display the links as underlined text.
   7. From the Background color drop-down menu, select a different background color for the link block as needed.
   8. Do any of the following to manage the links:
      • To edit a link, click the Edit button , make the necessary changes, and click Save.
      • To delete a link, click the Delete button .
      • To change the order of links in the block, click the Reorder button next to a link and drag it to a new position.
6. Click Save when you are finished configuring the blocks.
7. In the Body pane, do any of the following to edit and sort the blocks you configured:
   • To edit a block, click the Edit button , make the necessary changes, and click Save.
   • To delete a block, click the Delete button .
   • To change the position of blocks on the home page, click the Reorder button on a block and drag it to a new position.
8. Click Save when you are finished.

Footer

You can configure a custom contact link for your organization, as well as choose a background color for the footer.

To configure the home page footer, do the following:

1. Follow the first four steps of the Create a home page section above.
2. Under Contents, click Footer.
3. To include custom text—for example, copyright text—in the footer, turn on the Display footer text toggle button and enter the footer text.

   To include hyperlinks in the custom footer text, click Add link. In the Add link window, enter a link title and a link destination and click Add. The link destination must be a valid HTTPS URL—for example, https://www.arcgis.com/home—or a mailto link—for example, mailto:[e-mail]. The link is added to the Footer text box using markdown syntax.

4. To include a Contact Us link in the footer, turn on the Display contact us link toggle button and enter an email address to use for the link.
5. From the Background color drop-down menu, select a background color for your home page footer.
6. Click Save to save your footer configuration.

Note:

You can configure additional links to appear in the home page footer by editing the footerLinks property in the configuration file for your portal. See Set advanced portal options for more details.

Legacy home page

By default, ArcGIS Enterprise organizations that were upgraded to 10.9 from a previous version feature a legacy home page configuration. Support for the legacy home page settings will be discontinued in future upgrades. It is recommended that existing organizations transition to the new home page experience as soon as possible.

Transition to the new home page

Do the following to transition your legacy home page to the new home page:

1. Verify that you are signed in as a default administrator or custom role with administrative privileges to manage the organization website.
2. At the top of the site, click Organization and click the Settings tab.
3. Click Home page on the side of the page.
4. In the Home page editor section, click Launch editor.
5. Configure the components of your new home page.
6. Click Save and switch to make it active.

   Your legacy home page is replaced with the new home page design. You still have access to the legacy home page configuration settings until they are discontinued in a future upgrade.

7. Click Save and click the Close button.
8. At the top of the site, click Home to see your new home page.

Note:

If you need to revert to your legacy home page for any reason, you can do so before the legacy page is no longer supported. From Organization, click Settings, click Home page, and click the previous home page configuration link. At the top of the legacy home page configuration window, click the make this configuration your active home page link. Click Switch to confirm.

Edit the legacy home page

Support for the legacy home page and settings will be discontinued in the future. However, you can still make changes to your legacy home page as needed until you are ready to transition to the new one.

1. Verify that you are signed in as a default administrator or custom role with administrative privileges to manage the organization website.
2. At the top of the site, click Organization and click the Settings tab.
3. Click Home page on the side of the page.
4. In the Switch your active home page section, click the current home page configuration link.
5. Configure any of the following home page settings:
   • Appearance
   • Featured content
   • Organization description

Note:

The home page cannot be embedded in other web apps, such as ArcGIS StoryMaps. This is because the X-Frame-Options: SAMEORIGIN header is used to prevent a security vulnerability for the portal.

Appearance

You can customize the appearance of your home page by setting a background image and a banner image.

Under Background image, select the default image, upload your own image, or specify no background image. If you upload your own image, the image is positioned at the top and center of the page. The image repeats horizontally if it is smaller than the browser or device window. For best results, if you want a single, nonrepeating background image, the image should be 1,920 pixels wide (or smaller if your users are on smaller screens). The website does not resize the image. It is recommended that you do not upload a file greater than 1 MB in size.

Under Banner image, select an image, upload your own image, or choose to create a custom design. For best results, your image should be 960 pixels wide. The organization logo and title will not display on the home page when using a custom image. To create the custom design, you can use the rich text editor or switch to HTML source code view.

Featured content

Choose a group whose content you want featured on your home page. The default setting is No featured content. You can select the number of items to display on your home page—all or multiples of 4, up to 32.

To change how the items are sorted, select an option in the Sort order drop-down list, and to change how the items are ordered, choose either Ascending or Descending. If you change the sort field or order here, the items on the group page, as well as on embedded galleries or gallery apps, are also changed.

Tip:

In most cases, administrators want to share items that are either publicly accessible or shared with all users of your ArcGIS Enterprise organization. If a user doesn't have access to an item, they cannot view it in the Featured Content section. To share a user's content with the Featured Maps and Apps group, ensure that they are a member of the group; otherwise, their content cannot be shared to the group.

Organization description

Provide a description for your organization. To paste or type your own supported HTML code, switch to HTML source code view.

If you want the description to appear on your home page, check Show description toward bottom of Home Page. It appears under the banner.