Research, Discovery & Innovation

Design, Style & Content Guide

This part of the site is just for editors working on the website. This is where you can find all of the resources and information you’ll need to make updates to the site, as well as answer any questions you have about formatting, structure, site hierarchy and information architecture, plus how to properly Categorize and Tag your content so that the site functions as intended.

Table of Contents

Workflow for Images for Events

Flatscreens and Featured Images

Flatscreens should be created for event promotion. The dimensions for the flatscreen image are 16:9 proportions and as such are the ideal size for featured images for the website, so when the flatscreen is created, it should be created with the thought that it will also be used on the website in such a capacity.

Essentials for Adding New Content


Excerpts are required. Excerpts can be found on the right side of the WordPress screen. Your excerpt can be somewhat long (think a paragraph or so), because it will appear as a description anywhere applicable. So, for the Office for Research Careers homepage, for instance, it would be appropriate to have a high level overview of the ORC. All pages and posts must have excerpts. The excerpt may not always display, depending on the specific page, but will appear in general searches and so must be a description of the page.

The only exception for this is a ‘People’ post, where you’d consult below to identify the appropriate formatting for titles, degrees, etc.

Adding News

Clinical and Research News

When adding a news article from Clinical and Research News, you must tag the post as ‘Clinical and Research News’, once you do that, a field should appear below the content box where you can put the source link for the original article. This way we can both use the content and always make sure to cite the original source of CRN for each post. 

Each of these posts MUST have a featured image. If there is not an appropriate image (600×400, 3:2 proportions), then refer to a past image in the repository that is general but relevant, if necessary.


Adding Content by Content Type

Content Type: People

When you are adding someone to the site (with the exceptions of interns and poster winners), you should first search to see if they already are on the site and you just need to add them to a category.

If they are not on the site, you need to have a headshot (high resolution), their degrees, titles and a short biography, if possible.

We have created a submission form for use, so you can send that form to speakers, etc. this way, all of the information will be accurate and up to date from the individuals.

Title: the title of the post should be the individual’s Full Name, Degrees. Do NOT use periods in degrees, formatting should be: MD, PhD, etc.

Every person needs to have an excerpt with the information you want visible on the site prominently.

In the excerpt space, you must put their titles (this is what will appear below their photo and name on a staff/leadership group page, so it is important to include.)


Adding Research Oversight Committee Members

When you are adding Research Oversight Committee Members, the proper formatting is as follows:

For Chiefs and Chairs:

Chair, Division of X, Department of X
Department Representative, Research Oversight Committee

Interim Chair, Division of X
Department Representative, Research Oversight Committee

For Alternate Representatives:

Department of X
Department Representative, Research Oversight Committee (Alternate)

For Prize Winners:

Award Recipient (Year)
Department Representative, Research Oversight Committee

For Mass General Brigham Representatives:

Title, Department, Mass General Brigham
Member, Research Oversight Committee

For Elected Representatives:

Postdoctoral Representative, Research Oversight Committee
Junior Faculty Representative
Senior Faculty Representative
Population Science Representative
Clinical Research Representative
Basic Science Representative

For Additional Members:

Title, Department
Member, Research Oversight Committee

Adding Events

Event Posts vs Event Listings

When you’re creating a new event on the website, you’ll be doing two things. First you’ll create the event post, where you’ll detail the speakers, any agenda items, share videos, other materials for attendees, anything they’ll need to participate in the event. This URL will also serve as the eventual archive for this event. 

You will also need to create an event listing, which will have a ‘event website’ field where you can link it to the Event Post. Why two separate things? The Event Listing on the Calendar is a temporary and BRIEF teaser for your event. The Event Post is where you have all the space you need to provide all the information.

We’ve also created a shortcut – if someone clicks on the title of the event in the Event Listing in the calendar they’ll automatically be taken to the Event Post. So most people will never even see the ‘Event Listing’ but we will still want it because it provides us with a calendar feed that can be subscribed to, as well as features like adding to Outlook.

Annual Events

For events that are hosted annually (or regularly), we are creating Event Pages to collect the series of Event Posts (the archive of your event). This way, you have a landing page, for say the Cambridge Science Festival and then it will feature Event Posts archiving each event throughout the past 10 years. The landing page will allow you to see the history behind some of the events as well as provide more contextual information should you wish, in the accompanying descriptive text at the top of the page. 

Featured Images for Events

As much as possible, Featured Images for Events should not be event graphics, but should feature people (at the previous year’s event, for example). The reason for this is that by showcasing researchers throughout the site, even in small ways like this, it creates a visual sense of community that reinforces the goal of the site – to bring researchers together.

Adding Laboratory Website Listings

Featured Images for Laboratory Listings

When creating a new Laboratory Website Listing, please take a screenshot of the website and use that for the featured image. (Keep the screenshot ‘pure’, meaning no visible browser components, menu bar, etc., just the site visible in the screenshot).

Taxonomy and Tags for Laboratory Listings

Tags are essential for maintaining a functioning Laboratory Listing Directory and will be referred to as “keywords” in the upload form, but must be added as tags to the post so that the laboratory will show up under its respective research areas, as appropriate.