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)3194.9k↓24.3%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 yesterday

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

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity44

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

2045d 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

[char0n/ffmpeg-php

PHP wrapper for FFmpeg application

495240.6k1](/packages/char0n-ffmpeg-php)[goat1000/svggraph

Generates SVG graphs

135911.1k3](/packages/goat1000-svggraph)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

16653.6k2](/packages/gravatarphp-gravatar)[rsoury/wp-imgix

Rewrites WordPress image URLs to use ImgIX

167.2k](/packages/rsoury-wp-imgix)

PHPackages © 2026

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