- Compatibile XF2 versions
- 2.3
Rename, edit, and replace XenForo attachments while keeping existing attachment references and content associations.
Attachment Editor provides tools for managing attachment filenames, images, and underlying files directly from content pages and the Admin Control Panel. It supports individual and batch renaming, image editing, ALT text updates, file replacement, and XenForo Media Gallery media replacement while preserving existing content associations.
Features:
Attachment Renaming:
Rename Attachments: Change attachment filenames after upload without creating a new attachment or changing its existing link.
Content Page Renaming: Rename supported attachments directly from the content where they are used.
ACP Attachment Renaming: Rename files from the XenForo attachment browser in the Admin Control Panel.
Rename Permissions: Independently control who can rename their own attachments or any attachment.
Flexible Rename Action: Display the rename action beside attachment controls or in the file information row.
ALT Text Updates: Automatically update inserted attachment ALT text when a file is renamed, with an option to preserve manually customized ALT text.
Media Title Updates: Optionally update the associated XenForo Media Gallery item title when its attachment is renamed.
Batch Attachment Renaming:
Batch Rename Tool: Rename multiple existing attachments from a single ACP tool.
Filename Placeholders: Build consistent attachment filenames using configurable placeholders.
Find and Replace: Replace text within filenames as part of a batch rename operation.
Content Type Filtering: Limit batch operations to selected attachment content types.
Upload Date Filters: Target attachments uploaded within a selected date range.
Uploader Filter: Rename attachments uploaded by a specific member.
File Extension Filter: Limit processing to selected attachment file extensions.
Attachment ID Range: Process only attachments within a specified ID range.
Image Editing:
Built-In Image Editor: Edit JPEG, PNG, and WebP attachments directly from the attachment rename interface.
Rotate & Flip: Rotate images or flip them horizontally and vertically.
Crop Images: Crop attachments before saving the edited version.
Resize Images: Change image dimensions directly from the editor.
Color Adjustments: Adjust supported image properties and preview visual changes before applying them.
Image Filters: Preview and apply available image filters.
Undo Changes: Reverse image editing operations before saving.
Export Edited Images: Export the edited result when needed.
Attachment Replacement:
Replace Attachment Files: Replace the underlying file while preserving the existing attachment record and content association.
Preserve Attachment Links: Update attachment content without changing links already used throughout the forum.
Preserve Content Associations: Keep the replacement attached to the same post, resource update, media item, or other supported content.
XFMG Media Replacement: Replace XenForo Media Gallery images, videos, and audio while retaining the existing media item.
Native XFMG Processing: Use XenForo Media Gallery validation, quotas, thumbnails, watermarks, and transcoding workflows when replacing media.
Supported Content Types:
XenForo Posts: Rename, edit, or replace supported post attachments.
XenForo Resource Manager: Manage attachments used by resource updates.
XenForo Media Gallery: Rename or replace images, videos, and audio while preserving the associated media item.
Requirements:
XenForo 2.3.0+
[XB] Core Library 1.0.0+
Useful for:
Attachment Renaming: Correct unclear, incorrect, or automatically generated filenames after upload.
Attachment Replacement: Replace outdated or incorrect files without changing existing attachment URLs.
Image Editing: Crop, resize, rotate, adjust, or otherwise correct uploaded images without downloading and re-uploading them manually.
Image SEO & Accessibility: Keep attachment filenames and inserted ALT text descriptive and consistent.
Attachment Organization: Standardize filenames across existing XenForo content.
Bulk Attachment Management: Rename large numbers of existing files using filters and filename patterns.
Media Gallery Management: Replace XFMG images, videos, or audio without recreating the media item.
Content Maintenance: Update files while preserving their existing content associations and links.
FAQ:
Does permission to rename attachments also allow file replacement?
Image editing and file replacement also require permission to manage attachments in the associated content. Batch renaming has a separate administrator permission.
Do replacement files still have upload restrictions?
Yes. Replacements are checked against the applicable file type, size, and image dimension limits. Media Gallery replacements also use its media validation and quota checks.
Why is there no separate Replace file section for some images?
When the image editor is available, use its Replace image control. The separate file replacement section is shown for attachments without that editor, where replacement is permitted.
Are Media Gallery replacements always available immediately?
Media that requires transcoding is processed in the background. Further changes are blocked while a replacement is pending.
Screenshots:
Attachment Controls:
Open the attachment editor directly from the attachment controls while editing a post. |
Image Editor:
See the attachment image editor in action. |
Rotate, flip, crop, and resize an image, change its filename, and choose how inserted ALT text is updated. |
Adjust brightness, contrast, saturation, and blur, or apply a quick filter with a live preview. |
Choose the output format and quality, download the edited image, or save it to the existing attachment. |
Permissions:
Configure separate permissions for renaming a member's own attachments and attachments uploaded by others. |