PHPackages                             humanmade/rename-images-command - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. humanmade/rename-images-command

ActiveWp-cli-package[Image & Media](/categories/media)

humanmade/rename-images-command
===============================

Image renaming command for WordPress

0.1.0(5y ago)3180.8k↑11.8%2GPL-2.0-or-laterPHP

Since Nov 26Pushed 5y ago18 watchersCompare

[ Source](https://github.com/humanmade/rename-images-command)[ Packagist](https://packagist.org/packages/humanmade/rename-images-command)[ RSS](/packages/humanmade-rename-images-command/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (2)

Rename Image Command
====================

[](#rename-image-command)

This is a WordPress CLI command package for renaming images that have dimensions as their suffix such as `-150x150.jpg`. This can cause some problems in WordPress when parsing content images and determining image sizes.

The original files will be left alone but a new renamed image and thumbnails will be created to avoid any potential broken links.

The command will also optionally perform a search & replace on the database however you should note that this can be very time consuming depending on the size of the database and the number of images to process.

This could take a few minutes per image so you should expect the command to take a few hours if you have 100s of images to rename.

Installing
----------

[](#installing)

This package can be installed as a regular WordPress plugin.

Using Composer:

```
composer require humanmade/rename-images-command

```

As a WP CLI Package:

```
wp package install humanmade/rename-images-command

```

Usage
-----

[](#usage)

```
wp media rename-images

```

### Options

[](#options)

`[--network]` Run the migration for all sites on the network.

`[--sites-page=]` If you have more than 100 sites you can process the next 100 by incrementing this.

`[--search-replace]` Whether to update the database.

`[--tables=]` A comma separated string of tables to search & replace on. Wildcards are supported. Defaults to `wp_*posts, wp_*postmeta`.

`[--include-columns=]` The database columns to search & replace on. Defaults to post\_content, post\_excerpt and meta\_value.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1999d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/77dbeefb7745010589603f2ffc6ff310d8f700b58e08d52af190744c43342526?d=identicon)[roborourke](/maintainers/roborourke)

---

Top Contributors

[![roborourke](https://avatars.githubusercontent.com/u/23417?v=4)](https://github.com/roborourke "roborourke (3 commits)")

### Embed Badge

![Health badge](/badges/humanmade-rename-images-command/health.svg)

```
[![Health](https://phpackages.com/badges/humanmade-rename-images-command/health.svg)](https://phpackages.com/packages/humanmade-rename-images-command)
```

###  Alternatives

[milon/barcode

Barcode generator like Qr Code, PDF417, C39, C39+, C39E, C39E+, C93, S25, S25+, I25, I25+, C128, C128A, C128B, C128C, 2-Digits UPC-Based Extention, 5-Digits UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI (Variation of Plessey code)

1.5k13.3M39](/packages/milon-barcode)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k23](/packages/bkwld-croppa)[goat1000/svggraph

Generates SVG graphs

132849.6k3](/packages/goat1000-svggraph)[cohensive/embed

Media Embed (for Laravel or as a standalone).

120370.4k](/packages/cohensive-embed)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)[humanmade/tachyon-plugin

Rewrites WordPress image URLs to use Tachyon

87338.5k2](/packages/humanmade-tachyon-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)