Public & visitor feedback
Service Details
Originally designed for simple informational pages, but is being replaced by the Information Details content type.
The Service Details content type will soon be retired, so please use the Information Details template instead.

Why use this content type?

Service Details are designed for short and basic informational content.
While many Service Details pages exist on Mass.gov, we strongly encourage you to use the Information Details template going forward for new informational pages. The Information Details content type boasts more features—including a table of contents-- than Service Details, and the Mass Digital team is focusing its development efforts on the Information Details content type.
If you have Service Detail pages, you may also convert them to Information Details to use these more flexible features.
While editing Service Details is encouraged to keep your content current and accurate, we discourage editors and authors from creating new Service Detail pages on Mass.gov

Overview

Title

The title is the first thing your audience sees. It’s important that these are easy to read and use plain language.

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.

Overview

Optional. You can use this field to introduce your content, or you can start with the “Add section” button under the Sections tab.
If you do use the Overview field, that content will not have a header. If you choose to begin by adding a section, your content will begin with the title of that section as a header.

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

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.
Labels field

Collections

Optional. Most content will not be in a Collection. Only add content to a collection if the collection creator has approved it. In that case, select any collections, topics, and subtopics for this content.
If you later need to remove a page from a Collection, go back into the page and uncheck the box and select Save.
Collection examples

Sections

In the Sections tab, you’ll see options for adding an iFrame, a section, or a video:
Sections tab

Adding iFrames

An iFrame is a page-inside-a-page. For example, MassWildlife uses an iFrame to show a report on where they’ve stocked trout, and where they’ll stock soon:
Example map iFrame
To add an iFrame to a Service Details, you’ll need a URL from the source you want to embed in the page. This URL must be from a source that Mass.gov supports and is compatible with, such as Google docs or YouTube. Here’s a list of domains that you can use (must be logged in to view).
If you have questions about iFrames, please submit a support request through ServiceNow.

Adding Sections

Sections are mainly for written and image content. Each section on a Service Details page includes a title, an optional content area, and additional resources, which can include links and downloads.

Adding Videos

You can add videos that are hosted on YouTube or Vimeo.

Related

Under the related tab, you'll see options for adding contact information and links.
Related links section

Contact

In the contact field, you can add a Contact Information or Person item that people can contact for more information about your service. Enter the name of the Contact or Person item and it will automatically populate in the field's dropdown menu.
In the related links fields, you may link up to 5 pages that visitors to your content might also be looking for.

Was this article helpful?