Favicon & PWA Generator — Apify Actor

What does it do?

Favicon & PWA Generator creates favicons and Progressive Web App asset packages from uploaded images or plain text. It outputs multi-size PNGs, bundled ICO files, scalable SVG vectors, and complete PWA manifests with icon sets — all via a single API call.

Whether you need a quick F favicon for your dev site, a full set of 48×48 to 512×512 PWA icons for your progressive web app, or a batch of branded favicons from a CSV list, this actor delivers production-ready files with public download URLs.

Who is it for?

Persona	What they use it for
Web Developer	Generating favicon sets (16–128px PNG + ICO + SVG) from logos
PWA Engineer	Creating complete manifest.json + icon packages for progressive web apps
CI/CD Pipeline	Integrating favicon generation into automated build workflows
Designer	Producing consistent branded favicons from text or uploaded assets
Product Manager	Bulk-generating favicons from a CSV of app names for multiple projects
Site Owner	Making a quick text-based favicon for a personal or staging site

Why use this?

• 4 modes in one actor — image→favicon, text→favicon, full PWA package, or batch generation. One API endpoint for all your favicon needs.
• Multi-format output — get PNGs at every standard size (16×16, 32×32, 48×48, 64×64, 128×128), bundled ICO (16+32+48), and SVG vector — all from the same input.
• API-first design — provide an image URL or base64 data, get back public download URLs. Perfect for build pipelines, CI/CD, and headless workflows.
• Custom colors and styling — set background and foreground hex colors, adjust border radius, control file prefixes.
• PWA-ready — generate a complete asset package with all required icon sizes and a spec-compliant manifest.json.
• Batch processing — pass a CSV or JSON array and generate 50 favicons in one run.

Input

Field	Type	Default	Description
mode	select	generate-from-image	Operation mode. See mode details below.
imageData	string	—	Base64-encoded image data (alternative to imageUrl)
imageUrl	string	—	URL to download source image
text	string	F	Text to render on the favicon (text mode)
backgroundColor	string	#333333	Hex background color
foregroundColor	string	#FFFFFF	Hex text/foreground color
borderRadius	int	16	Rounded corner radius (px)
outputFormats	array	["png", "ico"]	Formats to generate: png, ico, svg
filePrefix	string	favicon	Prefix for generated file names
appName	string	My PWA App	App name for PWA manifest
shortName	string	—	Short name for manifest (falls back to appName)
description	string	—	Description for manifest
themeColor	string	#FFFFFF	Theme color for manifest
display	select	standalone	PWA display mode
scope	string	/	PWA navigation scope
startUrl	string	/	PWA start URL
batch	array/string	—	Batch items array or CSV/JSON string

Modes

Mode	Description	Required Fields
generate-from-image	Upload image → multi-size PNG/ICO/SVG favicons	imageData or imageUrl
generate-from-text	Text → styled favicon with custom colors	text
generate-pwa	Complete PWA asset package (icons + manifest.json)	imageData/imageUrl, or falls back to text from appName
batch-generate	Generate favicons from multiple items	batch (array or CSV/JSON)

Output

Each generated file produces one dataset item with:

Field	Type	Description
fileName	string	File name in key-value store
format	string	File format (png, ico, svg, json)
size	int	Image size in pixels (0 for ICO/multi-size)
sizeBytes	int	File size in bytes
sizeHuman	string	Human-readable size
downloadUrl	string	Public download URL
iconSizes	string	Included icon sizes (ICO only)
batchIndex	int	Index in batch (batch mode only)
label	string	Item label (batch mode only)
_packageSummary	object	PWA package summary (first item only, PWA mode)

Key-Value Store

Generated files are stored in the default key-value store with public URLs accessible for download. File key patterns:

• favicon-{size}x{size}.png — Multi-size PNG favicons
• favicon.ico — Bundled ICO (16×16, 32×32, 48×48)
• favicon.svg — SVG vector wrapper
• icon-{size}x{size}.png — PWA icons
• manifest.json — Web app manifest

Examples

Generate a text favicon

{
  "mode": "generate-from-text",
  "text": "F",
  "backgroundColor": "#4A90D9",
  "foregroundColor": "#FFFFFF",
  "outputFormats": ["png", "ico", "svg"],
  "borderRadius": 32
}

Generate PWA assets from an image URL

{
  "mode": "generate-pwa",
  "imageUrl": "https://example.com/logo.png",
  "appName": "My Awesome App",
  "themeColor": "#4A90D9",
  "backgroundColor": "#FFFFFF",
  "borderRadius": 24
}

Batch generate from CSV

text,backgroundColor,foregroundColor,format
F,#4A90D9,#FFFFFF,png
|A,#E74C3C,#FFFFFF,ico
|M,#2ECC71,#FFFFFF,svg
|X,#9B59B6,#EEEEEE,png

## FAQ

### What image formats are supported for input?

You can provide images as a **URL** (JPEG, PNG, GIF, WebP, SVG) or as **Base64-encoded data** (same formats). The actor automatically detects and decodes the input to generate favicon outputs.

### Can I generate a favicon from text without uploading an image?

Yes. Set `mode: "generate-from-text"` and provide a `text` value (e.g. `"F"`, `"AC"`, `"MyLogo"`). The actor renders the text on a colored background using your chosen `backgroundColor`, `foregroundColor`, and `borderRadius`.

### Does this actor generate PWA icons?

Yes. Set `mode: "generate-pwa"` and provide an image or text input. The actor produces a complete PWA asset package including all required icon sizes (48×48, 72×72, 96×96, 128×128, 144×144, 152×152, 192×192, 384×384, 512×512) and a spec-compliant `manifest.json`.

### What favicon sizes are produced?

| Format | Sizes |
|--------|-------|
| PNG | 16×16, 32×32, 48×48, 64×64, 128×128 |
| ICO | Bundled 16×16 + 32×32 + 48×48 |
| SVG | Scalable vector (any size) |
| PWA PNGs | 48×48 through 512×512 (9 sizes) |

### Can I get SVG output?

Yes. Add `"svg"` to the `outputFormats` array. The actor generates a standalone SVG file that wraps the favicon as a scalable vector — perfect for use in modern browsers and design tools.

### What is the batch CSV format?

Each row specifies a batch item. Example header row:

text,backgroundColor,foregroundColor,format,label

- `text` — the text to render on the favicon
- `backgroundColor` — hex background color (e.g. `#4A90D9`)
- `foregroundColor` — hex text color (e.g. `#FFFFFF`)
- `format` — output format (`png`, `ico`, `svg`)
- `label` — (optional) friendly name for identification in results

You can also pass a JSON array directly if you prefer.

### Where are generated files stored?

Files are saved to the **default key-value store** (KVS) of your actor run. They remain accessible via public download URLs as long as the KVS store exists.

### Do the download URLs expire?

Public download URLs are valid for the lifetime of the key-value store. Actor-run KVS stores persist for a limited time after the run completes (typically days, depending on Apify store retention policy). For permanent hosting, download and serve the files from your own storage.

### Is an Apify API token required?

Yes — for API/programmatic access you need an [Apify API token](https://console.apify.com/account/integrations). The token is passed via the `Authorization: Bearer` header or the `token` query parameter.

### Can I use this in CI/CD pipelines?

Absolutely. The actor is designed for headless automation. Pass input as JSON via the Apify API, get back public download URLs, and integrate into any build pipeline (GitHub Actions, GitLab CI, Jenkins, etc.).

### Does this work with static site generators (Jekyll, Hugo, Astro, Next.js)?

Yes. Generate your favicon and PWA assets programmatically during the build step and reference the downloaded files in your site config.

## MCP Integration

Connect this actor to MCP (Model Context Protocol) clients via the Apify MCP server:

```json
{
  "mcpServers": {
    "apify": {
      "type": "oauth",
      "command": "npx",
      "args": [
        "-y",
        "@apify/mcp-server"
      ],
      "env": {
        "APIFY_TOKEN": "<your-api-token>"
      }
    }
  }
}

Once connected, your MCP client can discover and invoke the Favicon & PWA Generator actor directly. Supported operations include running the actor with any mode (image, text, PWA, batch) and retrieving generated file download URLs from the run output.

SEO Keywords

favicon generator, PWA icon generator, favicon from text, multi-size favicon, ICO converter, SVG favicon, progressive web app assets, manifest generator, favicon API, batch favicon generator, Apify favicon actor, web app manifest generator

Related Tools

• Favicon Downloader & Converter — Download and convert favicons from any website
• OG Preview Generator — Generate Open Graph preview images for social sharing
• Website Screenshot Generator — Take full-page screenshots of any URL
• Image Metadata Analyzer — Extract metadata from images including EXIF, XMP, and IPTC
• All perryay actors — Browse the full collection of developer tools