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.
  • 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 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.”

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."

Video Tutorial

Hi and welcome to Accessible Web RAMP. In this video I’m going to show you how to create and manage remediation tasks in your RAMP account.

Remediation tasks are actionable tasks that need to be taken to resolve accessibility issues. They include details like code snippets, success criteria, links to pages, and screenshots.

You can see in this example Remediation Task, that there is also a remediation recommendation. These are super valuable. They are instructions on how to approach fixing this accessibility issue. Remediation recommendations are only pre populated if you’re on our advanced or premium plans. I’ll show you what it looks like if you are on a basic or freemium plan when you go to create a Remediation Task.

So I’ll show you first how to create a Remediation Task from page monitoring results. We’ll go to Page Monitoring, View All Pages and select the page that we want to work on. I’m going to use this about page. To create a Remediation Task, click Create Remediation Task under the accessibility issue that you want to create a task for. I’m going to do this one first, because it’s more critical and it affects two elements on the page. You can see that we pre populate all remediation task forms with the title of the accessibility issue detected, the success criteria associated with it, the page it’s located on, and the elements affected. Click Create Remediation Task to add it to your remediation tasks. And then we’ll go to the task to view the task that we just added. This is the task we had just added to our Remediation Tasks List.

Remediation tasks come in under To Do status. As you start working on them, we recommend changing it to In Progress to note where you are in the process of working on it. And then to Complete, when you complete work on the remediation task. When you mark it as Complete, you’ll also be prompted to add a new Log Entry. This is just important to note because building out your log is a great way to document accessibility progress on your site. And so we recommend adding as many details as possible to both your Remediation Task and Log Entry after you complete the task.

So we can see this one actually doesn’t have the pre populated remediation recommendations. This is what the same task would look like on a premium or advanced account where we pre populate those remediation recommendations.

So now I’m going to show you how to create a Remediation Task from a User Ticket submitted to your Ally Center. We just have one open user ticket here. So I’m going to click User Ticket. And we can see that this one at the end is open still. Clicking on that user ticket, we can see that a user submitted a get help form stating that they had issues checking out using keyboard-only navigation.

To create a Remediation Task for this accessibility issue. I’m going to click New Task. And because this was a Remediation Task created from a user ticket, there’s going to be less pre population. So I’ll want to just provide a little bit more info like keyboard tab navigation as the title. I’ll say this is on the about page. I’ll also link it to the about page so I know what page is associated with. I like to put quotations around this just so I know that this was submitted by the user. And then we can provide some additional details about the functional issue on the page.

I also recommend if you do know the success criteria associated with the issue, adding it here. And if you are using tags to organize workflow, you can add tags and assign users to work on the ticket. So then I’m going to create this Remediation Task and like before it flows right into my Remediations Tasks section.

All right, this has been adding remediation tasks to RAMP.

If you have any questions or run into any issues, please contact us and we’re more than happy to help!

Think you’re ready to start doing some WCAG auditing yourself? Use our Workbooks to help facilitate the process. Workbooks are created to help document WCAG failures while performing page audits and to quickly create remediation tasks from the results.

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.