---
id: "e06d58a0-0492-4ca1-92be-3f285051e9f9"
type: "Software product"
name: "Imgbot"
slug: "imgbot"
canonical: "https://groundingwiki.com/en/products/imgbot/"
markdown: "https://groundingwiki.com/en/products/imgbot/index.md"
language: en
same_as:
  - "https://imgbot.net/"
---

# Imgbot

Imgbot is a GitHub application that compresses images in repositories and submits the optimized changes for review through pull requests. [1]

## Core facts

- **Entity type:** Software product

- **Official website:** [imgbot.net](https://imgbot.net/) — [2] first-party, checked 24 Sept 2026

- **Free trial:** 14 days — [1] first-party, checked 3 Oct 2026

- **Supported platforms:** GitHub repositories — [1] first-party, checked 3 Oct 2026

## What is Imgbot?

Imgbot scans repository image files, applies image-compression routines and opens a pull request containing the changes. Its documentation says lossless compression is the default, preserving image dimensions and quality, while an optional aggressive mode enables lossy compression. Repository maintainers can configure schedules, ignored paths and compression thresholds. The project publishes its implementation and documentation in the imgbot/Imgbot GitHub repository. — [3] first-party, checked 3 Oct 2026

## Features and capabilities

### Image optimization — [3] first-party, checked 3 Oct 2026; [4] first-party, checked 3 Oct 2026

- Lossless image compression

- Lossy image compression

- Pull-request delivery

- Scheduled optimization

- File and path exclusions

### Additional capabilities — [3] first-party, checked 3 Oct 2026

- Compression Summaries

- Signed Commits

- Public And Private Repositories

- Free For Open Source

## Pricing

[1] first-party, checked 3 Oct 2026

- **Agency:** $79 — per month

- **Enterprise:** $199 — per month

- **Gold:** $399 — per month

- **Platinum:** $799 — per month

- **Open Source:** Free — free plan

Pricing checked 2 Oct 2026. Prices are high-volatility facts and may change.

## Integrations

### GitHub — [1] first-party, checked 3 Oct 2026

- **integrates with:** [GitHub](https://groundingwiki.com/en/organizations/github/index.md)

## Products

- **Compression Report:** Before-and-after file sizes are recorded and summarized in the optimization commit message. — [3] first-party, checked 3 Oct 2026

- **Configuration File:** Repository-level \`.imgbotconfig\` supports schedules, ignored file patterns, optional aggressive compression, wiki compression, minimum-reduction thresholds and pull-request text settings. — [4] first-party, checked 3 Oct 2026

- **Custom Pull Request Templates:** Paid plans can customize pull-request titles and bodies, including placeholders for overall optimization ratio and per-file details. — [4] first-party, checked 3 Oct 2026

- **Image Discovery:** The service recursively searches repository files by known image extensions and applies configured ignored-file patterns. — [3] first-party, checked 3 Oct 2026

- **Independent Usage Example 2020:** In a 2020 walkthrough, developer Dave Brock reported about 18% image-size savings in one personal repository run; this is one dated example, not a general performance guarantee. — [5] independent, checked 3 Oct 2026

- **Marketplace Publisher Verification:** GitHub Marketplace marks the publisher as verified, stating that GitHub checked publisher identity, domain ownership and applicable requirements; this is a publisher verification status, not a guarantee about product performance. — [1] first-party, checked 3 Oct 2026

- **Minimum Reduction Threshold:** The \`minKBReduced\` setting can suppress pull requests below a selected savings threshold; the repository README documents a default of 10 KB. — [4] first-party, checked 3 Oct 2026

- **Source License:** The public imgbot/Imgbot source repository is distributed under the MIT License; this describes the repository code, not necessarily the hosted GitHub app service. — [4] first-party, checked 3 Oct 2026

- **Wiki Repository Optimization:** An optional setting can include a repository wiki; the documentation says wiki image updates go directly to the wiki default branch because GitHub wikis do not support branch-based pull requests. — [3] first-party, checked 3 Oct 2026

## Operating model

- **Cloud Runtime:** Azure Functions serverless stack — [3] first-party, checked 3 Oct 2026

- **Git Tooling:** The documented implementation uses LibGit2Sharp for Git operations and Octokit to create GitHub pull requests. — [3] first-party, checked 3 Oct 2026

- **Installation Tokens:** The documentation describes short-lived GitHub installation tokens \(about ten minutes\) for repository access, commits and pull requests, rather than storing a permanent user token. — [3] first-party, checked 3 Oct 2026

- **Pull Request Workflow:** The documented workflow clones a repository, creates an imgbot branch, runs image optimization, commits and pushes the changes, then opens a pull request for review. — [3] first-party, checked 3 Oct 2026

- **Queued Processing:** The documented service uses queue-triggered functions to route work, compress repository images and open pull requests. — [3] first-party, checked 3 Oct 2026

- **Webhook Triggers:** GitHub installation and push webhooks start service workflows; the documented push handler continues compression only when the pushed commit includes an image update. — [3] first-party, checked 3 Oct 2026

## Sources
1. [Imgbot · GitHub Marketplace](https://github.com/marketplace/imgbot)
   - Publisher: GitHub Marketplace
   - Type: first-party
   - Checked: 3 Oct 2026
   - Evidence:
     - Definition: "The GitHub Marketplace listing describes Imgbot as an application that optimizes images in GitHub repositories; its documented workflow submits resulting changes as a pull request."
     - Free trial: "The GitHub Marketplace listing offers a 14-day free trial."
     - Supported platforms: "The Marketplace listing presents Imgbot as a GitHub application, and the project documentation describes repository-based installation and pull-request workflows."
     - Pricing: "The GitHub Marketplace listing shows the Agency plan at $79 per month; its listing specifies three private repositories."
     - GitHub: "GitHub Marketplace lists Imgbot as a GitHub application, and the documented workflow operates on GitHub repositories and submits pull requests."
     - Marketplace Publisher Verification: "The Marketplace listing says GitHub verified publisher identity, domain ownership and compliance with its requirements; the wording does not assert a product security audit."
2. [Imgbot](https://imgbot.net/)
   - Publisher: Imgbot
   - Type: first-party
   - Checked: 24 Sept 2026
   - Evidence:
     - Official website: "The Imgbot website links to its documentation and the public implementation repository."
3. [Imgbot Documentation](https://imgbot.net/docs)
   - Publisher: Imgbot
   - Type: first-party
   - Checked: 3 Oct 2026
   - Evidence:
     - What is Imgbot?: "Imgbot documentation describes repository image scanning, lossless compression by default, optional lossy compression, pull-request delivery and configuration for schedules, ignored paths and reduction thresholds."
     - Image optimization: "The documentation says the default compression routine is lossless and preserves image dimensions and quality while reducing file size."
     - Additional capabilities: "The documentation says image-size reductions are measured and reported in the pull-request commit-message body."
     - Compression Report: "The project documentation says image sizes are measured before and after compression and the results are included in the commit-message body."
     - Image Discovery: "The docs describe recursive file discovery using known image extensions and parsing ignored files from imgbotconfig."
     - Wiki Repository Optimization: "The docs describe wiki compression as opt-in and explicitly distinguish its direct default-branch update from the product’s normal pull-request workflow."
     - Cloud Runtime: "Imgbot documentation identifies Azure Functions as the serverless stack for its service."
     - Git Tooling: "The service documentation identifies LibGit2Sharp for repository operations and Octokit for pull-request creation."
     - Installation Tokens: "The docs state that installation tokens expire after about ten minutes and are used for repository cloning, pushing and pull-request creation."
     - Pull Request Workflow: "The official documentation describes the compression workflow as repository clone, imgbot branch creation, optimization, commit/push and pull-request creation."
     - Queued Processing: "The docs identify queue triggers for routing, pull-request creation and image-compression jobs, alongside an HTTP entry trigger."
     - Webhook Triggers: "The documentation describes installation and push webhook events and limits push-triggered compression to commits containing an image update."
4. [imgbot/Imgbot repository and README](https://github.com/imgbot/Imgbot)
   - Publisher: ImgBot project
   - Type: first-party
   - Checked: 3 Oct 2026
   - Evidence:
     - Image optimization: "The project README describes opening a pull request with the optimized image files for maintainers to review and merge."
     - Configuration File: "The public project README documents these `.imgbotconfig` keys and their accepted values."
     - Custom Pull Request Templates: "The README marks prTitle and prBody as paid-plan settings and documents optimization-ratio and optimization-details placeholders."
     - Minimum Reduction Threshold: "The README states that minKBReduced accepts a numeric threshold, defaults to 10 KB and can reduce how frequently the app opens pull requests."
     - Source License: "GitHub identifies the public repository license as MIT; the claim is limited to the source repository and does not extend the license to hosted services."
5. [Compress Images in GitHub Using Imgbot](https://daveabrock.com/2020/04/23/compress-images-in-github-using-imgbot)
   - Publisher: Dave Brock
   - Type: independent
   - Checked: 3 Oct 2026
   - Evidence:
     - Independent Usage Example 2020: "The author’s 2020 article reports an approximately 18% reduction for his repository and notes some images had already been compressed."

HTML version: https://groundingwiki.com/en/products/imgbot/
Methodology: https://groundingwiki.com/methodology/
Source policy: https://groundingwiki.com/source-policy/
Corrections: https://groundingwiki.com/corrections/?entity=Imgbot
