Service Page

A hub for the information and transactions that make up a program or service.

Summary

This resource will help you navigate the Service Page content type. The Service Page is a hub for the details and transactions that make up a program, service, or process. It plays an important role across Mass.gov, and sometimes you’ll need to do some planning before making one:

Examples of services include:

Required fields

To save a draft of a Service Page, you will need to add something to these fields/sections:

  • Service name

  • Short description

  • Banner image (for desktop displays)

  • Organization(s)

📊Service pages feature the Analytics Dashboard (Beta).📊

Banner and Overview tabs

Service name and Short description

The Service name and Short description are the first things your audience sees. In fact, they might see them before they get to the page: If they’re coming from Google, the Service name (a.k.a., the page title) is what will draw them in. Service names and Short descriptions also appear on Mass.gov’s Topic Pages when those pages link to Service Pages. Try to write them using words you think your audience would enter into a search engine.

Service page template

You can choose to set up your Service Page using either Default or Custom link groups. Default link groups let you arrange links under the headings "What would you like to do?" and "What you need to know."

Custom link groups allow you to define the headings for up to 6 groups of 10 links or documents. These link groups will all appear under a main heading of "What would you like to do?" that cannot be changed. Learn more about Custom link groups.

Choosing Custom link groups

Organization(s)

You’ll find the Organization(s) field at the bottom of the first tab in every Mass.gov content type, and in documents. This field tells Mass.gov’s search which pages belong to which organization. ‌ This field also powers the "Offered by" relationship indicator that displays at the top of all Mass.gov pages. "Offered by" displays on the top right if there is a "Part of" relationship indicator on the left in a desktop view, or on the top left if there is no "Part of" link. On a smaller screen, "Offered by" appears directly under "Part of" at the top of the page. ‌ Making sure your Organization field is filled out correctly will help users who land on your content find their way to your Organization Page.

Intended audience

Choose the audience this content is intended for. This information will help measure how well these audiences are being served and won't be displayed on the public-facing site. This is currently only for internal use. Choose from:

  • Not Set (default)

  • Personal

  • Professional (For their jobs)

  • Both equally

  • Unclear

Overview

A good overview tells readers what the service is and what its linked pages let them do. Here are 2 ways to think about what makes a good overview:

First time guide, Eligibility information, and Contact information

These fields are for users who don’t have much background knowledge. The First time guide field allows you to link Guides, which you can use as introductions or instruction manuals for your service. In Eligibility information, link Service Details that explain who your service is meant for.

The First time guide and Eligibility information fields only appear if you are using the Default link group template.

You can tell users how to contact you in different ways. You can enter a Contact Information item in the Contact information field, or you can enter an Organization Page into the Offered by field. (You can also include both.) In deciding what’s right for your service, ask yourself what you want users to do. For example, if you want to encourage them to interact with your organization online, leave the Contact information field blank.

In some cases, it will be better to enter Contact information on How-tos, Service Details, and Location Details, and to leave that section of your Service Page blank.

You can add up to 2 links to the “Log In to…” menu found at the top of all Mass.gov pages so visitors can quickly log into an offsite application related to your content.

You can add these links from the log in links section of a Service page, found at the bottom of the Overview tab.

These links will display in the “Log In to…” menu on the Service page you add them to plus most of the Service’s child pages.

Once added, the links will display under the heading “Log in links for this page” to let visitors know these are the links associated with the page they’re viewing or the related Service.

Service page with log in links
Service page without log in links
Service page with log in links
Service page without log in links

Tasks and key info tab

You'll be presented with different choices here depending on whether you're using Default or Custom link groups. What follows refers to the Default link group template. See our Custom link group article for more on building or editing a page with that template.

Service Pages using the Default link group template offer 2 types of information: what you can do and what you need to know. When you work on this section, it can help to think about what the user will see:

The "What would you like to do?" section

This section’s title implies that its links will help users do something. There are 2 sets of links: Featured tasks and All tasks.

Links in the Featured tasks section appear higher up the page, and they also appear on Topic Pages. (They’re the blue boxes on the gray cards.)

You can not link the following content types in Featured tasks:

  • Org page

  • Topic page

  • Service page

  • Contact info

  • Fee

  • Legacy redirect

The All tasks section can only link to How-to pages and Forms, or pages that help users do something. If you add more than 6 pages here, the CMS will generate a “see all” listing like this one.

There was a time when you could link service detail pages in the All tasks list, but you can't anymore. So, if you edit an older page where the All tasks section links to a content type other than a How-to page, your draft will not save until you move the content to the appropriate section.

The "What you need to know" section

This section’s title tells users that this is where they can find information.

The pages here should be:

  • Service Details

  • Information Details

  • Curated Lists

  • Guides

  • Binders

  • Decision Tree

  • News

  • Forms.

Service Details, Information Details, Curated Lists, Guides, Binders, or Forms. If you add more than 6 pages here, the CMS will generate a “see all” listing like this one.

Important: Don’t link other Service Pages in either section, as this creates a confusing user experience. If you want to link this service to other services, you can add those in Related Services.

Map and Additional info tabs

Map

You can use the map tab to add relevant locations to your service. To do this, first create a Location content type, and then add it here. If you do not add any locations, the map won’t display when you publish. If you do add locations, Mass.gov will generate a listing page like this one for your Service Page. Users will get to this listing page by clicking on the Location Details link:

Location details button label

Change the text that leads to your location listing from the generic “Location Details” to something more specific.

Location button short description

Provide a summary or context for the locations. This will appear over the listing button:

Additional info

Event Quantity

Use the drop-down menu to choose how many Events will appear under the "Upcoming Events" section on your Service page. Choose from 2, 4, 6, or 8 Events to be listed at a time. If you do not choose a number of events, by default there will be 2 events listed on your page. If your organization does not have any events, no events will be listed. The event preview cards will be stacked in pairs if you choose to display more than 2.

Use these fields to link to related Service or Topic pages visitors may find helpful to visit next. Up to 6 links will be shown on the page, while more than 6 will generate a listing page and a "See all" link.

Was this article helpful?

Tell us what you think button