# Fixing broken links using the Fixup link references wizard

You can fix broken links by double clicking on the broken link entries in the Problems view and manually correcting the errors, however, to fix a large number of broken links, you can use the Fixup Link References wizard. This wizard is especially adept at fixing errors that occur if you move a file that is the target of links to a different folder.

To fix links using the Fixup Link References wizard, complete the following steps:

1. Right-click a resource (a project, folder, or file) from the Project Explorer view.
2. Select Link Utilities > Fix Broken Links from the pop-up menu; the Fixup Link References wizard opens. The wizard populates the table with the broken links, the suggested fixed link (if it can determine this information), and the location of the broken link. Each link is designated by the wizard to either be fixed or skipped, as indicated by the Fix icon () or the Skip icon ()

   To change a designation, highlight the link and click on the Fix button or the Skip button. The icon in front of the link changes based on your choice. You can also designate your choice by clicking directly on the icons. Note that there must be data in the Fixed Link field before you can change these designations. Each time you change a designation, the counter at the bottom keeps track of how many link are selected to be fixed or skipped.
3. You can change how the links are structured by selecting one of the following styles from the pull-down menu: Use existing style, Use document relative links, Use document root relative links. The Fixed Link column is updated to reflect the structure selection.
4. You can check the Group links that go to the same destination check box to group all of the broken links that point to the same location into one row in the table. Any change you make to a grouped row are applied to all instances of that broken link.
5. Ensure the link text in the Fixed Link field for each link is accurate.

   When deciding how to fix a broken link, it can be useful to look at the Context box, which displays the source where the broken link is located. If you select a different broken link in the table, the Context view is refreshed with the source surrounding the selected broken link. Note that you cannot enter or change text in the Context box. box.

   If the wizard cannot suggest a way to fix the broken link, you can manually enter the text in the Fixed Link field by clicking in the field. You can also locate a link by clicking the Suggestions button and navigating to the correct link.

   - If you click on the Suggestions button, select one of the entries in the Suggestions field to populate the Fixed Link field. (Links to resources within the current project are listed above suggestions to links to resources in external projects.) Note that all suggestions are structured with paths relative to the document root; however, the Fixed Link field in the Fixup Link Reference wizard will be populated according to the structure you designate.
   - Alternately, click Browse to locate the location of the link target manually. You can browse for a File, Servlet, or Class.

   Click OK when you are satisfied with the new link.

   The Fixed Link field is populated in the table in the Fixup Link Reference wizard.
6. When you are satisfied with your selections and the fixed link values, click Fixup Links. The links are all updated to reflect the values in the Fixed Link column, and the wizard closes.

Another useful feature when fixing broken links is the ability to sort the broken links by location. Clicking the Found in Page heading sorts the rows by their location. This may be useful if you want to correct broken links based on their page location.

Related tasks

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.