Message Variables Tab

Introduction #

Message Variables Tab in the Popup Box plugin allow you to add dynamic placeholders into your popups. Instead of writing static text, you can insert a variable (like %%user_name%%) and the system will automatically replace it with the correct value when the popup is displayed.

This feature is especially useful for:

• Personalization – Greet users by their name or reference their email address.
• Automation – Insert real-time information like popup titles, dates, or authors without manually updating content.
• Consistency – Ensure the same details are displayed across multiple popups without re-typing them.

You can use message variables inside:

• Custom Content
• Subscription Popups
• Subscribe and Get a File message content
• Popup Descriptions

---

How to Access Message Variables #

To navigate to the Message Variables section:

1. In your WordPress dashboard, go to Popup Box in the left-hand menu.
2. Click on General Settings.
3. Open the Message Variables tab.

Available Message Variables #

Here’s the full list of supported variables and what they do:

• %%user_name%% – Displays the user’s display name from their WordPress account.
• %%user_email%% – Displays the user’s email address (from registration).
• %%user_first_name%% – Displays the user’s first name.
• %%user_last_name%% – Displays the user’s last name.
• %%user_nickname%% – Displays the nickname set in the user’s WordPress profile.
• %%user_input_name%% – Displays the name entered into the User Data input field.

Popup & Author Information #

• %%current_popup_author%% – Displays the author of the current popup.
• %%current_popup_author_email%% – Displays the popup author’s email address.
• %%popup_title%% – Displays the title of the popup.
• %%current_popup_page_link%% – Prints the webpage link where the popup is shown.

Roles and Dates #

• %%user_wordpress_roles%% – Displays the user’s role(s). If the user is not logged in, this will be empty.
• %%creation_date%% – Displays the popup creation date.
• %%current_date%% – Displays the current date when the popup is opened.

---

Example Usage #

To use message variables, you need to insert them into the Popup Description field.

For example, paste this text into the Popup Description editor:

Hi %%user_first_name%%,  
Today is %%current_date%% and you’re viewing our latest offer!  

When displayed to a logged-in user, the variables will be replaced with real values.

If the user’s name is Monica and today’s date is September 4, 2025, the popup will look like this:

Hi Monica,
Today is September 4, 2025 and you’re viewing our latest offer!

---

Best Practices #

• Use personalization sparingly – overuse can feel repetitive.
• Always test variables to make sure they display correctly.
• Combine user details with popup details (e.g., %%user_name%% + %%popup_title%%) for tailored experiences.
• For public popups (seen by logged-out users), avoid relying only on variables that require login (like %%user_email%%).

---

Conclusion #

Message Variables make your popups smarter and more interactive by automatically pulling in live data. Whether you want to greet users by name, display popup details, or show the current date, these placeholders help you save time and create a personalized experience.

If you have any questions about using Message Variables, feel free to contact our support team via the Contact Form.