Meeting agenda

The features described on this page apply to all meeting types, i.e. one-time meetings and individual occurrences of recurring meetings.

Topic Content
Add an agenda section How to group agenda items into sections.
Add an agenda item How to add agenda items.
Link a work package to a meeting How to add work packages to the agenda.
Convert agenda items to work packages How to turn an agenda item into a work package.
Edit a meeting agenda How to edit, move and re-order agenda items.
Sort agenda items and vote How to choose a sorting mode and vote on agenda items.
Agenda backlogs How to use an agenda backlog.
Meeting attachments How to add attachments to a meeting.

You can edit a meeting agenda by adding sections, agenda items or existing work packages by selecting the desired option under the green + Add button. You can then add notes to each agenda item.

The add button in OpenProject meetings module with three choices: section, agenda item or work package

Add an agenda section

Sections allow you to group agenda items into blocks for better organization.

To add a section, click on the + Add button at the bottom of the agenda items and select the Section option.

Add a new section to a meeting agenda in OpenProject

If, prior to creating your first section, your meeting already had existing agenda items, they will automatically be contained in a section called Untitled section. You can rename this section if you wish.

Note

If you use sections, all agenda items must have sections.

Untitled section in OpenProject meeting

After adding a section, you can specify it further by adding agenda items or work packages to it.

In manual sorting mode, you can also add agenda items to specific sections by dragging and dropping items into each section. In either sorting mode, you can move items between sections by clicking on the More button (⋯) and choosing your desired action.

Edit or delete a section in an OpenProject meeting

The section’s More (⋯) menu on the right side also lets you rename a section, move it, copy a link to it or delete the entire section. If a section is moved, the agenda items will move along with it.

Select Copy link to clipboard to share a direct link to a section. Opening the link highlights the entire section in the meeting.

Tip

You can also re-arrange sections by dragging and dropping sections up and down.

Important

Deleting a section will delete all containing agenda items. If a section contains agenda items, you will be asked for confirmation before deletion.

Add an agenda item

If you select the Agenda item option, you can name that item, add notes, set the anticipated duration in minutes and select a user to be displayed next to the agenda item. This could for example be a meeting or a project member that is accountable for the item or someone who will present that particular topic. To show long notes as multiple slides in presentation mode, separate them with horizontal lines (see Split an agenda item into multiple slides).

Add an agenda item to a meeting section

By default, when creating an agenda item, this will be pre-filled with the name of the user adding the agenda item, but it can either be removed or replaced by one of the other meeting participants.

Form for adding agenda items to meetings sections in OpenProject

Sections will show the sum of all the durations of all containing items (or at least, those that have a duration specified).

Duration of a section in OpenProject meeting

Tip

If you need to store the agenda outside of OpenProject, you can generate an optimized PDF using the print function (Ctrl/Cmd + P).

To link a work package to a meeting, click the + Add button and select the Work package option. Enter a work package ID, type, status or a keyword, this will open a list of work packages for you to choose from.

Add work package

The meeting will appear under the Meetings tab of the linked work package.

You can also include work packages into the description section of other agenda items, by using # mention, same as in the CKEditor. In this case the meeting will not be linked to the work package and will not be displayed under the Meetings tab of mentioned work packages.

Add a work package from the work package view

There are two ways to add a work package to a meeting agenda.

You can add a work package to both upcoming or past meetings as long as the work package is marked open.

Button to add a work package to a meeting under Meetings tab in a work package in OpenProject

Tip

The upcoming meetings are displayed in chronological order, from the nearest meeting to the most distant. The past meetings are displayed in reverse chronological order, from the most recent meeting to the oldest.

The Activity tab records every action taken around a work package. This includes when a work package is added to a meeting agenda, removed from the agenda or moved to another meeting occurrence. The action taken is displayed next to the meeting title and date.

Activity tab showing updates when a work package is added or removed from a meeting

Note

Meeting related work package updates appear in the Activity tab only for users who have access to both the work package and the meeting.

To hide all meeting related work package updates, scroll to the top of the Activity tab and select the appropriate option from the drop-down menu.

Hide meetings updates from drop-down menu of the Activity tab

Convert agenda items to work packages

You can convert an agenda item into a work package to turn a discussion topic into an actionable task within your project.

To do so, open the More menu (three dots) of an agenda item and select Convert to work package.

Menu option to convert an agenda item into a work package

A Convert to work package dialog will open. The agenda item title is used as the work package subject, and the agenda item notes are added as the work package description. You can review and adjust these values before creating the work package.

Form to convert an agenda item into a work package

Click Create to create the work package in the same project as the meeting.

After creation, the agenda item is converted into a work package agenda item and becomes the newly created work package within the meeting agenda. The original agenda item notes are preserved in the work package description.

Converted work package agenda item

Edit a meeting agenda

After you have finalized the agenda, you can still edit agenda items, add notes or delete items. Clicking on the More (three dots) menu icon on the right edge of each agenda item will display a menu of available options, including editing, copying a link to the clipboard, moving the agenda item to another section or to the backlog, or deleting it. In manual sorting mode, you can also add a new item directly above or below it, or move the item up or down.

Edit, copy, move or delete an agenda item in OpenProject meetings module

In manual sorting mode, you may also re-order agenda items by clicking on the drag handle (the icon with six dots) on the left edge of each agenda item and dragging that item above or below. To prioritize items through voting instead, use vote-based sorting.

Drag handle next to an agenda item in OpenProject meetings

The durations of each agenda item are automatically summed up. If that sum exceeds the planned duration entered in Meeting Details, the duration of those agenda times that exceed the planned duration will appear in red to warn you of the fact.

Meeting agenda items duration sum is greater than the meeting duration set in OpenProject

Sort agenda items and vote

Choose Manual sorting to arrange the agenda yourself, or Vote-based sorting to prioritize topics by participant preference. The current sorting mode is shown in the Agenda sorting section of the sidebar. In vote-based mode, the meeting subheader also shows Agenda sorted by votes.

Change the sorting mode

  1. Click Change sorting mode in the Agenda sorting section of the sidebar, or open the meeting’s More (three dots) menu and select Sorting mode.

    Change sorting mode of agenda items in OpenProject

  2. In the dialog that opens, select Manual or Vote-based.

  3. Click Apply to save your selection.

Dialog form to select a sorting mode for meeting agenda items in OpenProject

Note

Changing the sorting mode requires the Edit meetings permission in the project and is only available while the meeting is editable. Users with View meetings permission can see the current mode, even if they cannot change it.

With vote-based sorting:

  • Agenda items are ordered from the highest to the lowest vote count within each section. The count is the number of upvotes minus downvotes: for example, 15 upvotes and 2 downvotes result in Votes: 13.
  • Items with equal counts retain their manual order.
  • Sections remain manually sorted. Votes do not move items between sections.
  • Drag-and-drop, the actions to move agenda items up or down, and the options to add an item above or below are disabled. You can still move an item to another section through its More menu.
  • Backlogs remain manually sorted and do not support voting.

Note

Switching back to Manual restores the manual item order and hides the vote counts and voting controls. Existing votes are retained and used again if you switch back to Vote-based.

Vote on agenda items

In a vote-based meeting, hover over an agenda item or move keyboard focus into it to reveal its Votes count and small thumbs up (👍) and thumbs down (👎) buttons. On mobile, the vote count remains visible, but the inline buttons are hidden. Use the item’s More (three dots) menu to vote instead.

Click 👍 to upvote or 👎 to downvote. Alternatively, open the item’s More (three dots) menu and select Upvote or Downvote.

Each user can have one vote per item. Clicking your selected vote again removes it; selecting the opposite vote replaces your previous vote. The count and agenda order update after voting. Counts can be positive, zero or negative, for example Votes: 13 or Votes: -2.

Vote-based mode for sorting meeting agenda items in OpenProject

Note

Voting requires the View meetings permission in the project; you do not need permission to edit the agenda or be listed as a meeting participant. Voting is available in draft, open and in-progress meetings, but not in closed or cancelled meetings, meeting templates, backlogs or presentation mode.

Votes stay with an item when it is moved between sections of the same meeting. Moving an item to another meeting resets its votes.

Agenda backlogs

An agenda backlog is a special pre-existing section below the actual meeting agenda where additional agenda items can be listed before being added to that particular meeting. This allows users to propose topics that are then picked up by the meeting organizer either before or during the actual meeting.

Backlog items remain manually sorted, even when the meeting uses vote-based sorting. Move an item into the agenda before voting on it.

The backlog can be expanded or collapsed by clicking on the title.

Tip

By default, the backlog is expanded when the meeting status is open, collapsed if the meeting status is in progress, and hidden if the meeting is closed.

Agenda backlog section title collapsed, in OpenProject one-time meeting

Add and edit items to agenda backlogs

You can add agenda items and link work packages in the same way as you would within the meeting agenda, by dragging and dropping agenda items elsewhere in the meeting or by using the dropdown options of the More (three dots) icon on the right.

Agenda backlog in a single meeting in OpenProject

That same More menu also allows editing, reordering, adding notes or deleting an item in the agenda backlog.

Move agenda items from the agenda backlog to the agenda in OpenProject Meetings

Clear agenda backlogs

You can either remove single items from an agenda backlog or clear an entire backlog by clicking the Clear backlog option under More (three dots) menu next to the backlog name. Use this option with caution, as the action cannot be undone.

An option to clear an agenda backlog in OpenProject meetings

Meeting attachments

You can add attachments in the meetings in the Attachments section in the bottom right corner. You can either use the +Attach files link to select files from your computer or drag and drop them.

Added attachments can be added to the Notes section of agenda items by dragging and dropping them from the Attachments section.

Attachments in OpenProject meetings