Portfolio SEO Checklist: Make the Work Understandable

Set the Right SEO Expectation

SEO can help a portfolio appear for your name, project topics, discipline, talks, writing, and specific expertise. It does not replace applications, referrals, relationships, or a portfolio that proves the work.

Google recommends people-first content: material created to help an intended audience, with first-hand expertise and a clear site focus. For portfolios, your strongest advantage is evidence only you can provide—your context, decisions, artifacts, outcomes, and reflection.

Check Discovery and Indexing

1. 1. Verify ownership in Search Console. Inspect the homepage and one important project URL.
2. 2. Check robots rules. Confirm important pages are not blocked from crawling.
3. 3. Check index controls. Remove unintended noindex directives from public pages; keep private work private.
4. 4. Submit a current sitemap. Include canonical public URLs and accurate modification dates where your platform supports them.
5. 5. Fix status codes. Important pages should return a successful response; moved pages should redirect to the closest real replacement.
6. 6. Use internal links. Orphan pages are difficult for people and crawlers to discover.

Describe Each Page Clearly

• □ Give every important page a unique, descriptive HTML title.
• □ Use one clear H1 that matches the page’s actual purpose.
• □ Write a concise meta description for the search snippet; expect search engines to rewrite it when another passage fits the query better.
• □ Use a stable, readable URL. Do not rename a live route casually; redirect old URLs when a move is necessary.
• □ Set a canonical URL when duplicate or alternate URLs can expose the same content.
• □ Link to the page from crawlable site navigation or relevant internal content.
• □ Make the page useful without requiring a search crawler to perform an obscure interaction.

Write Useful Project Content

• Name the product, service, audience, problem, and discipline in natural language.
• Explain your role, team, constraints, and important decisions in live text.
• Use descriptive headings that summarize what happened, not only “Process” and “Solution.”
• Define specialized terms an outside reader may not know.
• Link related projects and supporting writing when the connection is useful.
• Update or remove stale claims. Show publication and revision dates when freshness matters.
• Do not generate near-duplicate city, specialty, or service pages merely to capture variations of a query.

Use the case study structure guide to improve the underlying content before optimizing labels around it.

Make Images Support the Page

• Use meaningful filenames when creating assets, but do not rename files only to stuff keywords.
• Write alt text for the image's purpose and information in context.
• Place relevant explanatory text near important images.
• Serve appropriately sized images and reserve their dimensions to protect layout stability.
• Keep essential project information in HTML instead of relying on text embedded in mockups.
• Use an image sitemap only when your site or image use actually needs it.

For delivery details, see image optimization for portfolios.

Use Structured Data Carefully

Structured data describes visible page content in a machine-readable form. It is not a ranking guarantee, and markup that is inaccurate, hidden, or unsupported can create problems.

• Use types and properties documented by Schema.org and supported by the search feature you are targeting.
• Represent the real entity: person, organization, article, breadcrumb, or another appropriate type.
• Do not invent a “Portfolio” type or add ratings, employers, clients, or awards that the page does not substantiate.
• Validate syntax with Google's Rich Results Test when the markup targets a supported result, and use Schema Markup Validator for general schema.
• Keep markup synchronized with visible content after edits.

Improve Page Experience

Google says Core Web Vitals are used by ranking systems, while also stating that good scores do not guarantee top rankings. Optimize because speed, stability, accessibility, security, and mobile usability help people use the portfolio.

• Measure field data when available and use lab tools to diagnose reproducible problems.
• Optimize the largest above-the-fold image and do not lazy-load it by default.
• Set image dimensions to reduce layout shift.
• Reduce unnecessary JavaScript, third-party embeds, and font variants.
• Use HTTPS and remove intrusive overlays that block the main content.
• Test important tasks on mobile, keyboard, zoom, and slower connections.

Measure and Maintain

1. Check Search Console for indexing changes, crawl problems, and queries that already surface the site.
2. Review whether those queries match the work and audience you want—not just whether impressions increased.
3. Inspect the pages receiving impressions and improve missing context rather than adding generic filler.
4. Recheck redirects, canonical URLs, metadata, structured data, and sitemaps after platform or domain changes.
5. Update case studies when the work or outcome changes, and note meaningful revisions.
6. Protect privacy: collect only analytics you need and follow the consent and disclosure rules that apply to your audience.

Official Search Sources

• Google Search Central: How Search Works — crawling, indexing, and serving results.
• Creating helpful, reliable, people-first content — Google's content guidance.
• Understanding page experience in Google Search results — page-experience signals and their limits.
• Sitemaps overview, canonicalization, and structured data introduction — technical implementation references.