Title: Clear Media Title On Upload
Author: runthings.dev
Published: <strong>2026 年 1 月 27 日</strong>
Last modified: 2026 年 1 月 27 日

---

搜索插件

![](https://ps.w.org/runthings-empty-media-title/assets/banner-772x250.png?rev=3447837)

![](https://ps.w.org/runthings-empty-media-title/assets/icon-256x256.png?rev=3447837)

# Clear Media Title On Upload

 作者：[runthings.dev](https://profiles.wordpress.org/runthingsdev/)

[下载](https://downloads.wordpress.org/plugin/runthings-empty-media-title.2.0.1.zip)

 * [详情](https://cn.wordpress.org/plugins/runthings-empty-media-title/#description)
 * [评价](https://cn.wordpress.org/plugins/runthings-empty-media-title/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/runthings-empty-media-title/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/runthings-empty-media-title/#developers)

 [支持](https://wordpress.org/support/plugin/runthings-empty-media-title/)

## 描述

When you upload media to WordPress, the title field is automatically set to a slugified
version of the filename. This often results in messy, unoptimized titles like “IMG-
20240115-photo-final-v2” appearing in gallery captions, alt tags, or title attributes.

This plugin clears the title field for newly uploaded media, ensuring that if a 
title is displayed anywhere, it’s one you’ve intentionally set yourself.

#### Features

 * Automatically clears the title field for new media uploads
 * Bulk action to clear titles on existing media library items
 * Lightweight with no settings page required
 * Developer-friendly with filters

#### How It Works

The plugin hooks into WordPress’s `wp_insert_attachment_data` filter and clears 
the `post_title` field for new uploads before they are saved to the database.

### Filters

#### runthings_emt_skip

Skip clearing the title for specific attachments.

**Parameters:**

 * `$skip` (bool) – Whether to skip clearing the title. Default false.
 * `$data` (array) – Attachment post data (slashed, sanitized, processed).
 * `$postarr` (array) – Sanitized post data (not processed).
 * `$unsanitized_postarr` (array) – Unsanitized post data.
 * `$update` (bool) – Whether this is an update (always false for new uploads).

**Example:**

    ```
    // Skip clearing title for uploads by specific user
    add_filter('runthings_emt_skip', function($skip, $data, $postarr) {
        if (get_current_user_id() === 1) {
            return true; // Admin keeps auto-generated titles
        }
        return $skip;
    }, 10, 3);



    // Skip clearing title if filename contains "keep-title"
    add_filter('runthings_emt_skip', function($skip, $data, $postarr) {
        $filename = $postarr['post_title'] ?? '';
        if (strpos($filename, 'keep-title') !== false) {
            return true;
        }
        return $skip;
    }, 10, 3);
    ```

#### runthings_emt_mime_types

Filter which MIME types should have their title cleared. By default, all media types
are affected.

**Parameters:**

 * `$allowed_mime_types` (array) – Array of MIME type patterns. Default `[]` (all
   types).
 * `$attachment_mime_type` (string) – The attachment’s MIME type.
 * `$postarr` (array) – Sanitized post data.

**Example:**

    ```
    // Restrict to images only
    add_filter('runthings_emt_mime_types', function($allowed_mime_types) {
        return ['image'];
    });



    // Restrict to images and PDFs only
    add_filter('runthings_emt_mime_types', function($allowed_mime_types) {
        return ['image', 'application/pdf'];
    });
    ```

### Additional Notes

Built by Matthew Harris of runthings.dev, copyright 2022-2026.

Visit [runthings.dev](https://runthings.dev/) for more WordPress plugins and resources.

Contribute or report issues at the [GitHub repository](https://github.com/runthings-dev/runthings-empty-media-title).

Insert space by Xinh Studio from Noun Project, https://thenounproject.com/browse/
icons/term/insert-space/ (CC BY 3.0) – https://thenounproject.com/icon/insert-space-
239543/

Image by David Khai from Noun Project, https://thenounproject.com/browse/icons/term/
image/ (CC BY 3.0) – https://thenounproject.com/icon/image-661355/

## 屏幕截图

 * [[
 * Before: Image uploaded with auto-generated slugified title. After: Image uploaded
   with empty title field.

## 安装

 1. Upload the plugin files to the `/wp-content/plugins/runthings-empty-media-title`
    directory, or install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress.
 3. That’s it! New media uploads will now have an empty title field.

## 常见问题

### Does this affect existing media in my library?

New uploads are cleared automatically. For existing media, you can use the bulk 
action in the Media Library to clear titles on selected items.

### Can I restrict this to certain file types?

Yes! Use the `runthings_emt_mime_types` filter to limit which MIME types are affected.
See the Filters section below.

### Can I exclude certain uploads from having their title cleared?

Yes! Use the `runthings_emt_skip` filter to conditionally skip clearing the title.
See the Filters section below.

### Why would I want an empty title?

Many themes and plugins display the media title in various places – gallery captions,
lightbox overlays, or HTML title attributes. An auto-generated slugified filename
like “DSC-0042-final-edit” looks unprofessional. With an empty title, you’re in 
control of what gets displayed.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Clear Media Title On Upload」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ runthings.dev ](https://profiles.wordpress.org/runthingsdev/)

[帮助将「Clear Media Title On Upload」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/runthings-empty-media-title)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/runthings-empty-media-title/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/runthings-empty-media-title/)，或
通过[RSS](https://plugins.trac.wordpress.org/log/runthings-empty-media-title/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/runthings-empty-media-title/)。

## 更新日志

#### 2.0.1 – 23rd January 2026

 * Improved bulk action messages
 * Add confirmation prompt to bulk edit list view
 * Fixed nonce verification in bulk action processing

#### 2.0.0 – 23rd January 2026

 * Complete plugin refactor with namespaced class structure
 * Added bulk action “Clear media title” to clear titles on existing media items
 * Changed default from `['image']` to `[]` (all media types)
 * Added `runthings_emt_skip` filter for developer customization
 * Added `runthings_emt_mime_types` filter to extend beyond images

#### 1.0.0 – 6th January 2022

 * Initial release

## 额外信息

 *  版本 **2.0.1**
 *  最后更新：**4 月前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 6.0 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/runthings-empty-media-title/)
 * 标签
 * [attachment](https://cn.wordpress.org/plugins/tags/attachment/)[images](https://cn.wordpress.org/plugins/tags/images/)
   [media](https://cn.wordpress.org/plugins/tags/media/)[title](https://cn.wordpress.org/plugins/tags/title/)
   [upload](https://cn.wordpress.org/plugins/tags/upload/)
 *  [高级视图](https://cn.wordpress.org/plugins/runthings-empty-media-title/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/runthings-empty-media-title/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/runthings-empty-media-title/reviews/)

## 贡献者

 *   [ runthings.dev ](https://profiles.wordpress.org/runthingsdev/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/runthings-empty-media-title/)