ArcGIS Hub

Translating ArcGIS Hub sites and pages

Providing hub sites and pages in multiple languages is an important part of the work many organizations do in serving their communities. This post provides instructions on how to manually translate your sites and pages and how to turn on the beta capability for automatic site translation.

Option 1: Turn on the Site Translation capability

The Site Translation capability uses Google Translate and enables site visitors to choose their language by clicking a button.

Note: The automatic site translation beta capability uses tools from Google that are currently deprecated. While an official date has not yet been announced, Google has plans to fully disable support for these tools. While you can continue using this translate capability, anticipate changes to how this capability will perform if enabled for your sites.

The ArcGIS Hub team continues to evaluate new approaches to providing this functionality and recommends manually translating your sites and pages as a best practice.

The selected language translates the site’s layout, including its pages and navigation.

Google Translate has been deprecated by Google, so this functionality may cease functioning at any time.

To turn on this capability, open a site or initiative in edit mode and follow these steps:

  1. Click Settings on the side panel.
  2. Click Beta.
  3. Click the toggle for Site Translation.
  4. Click Save and View to confirm your changes.

Option 2: Manual translation

If you want to provide content that is automatically translated, similar to these sites created by the Ontario GeoHub and the City of Fredericton, you can manually translate versions of your site.
  1. If you have one site with no pages, create a page to mirror the parent site with localized content.
  2. If you have a site that already uses pages, clone and translate the site, then add new, translated versions of the pages.

 

Before you get started, consider finalizing the site you want to translate. This may include confirming mobile-responsiveness, getting approval from stakeholders, and ensuring that the copy is proofread and accurate. Doing so will limit the amount of time spent updating multiple layouts.

 

If you have a finished site that has no pages, we recommend adding a page to create a translated version of the site. Pages adopt the parent site’s header, domain, and footer ensuring consistency across your site’s content.

1. Create a page

To get started, open a site or initiative site and go to its layout editor. Add a page by clicking the page button at the top-right corner of the side panel and choosing New Page.

When naming your site, be descriptive rather than simply entering the name of a language (e.g. Edison Open Data – Spanish vs Spanish). A new page is added as an item to your organization’s subscription to ArcGIS Online, so you want to ensure that it’s clearly labeled relative to other content.

While the new page adopts the parent site’s domain, it will have its own slug based on its name (https://share-open-data-english-hubclub.hub.arcgis.com/pages/open-data-spanish). You can modify the slug of your page to something else, if you’d prefer.

2. Add translated content

Once the new page is generated, you can begin modifying its layout to match that of its parent site, this time with translated copy.

For example, the open data site pictured above uses several category cards to provide high-level navigation to content related specifically to a topic or group. Because this card uses images, it’s useful for displaying localized content, minimizing the amount of words needed to showcase available content.

Datasets are not automatically translated and will remain in the primary language. Because two items can point to the same data, you can register data as hosted feature layers to supply translated titles and descriptions, then add them to your site’s content library. The data itself will remain in its original language unless it was originally formatted in multiple languages. For information on publishing hosted feature services in Portal for ArcGIS, see Publish hosted feature layers. Similar instructions for publishing feature layers in ArcGIS Online can be found here.

 

3. Link the translated page to the primary site

After you’ve finished designing the layout of your page and connecting it to content, you can add a link to the page in the parent site’s header. To do this, go to the site’s layout editor and click Header in the side panel and click Menu.

Then, click Add Link and choose to existing content. Find the translated page and click Select. The link will appear in the header.

Next, simplify the name of the menu link to just the name of the language. You can do this by clicking on the link’s settings button and choosing Edit. Enter the name of the language that the page is translated in and click Save.

To verify your changes, click Save and View in the edit navigation bar. Then, click the menu link to your translated page.

If you want to manually translate a site with multiple pages

Unlike sites, pages cannot be cloned. So, if you have a site that already has pages, we recommend that you clone the original site, localize it, then add a new page with translated copy for every page attached to the original site.

1. Clone the original site

To get started, clone the original site or initiative site by clicking the more menu in the edit navigation bar and choosing Clone Layout.

When you clone an ArcGIS Hub Basic site, a new Hub Site Application item is added to ArcGIS Online called Site Name - Copied. Cloned layouts of initiative sites (ArcGIS Hub Premium) generate two items in ArcGIS Online: Initiative Name - copied (which is a Hub Initiative item) and Initiative Site Name - Copied (which is a Hub Site Application) item.

2. Update the cloned site with localized copy

A clone is essentially a copy of your original site, so you don’t have to recreate the site. You just have to swap out the existing copy with localized copy.

3. Add new pages to the cloned site

Next, follow steps to add a new page (see above section, Create a page).

Be sure to name each translated page something unique so that it isn’t confused with the original page. This is because a page added to a Hub Site Application item is called a Hub Page item. Unlike cloned items, it will not automatically include Copied in its name, even if it’s added to a cloned site.

 

On the new page, add cards and rows to mirror the original site’s page. This time, add the localized copy. Repeat the process for creating a new page for every page attached to the original site.

Once you’ve finished translating the new pages, you can add menu links to the cloned site’s header. Go to the cloned site’s layout editor and click Header in the side panel and click Menu. Then, add links to the pages and simplify their names to just the language (i.e. Français). Because a page automatically adopts the menu links and branding established in the site’s header, you don’t have to add additional links to your pages’ header.

Next steps

Don’t forget to edit the 1) thumbnail and 2) summary for your new translated sites and pages. Doing so ensures that each of these items will have its own unique description when displayed in search results or as part of a gallery on another site or page. To get started, go to ArcGIS Online and select the page or cloned site’s item to edit its details.

For questions or comments, reach out to us on GeoNet or reply to this post. You can also sign up for our monthly e-newsletter to receive product announcements and similar tips and tricks from our team.

About the author

As a product marketer for ArcGIS Urban, Katie enjoys sharing product announcements and best practices with the Esri community.

3 Comments
Oldest
Newest
Inline Feedbacks
View all comments

Next Article

Drawing a Blank? Understanding Drawing Alerts in ArcGIS Pro

Read this article