Create Remediation Tasks

A list of 3 remediation tasks with different statuses, "in progress," "on hold," and "ready for review."

Remediation tasks are the actionable tasks that need to be taken to resolve accessibility issues. They can include details like code snippets, success criteria, links to pages, and screenshots. You can even connect your Jira account to synchronize tasks directly within your Jira environment.

RAMP helps streamline your accessibility project by allowing you to quickly and easily create remediation tasks with relevant information attached.

In this article we’ll cover:

General Information

Remediation tasks can be created from:

  • Recommended Action Items.
  • Individual violations on a page-by-page basis (both in RAMP and through the web accessibility chrome extension, Accessible Web Helper).
  • User-submitted help tickets (User Tickets).
  • Manual remediation task entries based on audit results and other independent tests.

Tasks created from Recommended Action Items include links and information on the number of pages the affected element appears on to help you prioritize the most impactful accessibility issues.

An expanded remediation task. It includes a link to an external reference, a code snippet, and a remediation recommendation.

Additionally, all remediation recommendations created through RAMP include:

  • Detailed notes on the relevant violation.
  • Links to relevant WCAG Success Criteria.
  • The affected element’s code snippet.
  • Instructions for remediation.
  • Chrome extension integrations.
  • And more!

Remediation tasks can be assigned to teammates, tagged for organization purposes, and managed through status changes to indicate when a task is being worked on (“In Progress”), is ready for verification, and resolved (“Complete”) for example.

Remediation tasks can be organized and filtered by status, tags, WCAG ruleset, success criteria, assigned user, and recent comments.

Accessible Web for Jira

Does your team work in Jira? You can connect your Jira account to RAMP so you can:

  • Create Jira issues from remediation tasks,
  • Sync and track statuses of Jira issues linked to remediation tasks, and
  • Filter by Jira status in RAMP.

More information on Accessible Web for Jira is in this article.

As you complete remediation tasks, remember to add log entries to your Accessibility Log to document progress. RAMP prompts you to create log entries when remediation tasks are marked as “Complete.”

Video Tutorial

Creating Tasks from Recommended Action Items

Our recommendation system prioritizes your work by surfacing the most pervasive accessibility issues, quantifies your impact with score estimations, and removes the guesswork by verifying your fixes on demand.

Creating single tasks

You can create individual tasks from recommended action items by clicking on the “Add Task” button on the recommended action item of your choice. You can access these recommendations from the overview tab or automated scanning tab.

2 recommendations from the overview tab. Each recommendation has a learn more link and an add task button at the bottom.

Creating tasks in bulk

  • Click the “View All Recommendations” link.
The top of the recommendations section. There is a link that says "View all 14 recommendations" on the top right.
  • Check the boxes of the tasks you’d like to create tasks for and click Actions > Bulk Add Tasks.
A selected recommendation. Its box is checked and it is outlined in blue.
The actions button displaying a dropdown. The dropdown says "Recommendation actions, bulk add tasks."

Creating Tasks from Violations

From violations

Select a violation from the overview, automated scanning, or pages tab and click create task. This will pop open a task outline containing the task name, associated page, and pre-populated description and remediation instructions.

Troubleshooting & Frequently Asked Questions

Have questions you aren’t seeing the answers to? Get in contact with us.

  • How can I add links, lists, and code snippets to the remediation task description?

    Accessible Web RAMP supports CommonMark in the description field of remediation tasks. If you’ve ever used the formatting actions in Slack, for example, then you are already very familiar with CommonMark. You can view this guide on using CommonMark to learn more about its capabilities.