Adding links to your resume—whether to your portfolio, LinkedIn profile, or GitHub repository—can showcase your work and credibility. However, including links in an ATS resume safely requires careful formatting and strategic placement. Many job seekers unknowingly add links that break ATS parsing, get stripped during processing, or trigger security filters that cause automatic rejection.
This guide covers everything you need to know about safely including links in your ATS resume without compromising your chances of passing automated screening systems.
What you'll learn:
- Why certain link formats fail in ATS systems
- Which types of links are safest to include
- How to format URLs so ATS systems read them correctly
- Common mistakes that get resumes filtered out
- Best practices for different link types (portfolio, LinkedIn, GitHub)
- Step-by-step instructions for adding links safely
Why Including Links on Your Resume Matters
Links on your resume serve a critical purpose: they provide recruiters with direct access to your work, credentials, and professional presence. A portfolio link shows tangible projects. A GitHub link demonstrates coding ability. A LinkedIn URL establishes your professional network. These connections can be the difference between a generic resume and one that stands out.
However, the challenge is that resume formatting errors that break ATS parsing often include improper link handling. ATS systems parse text differently than human readers. A clickable hyperlink in Microsoft Word may appear as plain text, broken formatting, or unreadable characters when processed by ATS software. Understanding how to format links so they survive ATS parsing is essential.
Key Elements of Safe Resume Links
Plain Text URLs vs. Hyperlinks
The safest approach is to use plain text URLs rather than embedded hyperlinks. When you create a hyperlink in Word or Google Docs, the software stores formatting metadata that ATS systems may not recognize. Instead, type the URL as plain text: www.yourportfolio.com or github.com/yourname. This ensures the ATS reads it as readable text, not as hidden formatting code.
Recruiters and hiring managers can still click plain text URLs or copy-paste them into their browser. The key is making sure the URL is visible and readable to both machines and humans.
URL Shortening and Tracking Links
Avoid URL shorteners like bit.ly, tinyurl, or custom tracking links. While these can work in some cases, they introduce unnecessary risk. ATS systems may flag shortened URLs as suspicious, and recruiters may be hesitant to click unfamiliar links. Additionally, if the shortening service goes down, your link becomes useless. Always use the full, direct URL to your actual website or profile.
Protocol Inclusion (http:// vs. www)
Include the protocol (http:// or https://) or start with www. to make URLs clickable in most email clients and ATS systems. For example, write https://github.com/yourname rather than just github.com/yourname. This small detail significantly increases the likelihood that the link will be recognized and clickable by recruiters reviewing your resume outside the ATS.
Anchor Text vs. Bare URLs
In plain text resumes, avoid using anchor text (like "Click here for my portfolio"). Instead, use the bare URL or a minimal label. For example, write Portfolio: www.yourportfolio.com or GitHub: github.com/yourname. This keeps the resume clean, ensures ATS systems parse the URL correctly, and gives recruiters clear context about what the link contains.
Common Mistakes to Avoid
- Embedded hyperlinks with colored text: Hyperlinks formatted with blue text and underlines often get stripped or misinterpreted by ATS. The URL may not be readable, or the formatting may break the resume layout during parsing.
- Multiple links in one line: Writing "Portfolio | LinkedIn | GitHub" with all three as hyperlinks can confuse ATS parsing. Use plain text URLs separated by spaces or line breaks instead.
- Links without context: A bare URL without a label (like just "www.example.com" floating in the resume) confuses recruiters. Always label your links: "Portfolio: www.example.com" or "LinkedIn: linkedin.com/in/yourname".
- Personal website URLs that are vague: Avoid links like "www.mysite.com" without context. Be specific: "Portfolio: www.yourname-portfolio.com" or "Blog: www.yourname.dev".
- Outdated or broken links: Before submitting, test every link. A broken portfolio link or outdated LinkedIn URL signals negligence and wastes recruiter time.
- Mixing URL formats: Don't use both shortened and full URLs, or mix http and https inconsistently. Standardize your format throughout the resume.
Best Practices for Safe Resume Links
- Use plain text URLs in ATS-optimized resumes: If you're submitting a resume directly into an ATS form or as a .txt file, use plain text URLs. If submitting a PDF or Word document, plain text is still the safest choice.
- Include only relevant, professional links: Limit links to LinkedIn, GitHub, portfolio, personal website, or professional blog. Skip social media links (Twitter, Instagram, TikTok) unless directly relevant to the role.
- Place links strategically in your resume: Add links in a dedicated "Links" or "Online Presence" section near the top, or integrate them into your contact information. Avoid scattering links throughout the resume.
- Test your resume in multiple formats: Save your resume as both PDF and Word. Open each version in a text editor to verify URLs are readable. Submit the format that preserves your links best.
- Ensure links are current and active: Before applying, click every link to confirm it works. Update LinkedIn URLs to your public profile link, not your edit page. Verify portfolio sites load correctly.
- Use a professional domain if possible: A custom domain (yourname.com) looks more professional than a generic portfolio platform URL. If you use platforms like GitHub Pages or Squarespace, ensure the URL is clean and branded.
- Avoid link tracking pixels or analytics: Don't use URLs with tracking parameters (?utm_source=resume). These can be flagged by ATS systems and look unprofessional.
- Keep URLs short and readable: Long, complex URLs with many parameters are harder to read and more prone to breaking. Use clean, simple URLs whenever possible.
How to Add Links to Your Resume Safely: Step-by-Step
- Choose which links to include: Decide on 2–4 links maximum. Prioritize LinkedIn and a portfolio or GitHub. Skip unnecessary links.
- Gather your URLs: Collect the full URLs for each link. For LinkedIn, use your public profile URL (linkedin.com/in/yourname), not your edit page. For GitHub, use github.com/yourname. For portfolio, use your actual domain.
- Format as plain text: In your resume document, type the URL as plain text with a label. Example: "Portfolio: www.yourportfolio.com" or "GitHub: github.com/yourname".
- Place links in a dedicated section: Create a "Links" or "Online Presence" section below your contact information, or integrate them into your contact line. Keep them organized and easy to find.
- Save in the right format: Save your resume as a PDF if the job posting doesn't specify. PDFs preserve formatting better than Word documents in many ATS systems. However, if the posting asks for .docx, use Word and ensure links are plain text.
- Test your resume: Open your saved resume in a text editor (Notepad or similar) to verify URLs are readable as plain text. Click each link in your PDF viewer to ensure they're clickable.
- Proofread for accuracy: Check spelling of URLs, verify protocols (https://), and confirm each link works before submitting.
- Submit according to instructions: Follow the job posting's file format requirements. If unsure, use PDF with plain text URLs as the safest default.
Safe Formatting for Different Link Types
LinkedIn Profile Links
Use your public LinkedIn profile URL: linkedin.com/in/yourname. To find this, go to your LinkedIn profile, click "Edit public profile URL" in the About section, and copy the clean URL. Never use your edit page URL or a LinkedIn recruitment link. Format it as: LinkedIn: linkedin.com/in/yourname.
GitHub and Code Repository Links
Use your GitHub profile or specific repository URLs. For your main profile: github.com/yourname. For a specific project: github.com/yourname/project-name. Ensure your GitHub profile is public and your repositories are visible. Format as: GitHub: github.com/yourname.
Portfolio and Personal Website Links
Use your full domain: www.yourname.com or yourname-portfolio.com. If using a platform like Squarespace or Wix, use the custom domain if available, or the platform's URL if not. Ensure your portfolio is mobile-friendly and loads quickly. Format as: Portfolio: www.yourname.com.
Conclusion: Safe Links = More Interviews
Including links in your ATS resume safely is straightforward when you follow best practices: use plain text URLs, include only relevant links, format them clearly with labels, and test them before submitting. Avoid hyperlinks with special formatting, URL shorteners, and broken links. Place your links strategically in a dedicated section or contact line where recruiters can easily find them.
The goal is to make it effortless for both ATS systems and human recruiters to access your portfolio, GitHub, LinkedIn, and other professional assets. By formatting links correctly, you remove a common barrier to getting past resume screening and increase your chances of landing an interview. Test your resume in the required format, verify every link works, and submit with confidence.
Frequently asked questions
Technically, you can, but plain text URLs are safer. Hyperlinks with formatting (blue text, underlines) may not parse correctly in ATS systems. The URL might be readable, but the formatting could break or confuse the parser. Plain text URLs are universally recognized and safer for ATS compatibility. If you do use hyperlinks, ensure they're formatted simply without special colors or styling.
If you don't have a personal website, focus on LinkedIn and GitHub (if applicable). You can create a free portfolio on platforms like GitHub Pages, Squarespace (free tier), or Wix. Alternatively, link to a well-organized GitHub profile showcasing your best projects. A professional online presence is valuable, but a polished GitHub profile or LinkedIn is better than a poorly designed personal website.
Include 2–4 links maximum. Typically: LinkedIn, GitHub or portfolio, and optionally a personal website or blog. More than four links clutters your resume and may overwhelm recruiters. Prioritize the most relevant links for the role. A software engineer should include GitHub; a designer should prioritize a portfolio link. Keep it focused and professional.
Yes, plain text URLs in PDFs are readable and often clickable, depending on the PDF viewer. However, ATS systems may not recognize them as clickable links; they'll just see text. Recruiters reviewing your PDF manually can copy-paste or click the URL. For maximum compatibility, use plain text URLs formatted clearly (with https:// or www.) so they're recognizable to both machines and humans, whether in PDF or Word format.
Always follow the job posting's instructions. If they ask for .docx, submit Word. If they ask for PDF, submit PDF. If they don't specify, PDF is generally safer for formatting preservation. Regardless of format, use plain text URLs to ensure compatibility. Test your resume in the required format before submitting to verify links are readable and the layout is intact.
QR codes are risky for ATS resumes. ATS systems cannot scan QR codes, and they take up space without adding readable text. Recruiters reviewing printed resumes might scan them, but most resumes are reviewed digitally. Stick with plain text URLs. If you want to include a QR code for a printed version, add it alongside the text URL, not as a replacement.