Support Buy Now
Plugin guide

Agile Board Plugin

Explore our Agile Board Redmine Plugin Knowledge Base for expert insights, tutorials, and tips. Enhance your project management with this powerful tool.

34 sectionsAgile Board page →

Introduction

Redmineflux Agile Board is a modern Agile planning and execution plugin for Redmine that helps teams manage work visually across project boards, global boards, My Page, and backlog planning views. It supports Kanban and Scrum workflows, drag-and-drop issue movement, double-click card editing, board settings, grouping, WIP limits, sprint planning, saved custom boards, and optional Story Points.

This updated plugin is designed for high performance, clearer board layouts, and a more flexible user experience than earlier Agile Board versions.

Version Compatibility

Supported Redmine versions:

  • 5.0.x
  • 5.1.x
  • 6.0.x
  • 7.0.x

Installation

To install the Redmineflux Agile Board plugin:

  1. Make sure Redmine is already installed and working.
  2. Extract the plugin archive.
  3. Upload the folder to Redmine/plugins/agile_board.
  4. Do not rename the plugin folder.
  5. Install required gems:
    bundle install
  6. Run database migrations.
    For production:
    RAILS_ENV=production bundle exec rails redmine:plugins:migrate
    For development:
    RAILS_ENV=development bundle exec rails redmine:plugins:migrate
  7. Restart Redmine.

Note:

If you encounter any UI-related issues after installing the plugin, such as missing styles or JavaScript functionality (for example, CSS or JavaScript files not loading properly), run the following command and then restart your Redmine server:

RAILS_ENV=production bundle exec rake assets:precompile

This command regenerates the plugin assets and helps ensure that all CSS and JavaScript files are loaded correctly.

Configuration

To enable Agile Board for a project:

  1. Log in as Administrator.
  2. Open the target project.
  3. Go to Settings.
  4. Open the Modules tab.
  5. Enable Agile Board.
  6. Save the changes.

After enabling the module:

  • The project shows an Agile Board tab.
  • The project also shows a Backlog tab.
  • Logged-in users can access the Global Agile Board from the top navigation menu.

To configure plugin-level options:

  1. Go to Administration.
  2. Open Plugins.
  3. Find Redmineflux Agile Board.
  4. Click Configure.

From plugin configuration, administrators can manage:

  • Maximum WIP limit
  • Story Points feature toggle
  • Story Point values
  • Tracker icons
  • Priority icons
  • Completed issue visibility in Backlog
  • Column width for unassigned Backlog issues

Agile Board Overview

The new Agile Board plugin includes four main working areas:

  1. Project Agile Board Use this to manage issues inside a single project.
  2. Global Agile Board Use this to view and manage issues across all visible projects.
  3. My Page Agile Board Use this to see the current user’s assigned issues as a personal Kanban board on My Page.
  4. Backlog Use this to plan work by sprint, version, or unassigned backlog.

Main capabilities include:

  • Kanban and Scrum board modes
  • Drag-and-drop issue movement
  • Double-click card editing
  • Search and filtering
  • Grouping and swimlanes
  • WIP limits
  • Card field customization
  • Sprint planning
  • Version planning
  • Saved custom boards
  • Tracker and priority icon customization
  • Optional Story Points
  • My Page block for assigned work
  • Story Point editing directly on issue cards
  • Backlog Story Point totals showing closed and total points
  • Multi-language interface

How to View the Agile Board

To view the Agile Board for one project:

  1. Open the project.
  2. Click Agile Board from the project menu.

To view the Agile Board across projects:

  1. Log in to Redmine.
  2. Click Agile Board from the top navigation menu.

The Global Agile Board shows issues from all projects the current user is allowed to see.

To view the Agile Board on My Page:

  1. Log in to Redmine.
  2. Open My Page.
  3. Add the Agile Board block if it is not already visible.

The My Page Agile Board shows issues assigned to the current user across active projects the user can access.

How to Use the Global Agile Board

The Global Agile Board is useful when you want one board view across multiple projects.

You can use it to:

  • View issues across all visible projects
  • Search issues by subject
  • Filter by assigned members
  • Group issues by project, tracker, priority, author, assignee, category, target version, parent task, or other supported options
  • Drag issues between statuses when permissions allow
  • Double-click a card to edit issue subject and description
  • Show project context directly on issue cards

This is especially useful for team leads, PMs, and managers tracking work across multiple delivery streams.

How to Use the Agile Board on My Page

The My Page Agile Board gives each user a personal Kanban board for assigned work without leaving My Page.

The block shows:

  • Issues assigned to the current user
  • Active projects visible to the current user
  • Status columns based on the user’s My Page block settings
  • Issue cards using the same Agile Board card layout
  • Optional totals for estimated time, spent time, and Story Points
  • WIP indicators for configured status columns

To add or open the block:

  1. Open My Page.
  2. Use the My Page personalization controls.
  3. Add the Agile Board block.
  4. Save or apply the My Page layout.

Users can work from the My Page Agile Board by:

  • Dragging assigned issue cards between status columns
  • Double-clicking a card to edit subject and description
  • Loading more cards in large columns
  • Reordering columns when column reordering is enabled
  • Opening block settings to choose visible statuses, card fields, totals, and WIP limits

Important behavior:

  • Issue movement still follows normal Redmine permissions and workflow transitions.
  • Users can only move or edit issues that are available in their My Page issue scope.
  • Story Points only appear when Story Points are enabled in plugin configuration.
  • My Page block settings are stored per user, so each user can keep their own personal layout.

How to Include Closed Projects on the My Page Agile Board

By default, the My Page Agile Board shows issues from active projects only, so completed projects do not fill up a personal dashboard.

If you still need to see issues from closed projects, you can switch them on for your own block:

  1. Open My Page.
  2. Open the Agile Board block settings.
  3. Enable Include closed projects.
  4. Save the block settings.

Important behavior:

  • The option is stored per user, so it affects only your own My Page.
  • Issues from closed projects are shown as read-only, in line with standard Redmine behavior for closed projects.
  • Archived projects are never shown.

How to Add a New Issue from the Agile Board

To add a new issue from the project Agile Board:

  1. Open the project Agile Board.
  2. Locate the target column.
  3. Use the quick add issue option in that column.
  4. Enter the issue subject.
  5. Save or confirm the entry.

The new issue is created in the selected status column.

Note:

  • Issue creation depends on project permissions.
  • Some fields may use project defaults until the issue is edited in full detail.

How to Update an Issue from the Agile Board

Double-click any issue card to open an edit modal where you can update the issue subject and description directly from the board.

Changes are immediately reflected on the board after saving.

How to Change Issue Status with Drag and Drop

To move an issue to another status:

  1. Open the Project Agile Board, Global Agile Board, or My Page Agile Board.
  2. Locate the issue card.
  3. Click and drag the card to another status column.
  4. Drop the card into the target column.

The plugin updates the issue status automatically if:

  • The user has edit permission
  • The workflow allows the transition

If the workflow blocks that transition, the move will not be applied.

How to Customize Card Fields

Each board can display different issue details on the cards.

To customize card fields:

  1. Open the board.
  2. Click the Settings icon.
  3. Open the Card Fields section.
  4. Select the fields you want to display.
  5. Click Apply.

Common card fields include:

  • Issue ID
  • Subject
  • Tracker
  • Priority
  • Assignee
  • Author
  • Start date
  • Due date
  • Estimated time
  • Spent time
  • Done ratio
  • Parent task
  • Subtask count
  • Description
  • Last comment
  • Tags
  • Category
  • Target version
  • Comment count
  • Attachment count
  • Story Points, if enabled at plugin level

On My Page, these settings apply to the Agile Board block for the current user.

How to Configure Board Columns and WIP Limits

To configure visible columns and WIP limits:

  1. Open the board.
  2. Click the Settings icon.
  3. Open the Board Columns section.
  4. Enable or disable the statuses you want to display.
  5. Enter WIP values for the columns where needed.
  6. Click Apply.

WIP limits help teams control work in progress and make overloaded columns visible.

The board settings also include a Column Reordering option.

To enable column reordering on the Kanban board:

  1. Open the Project Agile Board, Global Agile Board, or My Page Agile Board.
  2. Click the Settings icon.
  3. Enable Column Reordering.
  4. Click Apply.

After it is enabled:

  • You can drag and reorder Kanban status columns directly on the board.
  • The updated column order is saved for that board configuration.
  • On My Page, the updated column order is saved in the current user’s My Page block settings.
  • A confirmation message is displayed when the new column order is saved.
  • The board scrolls automatically while a column is dragged to the edge of the screen, which makes it easier to move a column across a wide board.
  • If Column Reordering is disabled, columns stay in their configured order and cannot be dragged.

Notes:

  • WIP limits can be configured per status column.
  • The plugin-level maximum WIP value is set in plugin configuration.

How to Search and Filter Issues

The plugin includes a board search experience for fast issue discovery.

Typical filtering options include:

  • Search by issue subject
  • Filter by member
  • Query-based issue filters
  • Grouping-based board segmentation
  • Sprint filter on Scrum board
  • Backlog filters for planning views

To search:

  1. Open the board.
  2. Use the search field at the top.
  3. Enter a keyword from the issue subject.

To apply project query filters:

  1. Open the filter section.
  2. Choose your conditions.
  3. Click Apply.

How to Use Grouping and Swimlanes

Grouping organizes issues into swimlanes.

Supported grouping options include:

  • None
  • Project
  • Tracker
  • Priority
  • Author
  • Assignee
  • Category
  • Target version
  • Parent task
  • Additional supported group values available in the current board

To apply grouping:

  1. Open the board.
  2. Use the Group By option.
  3. Select the grouping value.
  4. Apply the change.

The board refreshes and displays grouped swimlanes.

How to Use the Backlog

The Backlog provides a planning view for sprint and version management.

It includes:

  • Sprint columns
  • Version columns
  • Issues not assigned to a sprint or version
  • Drag-and-drop assignment
  • Search and filters
  • Card field settings
  • Lazy loading for large datasets

To open the Backlog:

  1. Open a project.
  2. Click Backlog.

This view is ideal for sprint planning and release planning.

How to Track Sprint Progress with Story Point Totals

When Story Points are enabled, every Backlog column header shows how much of its work is already finished.

The value is displayed as closed points out of total points, for example:

8 / 21 SP

The first number is the Story Points already closed, and the second number is the total for that column. Hovering over the badge shows the same information in words.

Story Point totals are available on:

  • Sprint columns
  • Version columns
  • The No Sprint column
  • The No Version column

Important behavior:

  • Totals always include finished work, so closed Story Points are counted even when completed issues are hidden.
  • Totals are updated immediately when a card is moved to another column or its Story Points are changed, without reloading the page.
  • A column with no Story Points on any issue does not display a badge.
  • The badge is hidden when Story Points are disabled in plugin configuration.

This gives teams a clear view of sprint capacity and remaining work during planning.

How to Keep Completed Issues Visible in the Backlog

By default, the Backlog focuses on work that is still open.

Administrators can keep finished issues visible in their sprint so completed work stays in view during planning and review:

  1. Go to Administration.
  2. Open Plugins.
  3. Find Redmineflux Agile Board.
  4. Click Configure.
  5. Enable Show completed issues in Backlog.
  6. Save the configuration.

After it is enabled:

  • Completed issues stay in their sprint or version column instead of disappearing from the Backlog.
  • Their Story Points continue to count towards the closed total.

Notes:

  • The setting is disabled by default.
  • Column Story Point totals count finished work whether this setting is enabled or not.
  • A status filter applied directly on the Backlog page always takes priority over this setting.

How to Widen the Unassigned Issues Column

Projects that keep a long list of unplanned work can give the unassigned columns extra width, which makes a large backlog easier to read and manage.

  1. Go to Administration.
  2. Open Plugins.
  3. Find Redmineflux Agile Board.
  4. Click Configure.
  5. Enable Wider column for unassigned issues.
  6. Save the configuration.

After it is enabled:

  • The No Sprint and No Version columns are displayed wider than the other Backlog columns.
  • Sprint and version columns keep their standard width.

Notes:

  • The setting is disabled by default.
  • On smaller screens the columns keep the standard width so the layout stays readable.

How to Create and Manage Sprints

To create a sprint:

  1. Open the project.
  2. Go to Settings.
  3. Open Sprint management.
  4. Click New Sprint.
  5. Enter:
    • Name
    • Description
    • Start date
    • End date
    • Duration, if used
    • Status
    • Sharing option
  6. Save the sprint.

To edit a sprint:

  1. Open Sprint management.
  2. Select the sprint.
  3. Update the values.
  4. Save.

To delete a sprint:

  1. Open Sprint management.
  2. Select the sprint.
  3. Click Delete.
  4. Confirm the action.

How to Assign Issues to a Sprint

You can assign issues to a sprint in multiple ways.

From issue edit form:

  1. Open the issue.
  2. Click Edit.
  3. Choose a Sprint from the sprint field.
  4. Save.

From Backlog:

  1. Open Backlog.
  2. Drag an issue into the target sprint column.

From bulk update or supported issue actions:

  1. Select the issues.
  2. Choose sprint update options.
  3. Save changes.

How to Use Scrum Board View

The board supports both Kanban and Scrum modes.

To switch to Scrum mode:

  1. Open the Project Agile Board.
  2. Click Settings.
  3. Set Board Type to Scrum.
  4. Apply the settings.

When Scrum mode is active:

  • Sprint selection is available
  • The board can be filtered by sprint
  • Teams can focus on one sprint at a time

How to Use Version Planning in Backlog

The Backlog also supports version-based planning.

You can:

  • View versions as backlog columns
  • Drag issues into version columns
  • See unassigned issues separately
  • Plan releases visually

This gives teams one place to organize sprint work and release work.

How to Create Custom Agile Boards

Custom Agile Boards let you save different configurations for the same project.

You can create different boards for:

  • Development teams
  • QA teams
  • Management reporting
  • Scrum planning
  • Bug triage
  • Release monitoring

To create a custom board:

  1. Open the project Agile Board.
  2. Open the saved board or board sidebar.
  3. Choose the option to create a new custom board.
  4. Enter board details.
  5. Select:
    • Columns
    • Card fields
    • Totals
    • Filters
    • Grouping
  6. Save the board.

How to Edit or Remove Custom Agile Boards

To edit a saved board:

  1. Open the project Agile Board.
  2. Open the custom board list.
  3. Select the board.
  4. Click Edit.
  5. Update the configuration.
  6. Save changes.

To remove a saved board:

  1. Open the custom board list.
  2. Select the board.
  3. Click Delete or Remove.
  4. Confirm.

Saved boards can also include visibility and sharing rules depending on permissions.

How to Configure Tracker and Priority Icons

The plugin supports icon customization for:

  • Trackers
  • Priorities

To configure icons:

  1. Go to Administration.
  2. Open Plugins.
  3. Find Agile Board.
  4. Click Configure.
  5. Choose icons for each tracker and priority.
  6. If the selected icon is a text symbol, you can also set its color.
  7. Save the configuration.

These icons appear on issue cards and improve visual scanning.

How to Enable and Use Story Points

Story Points are now controlled by a plugin-level setting.

Important:

  • Story Points are disabled by default.
  • If disabled, the feature is hidden across the Agile system.
  • If enabled, Story Points are available on Project Agile Board, Global Agile Board, My Page Agile Board, Backlog, issue forms, and supported board totals.

To enable Story Points:

  1. Go to Administration.
  2. Open Plugins.
  3. Find Agile Board.
  4. Click Configure.
  5. Enable Story Points.
  6. Enter the allowed Story Point values.
  7. Save the configuration.

To display Story Points on boards:

  1. Open the board settings.
  2. Enable Story Points in card fields or totals where needed.
  3. Apply changes.

If the feature is disabled:

  • Story Points are not shown in UI
  • Story Point totals are hidden
  • Story Point field options are removed from board settings
  • Story Point controls are inactive across the Agile plugin

How to Set Story Points from an Issue Card

Story Points can be updated directly on an issue card, without opening the issue.

  1. Open a board that displays Story Points on cards.
  2. Click the Story Points value on the card.
  3. Select a value from the configured Story Point list.

The value is saved immediately. The card, the column total, and the Backlog Story Point badge are updated without reloading the page.

This is available on:

  • Project Agile Board
  • Global Agile Board
  • Backlog
  • My Page Agile Board

Important behavior:

  • Story Points must be enabled in plugin configuration and selected as a card field.
  • The value can only be changed by users who are allowed to edit that issue.
  • On closed projects the Story Points stay visible but cannot be edited.
  • Select None to clear the Story Points of an issue.

Language Support

The plugin interface is available in the following languages:

  • English
  • German
  • Spanish
  • French
  • Italian
  • Japanese
  • Dutch
  • Polish
  • Portuguese
  • Portuguese (Brazil)
  • Russian
  • Chinese

Each user sees the plugin in the language selected in their Redmine account settings.

Troubleshooting

If you face issues with the plugin, try the following:

  1. Clear browser cache and reload the page.
  2. Restart the Redmine application.
  3. Make sure the plugin is installed in plugins/agile_board.
  4. Re-run plugin migrations:
    bundle exec rails redmine:plugins:migrate RAILS_ENV=production
  5. Confirm the Redmine version is supported.
  6. Verify the project module is enabled in project settings.
  7. Check user permissions for:
  8. For My Page Agile Board issues:
    • Confirm the user is logged in.
    • Confirm the user has assigned issues in active visible projects.
    • Confirm the Agile Board block is added to My Page.
    • Confirm the selected visible statuses include the issue statuses.
  9. Review Redmine logs for plugin load or controller errors.
  10. If upgrading to Redmine 6, make sure the plugin code includes Rails 7-compatible serialize declarations.

Frequently Asked Questions

Q1. What is the difference between Project Agile Board and Global Agile Board?

Project Agile Board shows issues for one project. Global Agile Board shows issues across all projects the current user can access.

Q2. Does the plugin support both Kanban and Scrum?

Yes. Project boards can be used in Kanban or Scrum mode.

Q3. Can I customize the issue cards?

Yes. You can choose visible card fields from the board settings panel.

Q4. Can I save different board layouts for the same project?

Yes. The plugin supports custom saved boards with their own filters, columns, and card settings.

Q5. Can I use sprint planning and version planning?

Yes. Sprint and version planning are available from the Backlog view.

Q6. Are Story Points always enabled?

No. Story Points are controlled by plugin configuration and are disabled by default.

Q7. Can I edit issues directly from the board?

Yes. The plugin supports inline editing and double-click editing for supported actions.

Q8. Does the plugin support Redmine 6?

Yes. The current plugin supports Redmine 6.x.

Q9. Can users see Agile Board on My Page?

Yes. Users can add the Agile Board block to My Page to see their assigned issues as a personal Kanban board.

Q10. Can users customize the My Page Agile Board?

Yes. The My Page block supports visible statuses, WIP limits, card fields, totals, and column reordering. These preferences are stored per user.

Q11. Can I update Story Points without opening the issue?

Yes. When Story Points are enabled and shown on cards, you can click the Story Points value on a card and select a new value directly from the board.

Q12. How are Story Point totals shown in the Backlog?

Each Backlog column header shows closed points out of total points, for example 8 / 21 SP, so teams can read sprint progress at a glance.

Q13. Do completed issues count towards Story Point totals?

Yes. Closed Story Points are always included in the column total, whether or not completed issues are displayed in the Backlog.

Q14. Can I keep finished issues visible in a sprint?

Yes. Administrators can enable Show completed issues in Backlog from the plugin configuration page.

Q15. Which languages does the plugin support?

The plugin is available in English, German, Spanish, French, Italian, Japanese, Dutch, Polish, Portuguese, Portuguese (Brazil), Russian, and Chinese.

Q16. Does the plugin support Redmine 7?

Yes. The current plugin supports Redmine 7.0.x in addition to the earlier supported versions.

Uninstallation

To uninstall the plugin:

  1. Go to the Redmine installation directory.
  2. Remove the plugin folder: plugins/agile_board
  3. If you want to roll back database changes, run:
    bundle exec rails redmine:plugins:migrate NAME=agile_board VERSION=0 RAILS_ENV=production
  4. Restart Redmine.

Take a database backup before rollback or uninstallation.

Conclusion

Redmineflux Agile Board is a modern Agile execution and planning plugin for Redmine that brings together project boards, global visibility, My Page personal boards, backlog planning, sprint management, saved custom boards, grouping, WIP control, and optional Story Points in one unified experience. It is designed to give teams a faster, cleaner, and more flexible workflow than previous Agile Board versions.

Need a hand?Write to support@redmineflux.com – we answer within one business day, Monday to Friday.
Contact support
More guides

Other plugin guides

ChecklistCRMCustom DashboardFluxshotGantt ChartHelpdeskInline EditorInvoiceIssue TemplateKnowledge BaseMentionsNotificationMCP ServerTagsTest Case ManagementTime TrackerTimesheetWorkload