Schema Guide·Updated March 2026

Schema Markup for Portfolios: Quick Implementation Guide

Add Person, CreativeWork, and ProfessionalService schema to your portfolio site. A guide to structured data that helps freelancers get discovered in search and AI.

Why Schema Matters for Portfolio

Portfolio websites have a unique schema opportunity that most freelancers and agencies overlook. Unlike businesses that compete on products or services, portfolio sites compete on personal expertise — and Person schema is the structured data equivalent of a digital resume that search engines and AI engines can read. When someone searches "UX designer specializing in fintech" or asks ChatGPT "recommend a freelance web developer with React experience," the professionals who surface are those whose skills, credentials, and work are machine-readable through structured data. Person schema with knowsAbout, sameAs, and jobTitle properties builds a professional entity that Google can recognize across platforms — potentially triggering a Knowledge Panel for your name. CreativeWork schema on project pages structures your portfolio pieces with descriptions, dates, and client references that both Google and AI engines parse when evaluating your expertise. In a gig economy where freelancers compete globally for projects, schema markup transforms your portfolio from a static showcase into a discoverable, machine-readable professional profile that works for you across every search and AI channel 24/7.

Essential Schema Types for Portfolio

Implement these 4 schema types to maximize your search visibility and AI engine compatibility.

1.Person

Critical

Establishes your professional identity and enables knowledge panel

{
  "@type": "Person",
  "@id": "#me",
  "name": "Jordan Lee",
  "jobTitle": "UI/UX Designer",
  "url": "https://jordanlee.design",
  "image": "https://jordanlee.design/headshot.jpg",
  "sameAs": [
    "https://dribbble.com/jordanlee",
    "https://linkedin.com/in/jordanlee",
    "https://github.com/jordanlee"
  ],
  "knowsAbout": ["UI Design", "UX Research", "Design Systems", "Figma"]
}

Pro tip: Include at least 4-5 sameAs links to your professional profiles (LinkedIn, Dribbble, Behance, GitHub, etc.). This cross-referencing is the primary trigger for Google Knowledge Panels. The more verified profiles that link back to your portfolio, the stronger your entity signal.

2.CreativeWork

Recommended

Structures portfolio projects for search engines and AI to understand

{
  "@type": "CreativeWork",
  "name": "Finova Banking App Redesign",
  "description": "Complete UX overhaul of a mobile banking app, increasing user engagement by 40%.",
  "creator": { "@id": "#me" },
  "image": "https://jordanlee.design/projects/finova.jpg",
  "dateCreated": "2025-01-10",
  "keywords": ["mobile app", "fintech", "UX design"]
}

Pro tip: Add measurable results in your CreativeWork descriptions ("increased engagement by 40%," "reduced bounce rate by 25%"). AI engines favor specific outcomes when recommending freelancers — vague descriptions like "redesigned a mobile app" carry much less weight.

3.ProfessionalService

Recommended

Defines your service offerings for freelance and agency queries

{
  "@type": "ProfessionalService",
  "name": "Jordan Lee Design Services",
  "provider": { "@id": "#me" },
  "serviceType": "UI/UX Design",
  "areaServed": "Worldwide",
  "description": "Product design, UX research, and design system consulting for startups and enterprises."
}

Pro tip: If you offer multiple service types (design, development, consulting), create separate ProfessionalService entities for each. This helps AI engines recommend you for specific service queries rather than generic "freelancer" searches.

4.WebSite

Recommended

Defines your portfolio site for sitelinks search box eligibility

{
  "@type": "WebSite",
  "@id": "#website",
  "name": "Jordan Lee — UI/UX Designer",
  "url": "https://jordanlee.design",
  "author": { "@id": "#me" },
  "description": "Portfolio of Jordan Lee, a UI/UX designer specializing in fintech and SaaS products."
}

Pro tip: Connect your WebSite to your Person via the author property. This tells Google that your portfolio is an authoritative representation of your professional identity — strengthening entity association and sitelinks eligibility.

Common Mistakes to Avoid

These are the most frequent portfolio schema issues we see during audits.

#1 — No Person schema with professional credentials

A portfolio site without Person schema is a missed entity opportunity. Google and AI engines cannot build a professional profile for you without structured data defining your name, title, skills, and credentials.

Fix: Add comprehensive Person schema on your about/homepage with name, jobTitle, knowsAbout (skills array), image (professional headshot), sameAs (social/professional links), and optionally alumniOf for educational background.

#2 — Portfolio projects without CreativeWork markup

Project pages with only images and text descriptions are not machine-readable. Search engines and AI cannot extract project details, dates, or outcomes — meaning your best work is invisible to structured data consumers.

Fix: Add CreativeWork schema to each project page with name, description (including measurable outcomes), creator (@id reference to your Person), dateCreated, image, and keywords. For client work, add sourceOrganization for the client.

#3 — Missing sameAs links to professional profiles

Without sameAs cross-referencing to Dribbble, LinkedIn, GitHub, Behance, or other professional platforms, Google cannot verify your entity across the web. This significantly reduces Knowledge Panel eligibility.

Fix: Add sameAs array with URLs to every professional profile where you have a presence. Ensure each platform profile links back to your portfolio URL — bidirectional linking is what Google uses to confirm entity identity.

#4 — No knowsAbout property listing skills and expertise

Person schema without knowsAbout means AI engines cannot match your profile to skill-specific queries. When someone asks "find a Figma expert for a SaaS project," AI engines look for structured skill data to match.

Fix: Add a knowsAbout array with your key skills and expertise areas. Be specific: "Figma" is better than "Design Tools," "React" is better than "Frontend Development." Include 5-10 specific skills that match the queries you want to rank for.

How to Test Your Schema

1Check your homepage or about page source for Person schema with name, jobTitle, knowsAbout, image, and sameAs links to at least 3 professional profiles
2Verify each project page has CreativeWork schema with creator referencing your Person via @id, description with outcomes, and dateCreated
3Paste your complete @graph JSON-LD into Rankeo's Schema Validator and confirm all @id cross-references between Person, CreativeWork, ProfessionalService, and WebSite resolve
4Search your full name on Google — if no Knowledge Panel appears, verify your sameAs links are correct and that each linked profile links back to your portfolio
5Ask ChatGPT or Perplexity to recommend a professional with your skill set in your area — check if your name or portfolio URL appears in the response

Validate Your Schema Free

Generate Portfolio Schema Instantly with Rankeo

Stop writing schema markup by hand. Rankeo's schema generator builds a complete, validated @graph array for your portfolio site in seconds — including all 4 essential types above.

Programmatic builders — no AI hallucinations
Connected @graph with proper @id references
Validated against Google Rich Results requirements
One-click copy to your site

Generate Your Schema Free Schema Validator

The Bottom Line

Portfolio schema markup transforms a static showcase into a discoverable professional entity. Person schema with skills and credentials, CreativeWork schema with measurable project outcomes, and ProfessionalService schema for your offerings create a machine-readable professional profile that both Google and AI engines can index and recommend. With most freelancers having zero structured data on their portfolio sites, implementing these four schema types gives you a significant discovery advantage in both traditional search and the AI-powered recommendation feeds that increasingly influence hiring decisions.

Frequently Asked Questions

What schema types does a portfolio website need?

Person schema with your credentials and skills is the foundation. Add CreativeWork for each portfolio project, ProfessionalService for your service offerings, and WebSite to define your portfolio. These help search engines and AI models understand your professional identity and expertise.

Does schema markup help freelancer SEO?

Yes. Person schema with knowsAbout and sameAs links builds your professional authority online. It can trigger Knowledge Panels for your name and helps AI engines cite you as an expert in your field. Freelancers with proper schema see increased discovery for skill-specific and name-based searches.

How do I add schema to my portfolio site?

Add Person schema on your about page with your name, title, skills, and links to professional profiles. Add CreativeWork schema on each project page with descriptions and outcomes. Connect everything with @id references in a @graph array on each page.

Can schema markup trigger a Knowledge Panel for my name?

Yes, though it is not guaranteed. The key factors are: comprehensive Person schema with your full name, jobTitle, and image; sameAs links to 4-5 verified professional profiles that link back to your portfolio; and consistent use of your name across all platforms. This bidirectional verification is what Google uses to build Knowledge Panels.

How does portfolio schema affect AI discovery?

AI engines use Person schema to build professional profiles that inform hiring recommendations. When a client asks an AI for freelancer suggestions, structured data about your skills (knowsAbout), experience (CreativeWork with outcomes), and services (ProfessionalService) helps the AI recommend you with confidence.

Can Rankeo generate portfolio schema automatically?

Yes. Rankeo's Schema Generator creates a complete @graph with Person, CreativeWork, ProfessionalService, and WebSite schema tailored to your professional profile. It connects your entity across all schema types and validates sameAs cross-references for Knowledge Panel eligibility.