Favycons Docs

URL Parameters

Share icon designs using URL query parameters for deterministic, shareable favicon configurations.

URL Parameters

Favycons supports URL search parameters to prepopulate favicon settings. This enables you to share specific icon designs via URL - the same URL will always produce the same icon.

Basic Usage

Add parameters to the Favycons URL to load a specific design:

https://favycons.com/?icon=star&bgColor=rgba(255%2C0%2C0%2C1)

This loads the editor with a red background and the "star" icon.

Supported Parameters

Background Settings

ParameterDescriptionTypeExample
bgColorBackground colorHex or RGBA colorrgba(255%2C0%2C0%2C1)
bgTransparentTransparent backgroundBooleantrue, false, 1, 0
borderRadiusCorner radiusNumber 0-10016
marginOuter marginNumber 0-1008

Motif Settings

ParameterDescriptionTypeExample
typeMotif typeicon or texticon
iconLucide icon nameStringstar, heart, code
textText content (1-4 chars)StringAB, GO
iconColorIcon/text colorHex or RGBA colorrgba(255%2C255%2C255%2C1)
paddingInner paddingNumber -100-1004
rotationRotation angleNumber 0-36045

Typography (for text type)

ParameterDescriptionTypeExample
fontFamilyGoogle Font nameStringRoboto, Open%20Sans
fontWeightFont weightNumber 100-900700
fontStyleFont stylenormal or italicitalic

Effects

ParameterDescriptionTypeExample
outlineEnabledEnable outlineBooleantrue
outlineColorOutline colorHex or RGBA colorrgba(0%2C0%2C0%2C1)
outlineThicknessOutline thicknessNumber 0-508

Type Inference

You don't always need to specify the type parameter:

  • If you include icon=star, the type is automatically set to icon
  • If you include text=AB, the type is automatically set to text

URL Encoding

Remember to URL-encode special characters:

  • Commas in rgba(...) should be URL-encoded as %2C
  • Spaces become %20 (for font names like "Open Sans")

Legacy hex colors are still accepted in shared URLs for backward compatibility.

Examples

Icon with custom colors

/?icon=heart&bgColor=rgba(0%2C0%2C0%2C1)&iconColor=rgba(255%2C0%2C0%2C1)&borderRadius=20

Black background, red heart icon, rounded corners.

Text badge

/?text=GO&fontFamily=Roboto&fontWeight=700&bgColor=rgba(34%2C197%2C94%2C1)&iconColor=rgba(255%2C255%2C255%2C1)

Green badge with bold white "GO" text.

Transparent icon

/?icon=code&bgTransparent=true&iconColor=rgba(0%2C0%2C0%2C1)

Transparent background with black code icon.

Full configuration

/?type=icon&icon=star&bgColor=rgba(0%2C0%2C0%2C1)&iconColor=rgba(255%2C215%2C0%2C1)&borderRadius=16&margin=8&padding=4&rotation=15&outlineEnabled=true&outlineColor=rgba(255%2C255%2C255%2C1)&outlineThickness=2

Error Handling

Invalid parameters display a warning banner but don't break the editor:

  • Unknown parameters are ignored with a warning
  • Invalid values (wrong format, out of range) are skipped
  • Valid parameters are still applied

This graceful degradation ensures shared URLs work even if some parameters are invalid.

Limitations

Currently, advanced features are not supported via URL parameters:

  • Gradients
  • Shadows
  • Glow effects
  • Custom stroke settings

These may be added in future updates.

On this page