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, or blocks, 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 Online 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 in June 2020. ArcGIS Online organizations established after June 2020 only have access to this home page experience.

If your organization was established before June 2020, see the Legacy home page section below to learn how to transition to the new home page experience.

  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 content elements of your home page as follows:
    • Header—Title, logo, and cover image
    • Content blocks—Item galleries, text, and links
    • FooterContact information, custom footer text and links, and footer styling
  6. Configure the colors of your home page.
  7. Use the desired View options to preview how your home page will be displayed on desktop, tablet, and mobile devices.
  8. Click Save to apply your home page configuration.
  9. Click the Close button Close to close the home page editor.
  10. 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 Content, 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 Header colors drop-down menu, select a color for the title text.
      Note:

      If you have already specified a preset or custom color theme for your home page design, selecting a new color from the drop-down menu will override the color style specified for this element.

  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.

Content blocks

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 bySet item sharing level to

Everyone (public)

Everyone (public)

Everyone (public)

All organization members (no nonmembers)

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 content blocks on the home page, do the following:

  1. Follow the first four steps of the Create a home page section above.
  2. Under Content, click Content blocks.
  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:info@example.com. The link is added to the Body copy text box using markdown syntax.

    4. Choose an alignment option for your text.
    5. From the Block colors drop-down menu, select a background color for the text block.
      Note:

      If you have already specified a preset or custom color theme for your home page design, selecting a new color from the drop-down menu will override the color style specified for this element.

    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:info@example.com. 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 Item display preferences section, do any of the following:
      • From the Block colors drop-down menu, select a different background color for the gallery as needed.
        Note:

        If you have already specified a preset or custom color theme for your home page design, selecting a new color from the drop-down menu will override the color style specified for this element.

      • Specify the information you want to display on the item cards. For example, you can turn off the Show item type and Show item summary toggle buttons to hide this information.
    10. Repeat these steps for each gallery.
  5. To add a link block, do the following:
    1. Click Add block and click Link.
    2. Click Add link.
    3. In the Link title text box, type a title for the link.
    4. In the Link destination text box, enter a valid website HTTPS URL or email link.
      Tip:

      Valid syntax for email links is mailto:info@example.com.

    5. Click Add to add the link.
    6. Repeat the previous steps to add links to the block.

      Each link block can contain up to eight links.

      Note:

      Links are not supported for trial subscriptions.

    7. 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.
    8. From the Block colors drop-down menu, select a different background color for the link block as needed.
      Note:

      If you have already specified a preset or custom color theme for your home page design, selecting a new color from the drop-down menu will override the color style specified for this element.

    9. Do any of the following to manage the links:
      • To edit a link, click the Edit button Edit, make the necessary changes, and click Save.
      • To delete a link, click the Delete button Delete.
      • To change the order of links in the block, click the Reorder button Reorder 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 Edit, make the necessary changes, and click Save.
    • To delete a block, click the Delete button Delete.
    • To change the position of blocks on the home page, click the Reorder button Reorder on a block and drag it to a new position.
  8. Click Save when you are finished.

Footer

By default, the home page footer contains three preconfigured links, including a Contact Esri link. You can also configure a custom contact link and footer text 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 Content, 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:info@example.com. 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 Block colors drop-down menu, select a background color for your home page footer.
    Note:

    If you have already specified a preset or custom color theme for your home page design, selecting a new color from the drop-down menu will override the color style specified for this element.

  6. Click Save to save your footer configuration.

Colors

The home page editor gives you control over the colors displayed on your home page. You can choose from a list of eight preset themes to apply to your home page content. Each color theme contains color styles that define the text, background, headline, and button or link colors.

If the preset themes don’t meet your needs—for example, if your organization has specific color branding requirements—you can create your own custom color theme with color styles that you configure.

To configure colors for the home page, do the following:

  1. Follow the first four steps of the Create a home page section above.
  2. Under Design, click Colors.
  3. Select Use preset themes or Set up a custom theme.
  4. If you are using preset themes, select a preset theme from the list and optionally modify the color style applied to any of the home page components—for example, a text block or gallery.
  5. If you are configuring a custom color theme, configure one or more custom styles as follows:
    1. Under Custom color styles, click Add custom style.
    2. Type a name for the style.
    3. Under Configure colors, click the Edit custom style button Edit custom style beside a block element—for example, Background.
    4. Specify a color by entering a hex value, RGB values, or HSV values, or by selecting a color from the color picker or the palette of recommended colors or shared theme colors (if defined).
    5. Repeat these steps for each block element for which you want to configure colors.
    6. If any elements are marked as Not legible, click the Edit custom style button Edit custom style for the element and configure a different color.

      You could adjust the background color instead.

      Note:

      A contrast ratio is calculated and displayed for the each of the title, summary, and link or button colors. The contrast ratio is a measure of the amount of contrast between the background color and each of these specified colors. Higher contrast ratios have better legibility based on WCAG 2.1 accessibility standards. A contrast ratio of less than 4.5 is flagged as Not legible.

    7. In the Add custom style window, click Save when you are finished.
  6. To create additional custom styles, repeat the previous step.
    Tip:

    To create a custom color style based on an existing style, you can click the Edit button Edit for a style, type a name for the new style, configure the style colors, and click Save as new style.

  7. To edit a custom color style, click the Edit button Edit, make changes to the style name or colors, and click Overwrite style.
  8. To remove a custom color style, click the Delete button Delete, confirm that you want to delete the style, and click Remove.
    Note:

    If you remove the style, a gray style is applied to any home page blocks that are styled with the custom style you want to remove.

  9. Click Save to save your color configuration.

Legacy home page

By default, ArcGIS Online organizations that were established before the June 2020 update of ArcGIS Online feature a legacy home page configuration. Support for the legacy home page settings will be discontinued after 2021. To ensure that your home page is compatible with future updates of ArcGIS Online, 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 after 2021.

  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 after 2021. 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

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 and choose a value for Number of items to display—all or multiples of 4, up to 32. Four items per page are displayed. You can also choose not to feature any content.

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.

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.