Custom Submission Messages

The Custom Submission Messages function allows you to customize the confirmation messages shown after users submit posts. Configure different messages for pending review, published posts, and pre-approved users.

Overview

Replace Voxel’s default submission messages with your own custom text. Different messages can be shown based on whether the post goes to pending review or is published immediately.

Key Features

• Custom messages per post type
• Different messages for different outcomes
• Pre-approved user message support
• Works with frontend AJAX submissions

Setup Instructions

Step 1: Enable the Function

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

Step 2: Configure Post Type Messages

1. Select a post type to configure
2. Enable custom messages for this post type
3. Enter your custom messages for each scenario
4. Click Save Changes

Message Types

Message Type	When Shown
Pending Review	Post submitted and waiting for admin approval
Published	Post published immediately (user can publish directly)
Pre-Approved	Post auto-published via Pre-Approve Posts function

Example Messages

Pending Review

Thank you for your submission! Our team will review your listing within 24 hours. You'll receive an email notification once it's approved.

Published

Congratulations! Your listing is now live. Share it with your audience and start receiving inquiries!

Pre-Approved

As a trusted member, your listing has been published immediately. Thank you for being part of our community!

Integration with Pre-Approve Posts

When used with the Pre-Approve Posts function:

• Pre-approved users see the “Pre-Approved” message
• Regular users see the “Pending Review” message
• Gives appropriate feedback based on actual post status

Use Cases

Brand Voice

Replace generic messages with text that matches your brand’s tone and voice.

Set Expectations

Tell users what to expect next (review timeframe, email notifications, etc.).

Multilingual Sites

While this function shows static messages, you can use it with translation plugins for different languages.

Troubleshooting

Messages Not Appearing

• Verify the function is enabled
• Check that messages are configured for the post type
• Ensure “Enable custom messages” is checked for the post type
• Clear browser cache and any site caching

Wrong Message Showing

• Check which status the post actually receives
• Verify Pre-Approve Posts settings if using that function
• The function detects the outcome and shows the appropriate message

Formatting Not Working

• Basic HTML is supported in messages
• Some CSS may be overridden by Voxel styles
• Keep formatting simple for best results