Skip to main content

Brand extraction

When you create a project from a URL, Docsio reads your site's actual CSS and HTML to extract your brand. No upload, no configuration, your docs match your existing brand within the first thirty seconds of generation.

What gets extracted

  • Logo. From your <header> element or your og:image meta tag, whichever has higher fidelity.
  • Favicon. Your <link rel="icon"> or fallback to /favicon.ico.
  • Primary color. The dominant accent color used by buttons and links on your site, sampled from CSS variables and computed styles.
  • Fonts. Detected from <link> tags and font-family declarations. Google Fonts and Adobe Fonts both supported.
  • Color scheme. Light or dark default, based on your site's <html> background.

When extraction works well

  • Your site has a clean CSS variable system (most modern sites built with Tailwind, Vercel, Next.js, Stripe, Linear, etc.)
  • Logo is exposed as an <img> or <svg> in your nav
  • Fonts are loaded the standard way

In those cases, your docs site looks visually like a sibling of your main site within minutes.

When it gets it slightly wrong

A few common cases:

  • Sprite-based logo. Docsio falls back to your favicon. Update the logo manually in Branding → Logo and favicon.
  • No CSS variables, computed colors only. Docsio samples a primary color but it might be off. Adjust in Colors and fonts or just tell the agent: "Set primary color to #5B6CFF."
  • Custom font isn't loaded. Docsio falls back to a clean default sans (DM Sans). To use your real font, see Custom CSS.

When you don't want extraction

If you're starting from files (not a URL), brand extraction doesn't run. You can still set everything manually, same surfaces, same edits.

If extraction grabbed a wrong logo (e.g. a placeholder image), the agent can fix it in one message:

"Use the logo from https://acme.com/logo-mark.svg and a primary color of #5B6CFF."

Refreshing brand later

If your main site rebrands, you don't need to recreate your docs. Open settings → Re-extract brand from URL. Docsio re-runs extraction against the URL you originally provided (or a new one) and updates your docs theme without touching content.

Manual override

Brand extraction sets defaults. Anything you change manually wins, re-extracting brand later won't overwrite settings you've explicitly set.