Pega Platform includes a default pySkipLinksToTarget section that is added automatically to your application. The section includes skip links to the main content, the search bar, and the navigation pane, and you do not need to configure it.

You can expand the default skip link section by configuring custom skip links and saving the section in the application ruleset.

Note the following accessibility best practices:

• Use no more than five skip links. Three is the recommended maximum.
• Ensure that the links are the first tab on a given page.
• Ensure that the links have visible focus and support Tab key navigation.
• Ensure that the links are visible to all users who use the Tab key for navigation.

Creating a text file that holds the JavaScript code for the skip link

1. In the header of Dev Studio, click CreateTechnicalText File.
2. On the New tab, define the text file record configuration and context, and then click Create and open.
   The file extension for text files that hold JavaScript code is js.
3. In the text field, enter the skip link code.
   For example: The code for skip links in Pega Platform is stored in the file pzpega_ui_doc_focus.js. You can use it as reference for your custom skip link code.
4. In the upper right corner of the form, click Save.

Adding the script to the harness

5. Search for and open the harness to which you want to add the skip link section.
6. On the Scripts & styles tab, in the Scripts section, click the Add a row icon.
7. In the Type field of the new row, select js.
8. In the Name field, select the text file with the skip link code.
9. Click Save.

Adding the link to the default skip link section

10. Open the pySkipLinksToTarget section.
11. From the Action list, add a Link control to the section.

Configuring the custom skip link

12. Select the new link, and then click the View properties icon.
13. In the Cell properties window, on the General and Presentation tabs, define the look and behavior of the link.
    For more information, see Configuring common control settings.
14. On the Actions tab, create a new action set:
    1. Click Create an action set.
    2. Click Add an event Click.
    3. Click Add an actionAll actionsRun script.
    4. In the Function name field, enter the name of the function that you want to assign to the link.
    5. Define the contentType parameter for the area.
    6. Click Submit.

Saving the pySkipLinksToTarget section to the application ruleset

15. On the section form, click Save as.
16. In the Apply to field, select a class in your application ruleset, and then click Create and open.
    Note: Keep the default section name to enable inheritance.
17. On the section form, click Save.