Load from URL

Favycons can load a full icon configuration from a single query parameter, iconconfig:

https://app.favycons.com/?iconconfig=<base64url-json>

The value is base64url(utf8(JSON.stringify(iconSettings))) — same shape and schema as the export pipeline (includes schemaVersion). After a valid iconconfig loads, Favycons strips it from the URL; the design lives in the local session.

Shareable Links

Shareable Links are not currently shown in the app. iconconfig remains supported for programmatic links and integrations.

Custom SVG assets are not included in shareable URLs. If a custom SVG motif is encoded for sharing, Favycons strips the uploaded SVG data and falls back to a built-in icon motif so the link stays private and short enough for browsers.

Generate a link programmatically

function encodeIconConfig(iconSettings) {
  const json = JSON.stringify(iconSettings);
  const bytes = new TextEncoder().encode(json);
  let binary = '';
  for (const b of bytes) binary += String.fromCharCode(b);
  return btoa(binary)
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/g, '');
}

const url = `https://app.favycons.com/?iconconfig=${encodeIconConfig(iconSettings)}`;

Errors and limits

• Invalid iconconfig (decode / JSON / schema): editor loads defaults and shows a warning banner.
• Legacy per-field params (icon=, bgColor=, …) are no longer supported — same fallback.
• Custom SVG Upload assets stay in your editor and saved designs; they are stripped from generated URLs.
• Very large configs may hit URL length limits in some clients.

Related

• Saving & Accounts — persist designs beyond the browser session
• Troubleshooting — when a link loads defaults unexpectedly