dotCMS logodotCMS logo
OverviewAuthorBuildManageReference
dotCMS Github RepodotCMS Github RepodotCMS Discourse CommunityChat With Us
Overview
ReleasesIntroductionGuides and Tutorials
No Overview side nav found for /docs/link-checker.

dotCMS

Universal content management, made simple.

GitHubTwitterLinkedIndotCMS Discourse Community
dotDev HomeBlogChangelogsCurrent releasesAboutContactPrivacy PolicyTrust Center

© 2026 dotCMS. All rights reserved.

    Assistant

    Responses are generated using AI and may contain mistakes.

    Hi, I'm an AI assistant with access to documentation and other content.

    Tip: You can toggle this pane with ⌘/ or ⌘K.

    Try asking

    Enter to send · Shift+Enter for newline

    Link Checker

    Deprecated: Link Checker
    22.10
    Deprecated Oct 20, 2022Deprecated in 22.10
    Recommendation

    dotCMS recommends the use of a third-party tool to perform link audits, such as:

    • Google Search Console

    • Semrush Site Audit

    • Ahrefs Broken Link Checker

    • Moz Link Explorer

    • W3C Link Checker

    • Screamingfrog SEO Spider

    If you wish to run your own link-checking service, we recommend operating it externally as a microservice or serverless component — ideally from multiple locations — to better view your links in the same manner as the general public. This is more scalable and secure than running the process from the main application, and can help to avoid hard-to-notice discrepancies caused by corporate firewalls and similar factors.

    Reason

    It is usually better to perform link checking from outside of the server in question; as such, a third-party, off-site solution is more suited to the task. For this reason, we elected to halt maintenance of this feature.

    All deprecations

    Note ⚠️#

    The Link Checker feature is deprecated; dotCMS recommends the use of a third-party tool to perform link audits, such as:

    • Google Search Console
    • Semrush Site Audit
    • Ahrefs Broken Link Checker
    • Moz Link Explorer
    • W3C Link Checker
    • Screamingfrog SEO Spider

    If you wish to run your own link-checking service, we recommend operating it externally as a microservice or serverless component — ideally from multiple locations — to better view your links in the same manner as the general public. This is more scalable and secure than running the process from the main application, and can help to avoid hard-to-notice discrepancies caused by corporate firewalls and similar factors.

    The Link Checker portlet allows you to run a check for broken links on your site content.

    Running the Link Checker#


    To run the Link Checker:

    1. Select Content -> Link Checker.
    2. Click the Run Check Now button.

    The link check process runs in the background and checks for broken links in all content of Content Types which contain WYSIWYG fields or Text Area fields.

    You can click the Refresh button to display the progress and results of the link checking process. Once the process finishes it will display one row with the following information for each broken link found:

    • Title: Content title
    • Field: Field where the broken link was found
    • Structure: Content type for the given content
    • User: User that modified the content
    • Modified date
    • URL: Broken Link.

    Fixing Broken Links#


    To fix any broken link, click the pencil icon next to each listed content to edit that content. Find the broken link within the content and replace it with a corrected link.

    Video#