Media Paste

The Media Paste function allows you to paste images directly from your clipboard into the WordPress Media Library. Simply copy an image and paste it anywhere in the admin – no need to save and upload files manually.

Overview

Speed up your workflow by pasting screenshots, copied images, or any clipboard images directly into WordPress. The image is automatically uploaded to your Media Library and ready to use.

Key Features

• Paste images directly from clipboard
• Automatic upload to Media Library
• Supports JPEG, PNG, GIF, and WebP
• Role-based permissions
• Works on post edit screens and media pages
• Visual feedback during upload

Setup Instructions

Step 1: Enable the Function

1. Navigate to Voxel Toolkit → Functions in your WordPress admin
2. Find Media Paste in the list
3. Toggle the switch to enable the function
4. Click Save Changes

Step 2: Configure Allowed Roles (Optional)

By default, administrators and editors can paste images. Configure additional roles:

1. In the Allowed Roles section, select which roles can use media paste
2. Options include: Administrator, Editor, Author, Contributor, or All Roles
3. Click Save Changes

How to Use

Pasting Images

1. Copy an image to your clipboard:

• Take a screenshot (Print Screen, Cmd+Shift+4, etc.)
• Right-click an image and select “Copy Image”
• Copy from any image editing software

2. Go to any supported admin page (post edit, media library)
3. Press Ctrl+V (Windows) or Cmd+V (Mac)
4. Watch the upload progress indicator
5. Image appears in your Media Library

Supported Admin Pages

• Post/Page edit screens (post.php, post-new.php)
• Media Library (upload.php)
• Media upload popup (media-upload.php)
• General admin pages (admin.php)

Supported Image Types

Format	MIME Type	Supported
JPEG	image/jpeg	Yes
PNG	image/png	Yes
GIF	image/gif	Yes
WebP	image/webp	Yes

File Handling

Automatic Naming

Pasted images are automatically named with a timestamp:

pasted-image-1704067200.png

Size Limits

Image size is limited by your WordPress upload settings. Check Settings → Media for maximum upload size.

Storage Location

Pasted images are stored in the standard WordPress uploads directory, organized by year/month like normal uploads.

Use Cases

Screenshots for Documentation

Take a screenshot and paste it directly when writing tutorials or documentation.

Quick Image Sharing

Copy images from other websites or applications and paste directly into posts.

Bug Reports

Quickly capture and upload screenshots when documenting issues.

Troubleshooting

Paste Not Working

• Ensure the function is enabled
• Verify your user role is allowed to paste
• Check that you have an image (not text) in your clipboard
• Try on a supported admin page
• Check browser console for JavaScript errors

Upload Fails

• Check if image exceeds maximum upload size
• Verify the image type is supported (JPEG, PNG, GIF, WebP)
• Ensure your uploads directory is writable
• Check for disk space availability

Image Quality Issues

Pasted images maintain their original quality. If images appear low quality:

• Check the source image quality
• Screenshots may have different quality based on your screen settings
• Some applications compress images when copying