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
| Parameter | Description | Type | Example |
|---|---|---|---|
bgColor | Background color | Hex or RGBA color | rgba(255%2C0%2C0%2C1) |
bgTransparent | Transparent background | Boolean | true, false, 1, 0 |
borderRadius | Corner radius | Number 0-100 | 16 |
margin | Outer margin | Number 0-100 | 8 |
Motif Settings
| Parameter | Description | Type | Example |
|---|---|---|---|
type | Motif type | icon or text | icon |
icon | Lucide icon name | String | star, heart, code |
text | Text content (1-4 chars) | String | AB, GO |
iconColor | Icon/text color | Hex or RGBA color | rgba(255%2C255%2C255%2C1) |
padding | Inner padding | Number -100-100 | 4 |
rotation | Rotation angle | Number 0-360 | 45 |
Typography (for text type)
| Parameter | Description | Type | Example |
|---|---|---|---|
fontFamily | Google Font name | String | Roboto, Open%20Sans |
fontWeight | Font weight | Number 100-900 | 700 |
fontStyle | Font style | normal or italic | italic |
Effects
| Parameter | Description | Type | Example |
|---|---|---|---|
outlineEnabled | Enable outline | Boolean | true |
outlineColor | Outline color | Hex or RGBA color | rgba(0%2C0%2C0%2C1) |
outlineThickness | Outline thickness | Number 0-50 | 8 |
Type Inference
You don't always need to specify the type parameter:
- If you include
icon=star, the type is automatically set toicon - If you include
text=AB, the type is automatically set totext
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=20Black 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=2Error 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.