Milestone Actions
MediaShield overviewFree + ProGet MediaShield →
PRO - requires MediaShield Pro. Free records the milestones. Pro adds the actions.
Send an email, call a web address (webhook) or record a note on the student’s profile when a viewer reaches 25, 50, 75 or 100 percent of a video.
Why use it
Section titled “Why use it”Follow-ups happen without you: a thank-you email at 100 percent, a note on the profile, or a call to your CRM or automation tool such as Zapier or Make. Viewers who reach a point get a response while it is fresh.
Before you start
Section titled “Before you start”- Viewers must be logged in. Milestones never fire for guests.
- Milestones fire once per viewer per video, for good. Rewatching does not fire them again.
- The video’s protection level must be Standard or Strict so a watch session is recorded.
- Email actions use WordPress mail. Make sure your site can send email.
Set up an action
Section titled “Set up an action”- Go to MediaShield > Milestone Actions.
- Each milestone has a card: 25%, 50%, 75% and 100%. Switch on the ones you want (Enabled or Disabled).
- Choose the Action Type (below).
- Fill in the details for that type.
- Click Save Milestone Actions. “Milestone actions saved.” confirms it.
- Click Test Fire on a card to try that action once against your own account.
Each milestone carries one action. Actions apply to every video. There is no per-video setting. For a different result on one course, use a webhook and decide at the receiving end by video_id.
The three action types
Section titled “The three action types”| Action | What it does | Details you enter |
|---|---|---|
| Tag User | Saves the completion time on the viewer’s WordPress profile as a hidden field named ms_completed_{video_id}_{percentage}. It does not assign a role, term or CRM tag |
None |
| Send Email | Sends one email | Recipient: Admin (your site admin address) or User (the viewer). Email Subject, Email Message |
| Fire Webhook | Sends a JSON POST to your web address | Webhook URL |
Email details:
- You can use the placeholders
{user_name},{video_title},{percentage}and{user_email}. - You write the email in the Email Subject and Email Message fields.
- You cannot pick another recipient address.
- An email with an empty subject or message is skipped.
Webhook details:
- The payload holds
event(milestone_reached),user_id,video_id,percentage,session_id,timestamp(UTC) andsite_url. - It is sent in the background, so the viewer is never kept waiting. The request waits up to 10 seconds and the address must be a valid web address.
- A failed delivery is not retried and no error is shown. Use a service that gives you a log, and use Test Fire first.
Tag User details: the hidden field can be read by your own code or a sync plugin. If you want a tag in a CRM, send a webhook to the CRM or an automation tool.
Test Fire
Section titled “Test Fire”Test Fire runs the card’s action once against the administrator who clicked it.
- Email: sent to your admin address with
[TEST]at the start of the subject. The screen reports “Test email sent to …”. - Webhook: sent with
"test": truein the payload and anX-MediaShield-Event-Type: testheader so your receiver can ignore it. The screen reports the HTTP status. - Tag: records a test tag on your user.
- Fill in the subject before testing an email, or the test is refused.
Use cases
Section titled “Use cases”- At 100 percent, send a webhook to Zapier or Make to enrol the viewer in a follow-up sequence.
- At 100 percent, email the site admin that a key video was finished.
- At 50 percent, record engagement on the profile with Tag User and read it from your own code.
Free milestone tags are separate
Section titled “Free milestone tags are separate”The free Milestone Tags box on each video assigns named tags to a viewer at a milestone, and the free Milestones and Tags screens list them. Pro’s actions are a different, site-wide mechanism. Both can run on the same milestone.
What viewers see
Section titled “What viewers see”Viewers see nothing on the page. If you chose the User recipient for an email action, they receive that email when they reach the milestone.
Settings and options for this feature
Section titled “Settings and options for this feature”| Where | Name | Default | What it does |
|---|---|---|---|
| Milestone Actions screen | Enabled, Action Type, details per milestone | All off | The saved configuration (option ms_pro_milestone_config) |
Next steps
Section titled “Next steps”- Link a video to a lesson for automatic lesson completion.
- Export milestones.
If an action did not fire, see Troubleshooting.

