information
Stay home. Save lives. Portland enters phase 1 of reopening.

Portland.gov Content Model

A content model documents content types and defines the relationships between those content types. Within a content model, we can define the purpose of each piece of content within our website.

On this page

In the new Portland.gov content management platform, editors are no longer required to build complex menus. Instead, editors can focus their valuable time and energy on creating content that is community-focused and optimized for search, discovery, and accessibility. An editor only needs to select the appropriate content type and fill-out the available fields in the form in order to create new content. The system then builds a menu relating like-content together. 

Roles and permissions

Portland.gov has two levels of roles and permissions: sitewide and group specific. Group specific roles are detailed below. Sitewide roles include a special role for group creators (people that may create planning projects and advisory groups) as well as a role to designate group admin or editor as a publisher. We automatically add the publisher role to group admins. Group admins can add editors that will not be able to publish content by default. If a user needs the publisher role, they will be allowed to publish for all groups to which they belong.

What is a content model?

A content model documents content types (e.g. news article) and defines the relationships between those content types. Within a content model, we can define the purpose of each piece of content within our website. 

Groups

Groups allow us to put like-content together. Currently, groups are created by the POWR admin team on request. To request a group, send an email to powr@portlandoregon.gov.

Example grouphttps://beta.portland.gov/powr

Group membership

All group members have three possible roles within the group:

Reviewer

A reviewer can see content, media, and member lists and is able to view unpublished content in a group. A reviewer cannot add or edit content.

Editor

An editor can manage content within your group by adding and editing content. An editor can delete content they create, but cannot delete content created by another user.

Admin

An admin can create and edit content and may delete any content within their group. Additionally, admins can add members to their groups and may also add or remove roles from those members. Admins are automatically assigned the publisher role by the core team when they are set up with a new group.

Advisory group

Advisory groups are project-like websites specifically for boards, commissions, and committees.

An advisory group differs from a project, program, or bureau/office group in that the primary purpose is to document discussion, testimony, decision-making, and outcomes of a board, commission, or committee.

Available fields:

  • Title
  • Official organization name
  • Summary
  • Featured content
  • Featured groups
  • Topics
  • Parent group(s)
  • Featured media (banner image)
  • Contact information
  • Location
  • Group menu
    • Enable a Group Menu
    • Services and information
    • News
    • Blog
    • Press Releases
    • Public Notices
    • Events
    • Past Meetings and Hearings
    • Documents
  • Paths and redirects
  • Administrative fields (site admins only)
    • Group path
    • Shortname or acronym (deprecated field)
    • Menu settings
    • Search keywords

Bureau/office

Governmental organizations. These organizations may wish to share news and events with the public sporadically but are mostly focused on highlighting their programs and services.

Available fields:

  • Title
  • Official organization name
  • Summary
  • Featured content
  • Featured groups
  • Topics
  • Summary
  • Parent Group(s)
  • Logo
  • Featured media (banner image)
  • Contact Information
  • Social Media
  • Location
  • Group menu
    • Enable a Group Menu
    • Services and information
    • News
    • Blog
    • Press Releases
    • Public Notices
    • Events
    • Past Meetings and Hearings
    • Documents
    • Offices and programs
    • Programs
    • Projects
    • Advisory Groups
  • Paths and redirects
  • Administrative fields (site admins only)
    • Group path
    • Shortname or acronym (deprecated field)
    • Menu settings
    • Search keywords

Example bureau/office group: https://beta.portland.gov/bps

Elected official

The officials elected by the public including the mayor, the commissioners, and the auditor.

An elected official group differs from a project, program, bureau/office, or advisory group in that the primary purpose is to provide a space for an elected official’s priorities, portfolio, and public outreach.

Available fields:

  • Title
  • Official title
  • Summary
  • Featured content
  • Featured groups
  • Topics
  • Summary
  • Parent Group(s)
  • Logo
  • Featured media (banner image)
  • Contact Information
  • Social Media
  • Location
  • Group menu
    • Enable a Group Menu
    • Services and information
    • News
    • Blog
    • Press Releases
    • Public Notices
    • Events
    • Past Meetings and Hearings
    • Programs
    • Projects
  • Paths and redirects
  • Administrative fields (site admins only)
    • Group path
    • Shortname or acronym (deprecated field)
    • Menu settings
    • Search keywords
    • Active elected official (checkbox)
    • Voting council member (checkbox)
    • Bureaus

Example elected official group: https://beta.portland.gov/wheeler

Program

Programs are ongoing and generally funded work produced by one or more bureaus.

A program differs from a project in that it is an ongoing, long-term, and established resource for the community.

Available fields:

  • Title
  • Official organization name
  • Summary
  • Featured content
  • Featured groups
  • Topics
  • Summary
  • Parent Group(s)
  • Logo
  • Featured media (banner image)
  • Contact Information
  • Social Media
  • Location
  • Group menu
    • Enable a Group Menu
    • Services and information
    • News
    • Blog
    • Press Releases
    • Public Notices
    • Events
    • Past Meetings and Hearings
    • Documents
    • Offices and programs
    • Programs
    • Projects
    • Advisory Groups
  • Paths and redirects
  • Administrative fields (site admins only)
    • Group path
    • Shortname or acronym (deprecated field)
    • Menu settings
    • Search keywords

Example program group: https://beta.portland.gov/garbage-recycling

Project

A project is a time-limited, funded body of work. The work may require frequent reporting, community outreach, and feedback.

A project can be similar in structure to a program but differs in that the work is typically done in a period of time (a few months to a few years). An active project may also produce frequent updates whereas a program may not produce many updates at all.  

Available fields:

  • Title
  • Project type
    • Types include planning, construction, and technology (construction should be used for master projects that group construction projects—which are a separate content type)
  • Project status
  • Project Dates
    • Start date
    • End date
    • Use a display date (checkbox)
    • Display date
  • Summary
  • Featured content
  • Featured groups
  • Neighborhood
  • Topics
  • Summary
  • Parent Group(s)
  • Logo
  • Featured media (banner image)
  • Contact Information
  • Social Media
  • Map
  • Location
  • Group menu
    • Enable a Group Menu
    • Services and information
    • News
    • Blog
    • Press Releases
    • Public Notices
    • Events
    • Past Meetings and Hearings
    • Documents
    • Projects
    • Advisory Groups
  • Paths and redirects
  • Administrative fields (site admins only)
    • Group path
    • Shortname or acronym (deprecated field)
    • Menu settings
    • Search keywords

Example strategic project: https://beta.portland.gov/powr

Content types belonging to groups

Service

The community must complete one or more steps with a city service usually ending in the action of filling out a form (online or in-person), sending an email, calling a phone number, or visiting a location. A city service does not have news or events associated with it though it can belong to a program that does. 

Available fields:

  • Title
  • Summary
  • Time to complete
  • Community actions - the action a community member will take to access the service: apply, pay, find, import.
  • Topics
  • How can community members access this service?
    • Contains modes of access and step by step instructions builder
  • Location
  • Contacts
  • Parent group(s)
  • Paths and redirects
  • Administrative fields (site admins only)
    • Popular (checkbox)
    • Search keywords
  • Related content
  • Reviewer
  • Moderation state
  • Revision log message

Page

Pages are a form of static content that does not change often. There are several page types to choose from with a default type of information. Pages must be assigned a type to help give them more meaning: guide, information, rates, fees, resource, etc.

For example, guides help people understand how to interact with a process or service. They should be used when the steps in a service are too complex to fit in a 7-step or less process. Guides can also be used to share more general content meant to educate or teach.

Available fields:

  • Title
  • Page type
    • Includes the following types: information (default), handbook, guide, resource, rates, fees.
  • Summary
  • Body content
  • Topics
  • Featured media (banner image)
  • Location
  • Contacts
  • Parent group(s)
  • Paths and redirects
  • Administrative fields (site admins only)
    • Include in page menu
      • Menu title
      • Parent page
    • Popular (checkbox)
    • Search keywords
  • Related content
  • Reviewer
  • Moderation state
  • Revision log message

News

News is chronological content meant to inform the community about programs and communicate the priorities of the bureaus and elected officials. There are several types of news.

  • News article: default type used for communicating with the community
  • Public notice: formal information posted on a specific date usually related to a public hearing and testimony process
  • Press release: formal communication with the press, the intent is that this information will be published by news outlets
  • Blog post: informal communications with the community; there are no comments on our blog posts

News is listed by these sub-types. You can feature news to have it appear on one or more group homepages.

Available fields:

  • Title
  • News type
  • Summary
  • Body content
  • Topics
  • Neighborhood
  • Posted on (date and time)
  • Feature
    • Feature this content
      • Feature until (date and time)
    • Featured media (banner image)
  • Location
  • Contacts
  • Parent group(s)
  • Paths and redirects
  • Administrative fields (site admins only)
    • Search keywords
  • Related content
  • Reviewer
  • Moderation state
  • Revision log message

Event

An event is held at a specific date and time—unless it is an all-day event. An event may optionally have a location and may need to convey information about how to engage in the event. Events help programs, officials, and bureaus to engage with the community.

There are several types of events:

  • Community Event: public event for the community to attend
  • Meeting: meeting that is not open to the public but is published and may include meeting materials for the public after the meeting is concluded
  • Public Meeting: meeting that is open to the public and may include meeting materials for the public after the meeting is concluded
  • Hearing: a meeting that takes testimony, but is not open to the public
  • Public Hearing: a meeting that takes testimony and is open to the public

Available fields:

  • Title
  • Event type
  • Event status (events can be "cancelled" or "rescheduled")
  • Summary
  • Start date
  • All day (event is marked as all day)
  • Start time
  • End time
  • Event is multiple days
    • End date
  • Body content
  • Neighborhood
  • Topics
  • Featured media (banner image)
  • Location
  • Contacts
  • Parent group(s)
  • Paths and redirects
  • Administrative fields (site admins only)
    • Search keywords
  • Related content
  • Reviewer
  • Moderation state
  • Revision log message

Notification

Notification help inform the community of important information that a bureau or office wants to highlight for a limited period of time.

Construction

A construction project is a one-page description of a construction project performed by a city bureau.

Available fields:

  • Title
  • Project Type
    • Water, Sewer, Transportation (more types may be added to help search)
  • Project status
    • Planned
    • In planning
    • Engineering and design
    • Active
    • Under construction
    • Closeout
    • Completed
  • Summary
  • Body content
  • City section
  • Neighborhood
  • Topics
  • Featured media (banner image)
  • Location
  • Map
  • Project Dates
    • Start date
    • End date
    • Use a display date (checkbox)
      • Display date
  • Contacts
  • Parent group(s)
  • Paths and redirects
  • Administrative fields (site admins only)
    • Search keywords
  • Related content
  • Reviewer
  • Moderation state
  • Revision log message

Location

A location is the physical address and get directions link added to a service location, news, events, construction projects, strategic projects, and more.

Room

A room or meeting place has an associated location (address, building, or place). Meetings and hearings are often associated with a specific room in a city facility. The new room content type will allow editors to associate their events with reusable rooms.

Service location

A service location is a place where people interact with a city service. This place can be found on a map and needs directions to make it easy for the community to visit the service location. Locations that are not open to the public do not need to be published on the public site. A location can be referenced to a service, bureau/office, elected official, program, event, or public hearing.

Site-wide content types

Site wide content types can only be edited by site-wide administrator roles.

Alert

Emergency alerts help inform the community in the event of an emergency, such as inclement weather or water boil notices, and should appear prominently in a banner across the top of all sites until such time as the alerts are unpublished via manual or scheduled interaction. A community member may dismiss an alert.

City Charter

Broken into multiple types: Charter Chapter, Charter Article, Charter Section. Custom search API views need to be created for searching this content.

City Code

Broken into multiple types: Code Title, Code Chapter, Code Section. Custom search API views need to be created for searching this content.

Portland Policy Documents

Sorted by categorization, these are the official policies managed by the auditor.

Council Agendas

Highly structured content type to allow for the association of council documents with the official public meetings held by city council.

Council Documents

Ordinances, resolutions, proclamations, etc. that are presented during a city council meeting and are voted on by elected officials.

Media Types (typically belong to a group)

Document

We currently have far too many documents on our website. These PDFs, Excel, Word, and PowerPoint documents are frequently inaccessible and out of date. The document media type will belong to a group and there will be tools to help identify out of date documents that can be archived and removed from the website to improve search optimization.

Image

Images uploaded to the platform will be automatically resized to web appropriate dimensions. Alternative text that describes the image will be required to help meet accessibility guidelines.

Video

YouTube and Vimeo can be embedded into many other content types. Additionally, video will have instructions to help editors make their videos more accessible by providing closed captioning and transcripts.

Audio

YouTube makes an excellent delivery tool for audio content because it can include closed captioning. An appropriate placeholder image should be used for audio.

Map

Embeddable maps that contain GIS information can be an informative way to present information. Maps will need to be an integration with our ArcGIS platform and teams, but will also include options for simple Google Maps and even PDF (printable) maps.

Chart

Charts allow the editor to embed visual aids such as those created in ArcGIS or as an image. Coming soon, we will add the ability to embed Tableau and other dynamic charts. These chart types should be used sparingly as they represent an accessibility and usability challenge if not implemented correctly.

Taxonomy

Action

Community actions describe the way in which a person would typically interact with the services provided by the city.

  • Apply
  • File
  • Pay
  • Report

Topics

Topics are the words that the community might use to describe areas that the city provides services. Topics should be more intuitive than bureau names, though they may directly represent a bureau in some cases.

  • Access and ADA accommodations
  • Biking
  • City projects
  • Community education and outreach
  • Construction and development
  • Economic development
  • Environment
  • Fire and life safety
  • Garbage and recycling
  • Housing
  • Parking
  • Parks, recreation, and activities
  • Police and safety
  • Public records
  • Sidewalks and trees
  • Transportation and roads
  • Water, stormwater, and sewer

Parks

Park location

A park location is associated with an address (for entrance or parking lot) and may also have geographic information to describe the space it occupies. Three taxonomies help define a park: park facility type, park amenity, reservations available.

Park facility type

  • Park
  • Arboretum
  • Community and arts center
  • Community garden
  • Community school
  • Golf course
  • Memorial
  • Museum
  • Natural area
  • Sports complex
  • Swim pool (indoor)
  • Swim pool (outdoor)
  • Public garden
  • Raceway
  • Rose garden

Park amenity

  • Accessible picnic area
  • Accessible play area
  • Accessible restroom
  • Accessible outdoor tennis court
  • Baseball field
  • Basketball court
  • Basketball court (indoor)
  • Earthquake communication node
    (BEECN – Basic Earthquake Emergency Communication Node)
  • Boat dock
  • Boat ramp
  • Bocce court
  • Computer lab
  • Disc golf
  • Dog off-leash area
  • Dog off-leash area fenced
  • Fitness room
  • Fountain
  • Fountain (interactive)
  • Futsal field
  • Gift shop
  • Golf course
  • Gymnasium
  • Historical site
  • Horseshoe pit
  • Nature-based play area
  • No dogs allowed
  • Paths (paved)
  • Paths (unpaved)
  • Pay to park
  • Picnic shelter
  • Picnic table
  • Playground
  • Plaza
  • Preschool program
  • Pump track
  • Riverfront views
  • Rock climbing wall
  • Roller skating
  • Skate park
  • Soccer field
  • Softball field
  • Splash pad
  • Stage (indoor)
  • State (outdoor)
  • Statue or public art
  • Synthetic turf
  • Tennis backboard
  • Tennis court (indoor)
  • Tennis court (outdoor)
  • Tennis court (lighted)
  • Tours (guided)
  • Track
  • Trails (biking)
  • Trails (equestrian)
  • Trails (hiking)
  • Universal access play area
  • Urban waterscape
  • Visitor attraction
  • Vista point
  • Volleyball court
  • Weight room
  • Wireless internet access (WiFi)

Reservations available:

  • Kitchen
  • Meeting room
  • Party room
  • Picnic shelter
  • Wedding site

Content types to be finalized

Traffic advisory

Traffic advisories have a date, time, location information and expected resolution information to aid in publishing timely alerts to the public.

Webforms

Our plan is to avoid storing community-submitted data in our content management system on Portland.gov. We are exploring SeamlessDocs and a separate Drupal installation at forms.portland.gov as possible options for TrackIT replacement. In the interim, we are testing the creation of some webforms within Portland.gov that submit to other systems such as our customer service management platform, Zendesk.

Job or internship posting

Our default platform for job postings is NeoGov. This system allows integration with an application process facilitated by the Bureau of Human Resources. We would like to integrate these postings more fully with Portland.gov to make the job postings easier to find. Additionally, some internships are not posted to NeoGov and need a place to be housed on Portland.gov.