Plugins
CAP plugin

CAP

Show official emergency alerts, like severe weather and evacuations, on your screens automatically.

About

Show official emergency alerts on your screens automatically: severe weather, evacuations, Amber alerts and civil emergencies. Your alert provider, like Alertus or Raptor, sends CAP (Common Alerting Protocol) alerts to Play, and they take over the screens you choose, in your design. Works on every player that’s online. Vital for schools, hospitals, government buildings and stores.

Video: CAP

Get Started

Set up CAP alerts

  1. Create a playlist for the alert, and add the CAP alert plugin to its slide
  2. Design the slide, and choose whether the alert’s headline or description goes into the placeholder
  3. Tag the screens that should show the alert. Click edit on the tag to see its Tag ID
  4. On the Team page, create an API key and note it
  5. Give your alert provider the tag alert API endpoint, the base address for your region (https://eu-api.playsignage.com or https://us-api.playsignage.com), the Tag ID and the API key

Test an alert

This needs some technical know-how: you send the request an alert provider would send. The example uses curl (macOS and Linux; on Windows, use Postman). Replace the address (us-api in the example), <tag_id> and <api_key> with your own, and set the effective, onset and expires dates so the alert is active now.

 curl -X POST "https://us-api.playsignage.com/v1/tags/<tag_id>/alert" \
     -H "Content-Type: application/xml" \
     -H "Authorization: <api_key>" \
     -d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
    <identifier>ALERTUS_3716_164_20260302_203832</identifier>
    <sender>PlaySignage Test</sender>
    <sent>2026-03-07T19:00:00+00:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <source>Alertus eEAS Server</source>
    <scope>Public</scope>
    <addresses>ALL</addresses>
    <code>IPAWSv1.0</code>
    <info>
        <language>en-US</language>
        <category>Safety</category>
        <event>Local Area Emergency</event>
        <responseType>None</responseType>
        <urgency>Immediate</urgency>
        <severity>Severe</severity>
        <certainty>Observed</certainty>
        <eventCode>
            <valueName>SAME</valueName>
            <value>LAE</value>
        </eventCode>
        <effective>2026-03-07T19:00:00+00:00</effective>
        <onset>2026-03-07T20:00:00+00:00</onset>
        <expires>2026-03-07T20:00:00+00:00</expires>
        <headline>HEADLINE This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</headline>
        <description>DESCRIPTION This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</description>
        <parameter>
            <valueName>EAS-ORG</valueName>
            <value>EAS</value>
        </parameter>
        <area>
            <areaDesc>Not specified</areaDesc>
            <geocode>
                <valueName>SAME</valueName>
                <value>000000</value>
            </geocode>
        </area>
    </info>
</alert>'

To cancel the alert, send the same with <msgType>Cancel</msgType>:

 curl -X POST "https://us-api.playsignage.com/v1/tags/<tag_id>/alert" \
     -H "Content-Type: application/xml" \
     -H "Authorization: <api_key>" \
     -d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
    <identifier>ALERTUS_3716_164_20260302_203832_CANCEL</identifier>
    <sender>PlaySignage Test</sender>
    <sent>2026-03-07T19:00:00+00:00</sent>
    <status>Actual</status>
    <msgType>Cancel</msgType>
    <source>Alertus eEAS Server</source>
    <scope>Public</scope>
    <addresses>ALL</addresses>
    <code>IPAWSv1.0</code>
    <info>
        <language>en-US</language>
        <category>Safety</category>
        <event>Local Area Emergency</event>
        <responseType>None</responseType>
        <urgency>Immediate</urgency>
        <severity>Severe</severity>
        <certainty>Observed</certainty>
        <eventCode>
            <valueName>SAME</valueName>
            <value>LAE</value>
        </eventCode>
        <effective>2026-03-07T19:00:00+00:00</effective>
        <onset>2026-03-07T20:00:00+00:00</onset>
        <expires>2026-03-07T20:00:00+00:00</expires>
        <headline>This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</headline>
        <description>This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</description>
        <parameter>
            <valueName>EAS-ORG</valueName>
            <value>EAS</value>
        </parameter>
        <area>
            <areaDesc>Not specified</areaDesc>
            <geocode>
                <valueName>SAME</valueName>
                <value>000000</value>
            </geocode>
        </area>
    </info>
</alert>'

Options

What you set up:

Option What it does
CAP alert plugin Shows the alert’s headline or description on your slide
Tag The screens that show the alert, and its ID
API key Lets the alert provider trigger the tag (Team page)
Region address https://eu-api.playsignage.com or https://us-api.playsignage.com

FAQ

What is CAP?

The Common Alerting Protocol: the international standard governments and emergency agencies use to send official alerts. Play receives them and shows them on your screens in real time.

Which alert providers do you support?

So far we’ve worked with Alertus and Raptor. Want another? Contact us.

Which players show CAP alerts?

All players Play supports, as long as they’re online.

Related Articles

Get started designing your content

Most people think designing content for digital signage is super difficult, but if you can use PowerPoint, you can also create and design your own content in our editor.

Book a free demo

Loading free times…