Public & visitor feedback
Service page
A hub for the information and transactions that make up a program or service.

Why use this content type?

The Service page is a hub for the details and transactions that make up a program, service, or process. You can choose between a default template that features buttons linking to child pages or the custom link group template that allows for more customization and categorization.
Examples of services include:
Default Service page template
Service page using custom link group template

Banner

Service name

This is your page’s title. It’s the first thing your audience will see, so make it clear and unique.

Short title

Optional. This field is used to shorten the full title of a page when displayed in a breadcrumb. First aim to shorten the actual page title if it’s long, but not so much that the title is no longer clear if someone comes directly to a page from a search engine.
Short title

Short description

Required. A high-level description of what’s on the page. Should expand upon the title, not repeat it.

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
Optional. If you include a banner image, it will appear behind a transparent blue background at the top of the page in a desktop view. It will not appear on mobile devices with small screens.
If you choose to use an image, you can adjust the focal point to make sure the right part of the image remains in view on small screens (e.g. mobile phones). Once you’ve added an image, use the little white crosshair in the Banner image preview to pick the focus.
Minimum image size: 1600 x 400 pixels (256 MB limit). Allowed types: png, gif, jpg, jpeg.

Service page header with banner image in desktop view

Service page header with banner image

Service page header without banner image in desktop view

Service page header without banner image

Parent page

The required Parent page field appears on all public-facing content types and it powers the breadcrumb-based navigation system.
The Mass.gov team prepopulated the field based on an analysis of which child pages belong to which parent pages. Each child page can be assigned only 1 parent, or higher level page.
These connections, displayed in the form of breadcrumbs (i.e., links) above the page title, will help Mass.gov visitors find their way to relevant information regardless of where they start on the site.
Parent page field
Required. Image displays through a transparent blue background at the top of the page.
Optional. Mobile-optimized image for the top of the page.

Image credit(s)

Appears at the bottom of the page.

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. ‌ 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

This field isn’t being used yet, so there’s no need to fill it in.

Labels

This is optional, however it is very helpful. Add one or more labels to be used to used for grouping and finding related content and documents within the CMS.
Start typing in the Label(s) field to choose an existing label from a dropdown menu that will appear or add a new label by entering it directly.
Label(s) field

Overview

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:
Add a Youtube or Vimeo video near the top of your page.
Add URLs for organization social media accounts. Icons will appear alongside links.
Social media links and icons

First time guide

Optional on default link group Service pages. The First time guide field allows you to link Guides, which you can use as introductions or instruction manuals for your service.

Eligibility information

Optional on default link group Service pages. Add a link to a page that includes eligibility information, if relevant. A box will appear after the Overview section.
First time guide and Eligibility information

Contact information

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.
You may want to direct them back to your Organization page, or may prefer only to include Contact information on the more specific How-to, Information Details, and other pages linked from your Service page.

Offered by

Add a link to your Organization page(s) that will appear alongside your Overview text. This organization information would repeat what’s in the separate “Offered by” link that appears above the page title.
You can add up to 2 links to off-site applications that will appear as white icon buttons at the bottom of the blue Service page banner under the service name (aka, page title) and short description. The text in the buttons is customizable.
Application log-in links at bottom of Service page banner
These links will also display behind the "Log In to..." link in the blue banner at the top of Service pages as well as most of their child pages. Once you click on "Log In to..." you'll see the links displayed under the heading “Log in links for this page."
Underneath those links specific to the Service page are 3 top requested log-in links visible on all Mass.gov pages.
Log In to link at top of Service page
Application log-in links in blue banner at top of page

Tasks and key info

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:

"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.
You can not link the following content types in Featured tasks:
  • Org page
  • Topic page
The All tasks section is designed to link to How-to pages and Forms, or pages that help users do something. If you add links to more than 6 pages here, the CMS will generate a "See all" link below the boxes that will lead to a listing like this. We recommend starting your link text with an action verb to answer the question “What would you like to do?”
What would you like to do?
There was a time when you could link Service Details 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 such content, your draft will not save until you move the content to the appropriate section.

"What you need to know" section

This section’s title tells users that this is where they can find information.
The pages linked to in this section should be:
  • Information Details
  • Curated Lists
  • Guides
  • Binders
  • Decision Tree
  • News
  • Forms
What you need to know
If you add links to more than 6 pages here, the CMS will generate a "See all" link below the boxes that will lead to a listing like this.
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

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 selecting the button on the locations map.

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 above the listing button:
Location example

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, by default there will be 2 events listed. If your organization does not have any events, none will be listed. The event preview cards will be stacked in pairs if you choose to display more than 2.
Upcoming Events example
Optional. 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.

Additional resources

Optional. Add links to Mass.gov or external pages.

Downloads

Add documents of other files.

Use Reports to review & analyze Service pages

Access the Services with Custom Link Grouping and Services with Standard Link Grouping reports under the "Reports" tab under the "Content" menu (you must be logged in to the CMS to access "Reports").
The reports will give you an overview of the types of links on each Service page.

Was this article helpful?