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:
DHCD’s Emergency Housing Assistance Program, which helps users find emergency shelter and learn about housing funding programs.
RMV’s Motorcycle Licenses, where users can apply for a license, permit, or schedule a road test.
DUA’s Unemployment Insurance (UI) Online, which includes information, help, and links stakeholders to the UI application.
To save a draft of a Service Page, you will need to add something to these fields/sections:
Banner image (for desktop displays)
The title and short description are the first thing your audience sees. In fact, they might see them before they get to the page: If they’re coming from Google, the title is what will draw them in. Service Page titles and short descriptions also appear on Mass.gov’s Topic Pages. Try to write them using the words you think your audience would enter into a search engine to find them.
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 (the small green rectangle(s) in the upper left corner) on each Mass.gov page. Making sure yours is right will help users who land on your content find their way to your Organization Page.
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)
Professional (For their jobs)
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:
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.
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 3 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 Pages 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:
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.)
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.
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, 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.
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:
Change the text that leads to your location listing from the generic “Location Details” to something more specific.
Provide a summary or context for the locations. This will appear over the listing button:
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.