Back to Documentation

Embeds

Share your proof cards and profile with embeddable badges and codes.

Card Embeds

Every proof card has embeddable assets for sharing.

Card Badge

A small SVG badge showing your card's verification status.

URL: /api/badge/[card-id]

Markdown (for GitHub READMEs):

[![ProofFabric](https://prooffabric.com/api/badge/[card-id])](https://prooffabric.com/proof/[card-id])

HTML:

<a href="https://prooffabric.com/proof/[card-id]">
  <img src="https://prooffabric.com/api/badge/[card-id]" alt="ProofFabric">
</a>

Card Image

A larger PNG image (800x418) perfect for social sharing.

URL: /api/card/[card-id]

Badge Options

Customize badges with query parameters:

ParameterOptionsDefaultPro Only
styleminimal, status, fullstatusminimal, full
themelight, darklightdark
nametrue, falsefalseNo

Example:

/api/badge/[card-id]?style=full&theme=dark

Profile Embeds

Profile Badge

Show off your ProofFabric profile.

URL: /api/profile/[username]/badge

Markdown:

[![ProofFabric Profile](https://prooffabric.com/api/profile/[username]/badge)](https://prooffabric.com/[username])

Profile Image

A preview image showing your top 3 cards.

URL: /api/profile/[username]

Getting Embed Codes

  1. Open any proof card
  2. Click Share
  3. Copy the embed code you need:
    • Badge (Markdown)
    • Badge (HTML)
    • Direct link

Free vs Pro Embeds

FeatureFreePro
Basic badge (light, status)YesYes
Dark themeNoYes
Minimal styleNoYes
Full styleNoYes
Profile badgeYesYes

Use Cases

GitHub README

Add a badge to your project's README to show verified ownership:

## Verified on ProofFabric

[![Verified](https://prooffabric.com/api/badge/abc123)](https://prooffabric.com/proof/abc123)

Personal Website

Embed your profile or top cards on your portfolio site.

LinkedIn

Share a Post

Click the LinkedIn button on any proof card to share it as a post with a rich preview.

Add to Featured Section (Recommended)

Add your proof to LinkedIn's Featured section for permanent visibility on your profile.

Steps:

  1. Copy your proof link (from the card page or your profile)
  2. Go to your LinkedIn profile
  3. Click "Add profile section""Featured"
  4. Click "+""Add a link"
  5. Paste your ProofFabric URL
  6. LinkedIn will auto-generate a preview card

Which link to use:

LinkBest For
prooffabric.com/[username]Show all your verified work
prooffabric.com/proof/[card-id]Highlight one project

Pro tip: Add your best-verified card (most badges) as the first Featured item. It's the first thing recruiters and clients see.

Twitter/X

Tweet your proof card URL for a visual card preview.

Troubleshooting

Badge not loading?

  1. Check the card ID is correct
  2. Ensure the card is public
  3. Try clearing your browser cache

Wrong information showing?

Badges are cached for performance. Updates may take up to 15 minutes to appear.