EasySignage - Media JSON Integration Guide

What is Media JSON?

Media JSON is a lightweight JSON structure designed to deliver multimedia content like images and videos.
It serves as a modern alternative to MRSS, optimized for API integration and easy content automation.

Why Use Media JSON in EasySignage?

With Media JSON, you can automate content updates by pointing your screen to an external JSON feed.
No need to manually upload files — any changes in the feed reflect instantly on your screens.

Perfect for:

Retail promotions
News and announcements
Menu boards
Dynamic image or video campaigns

How to Use Media JSON in EasySignage

Open the management console.
Select the playlist and then the layer where you want to add the feed.
If the layer is empty, the apps dialogue will open automatically. Otherwise, click Add New.
Look for Media JSON under General Apps, Video Apps, and News Apps.
Click on Media JSON to proceed.
Enter the feed URL.
Choose the number of items to display using the media count option.
Select the media type: images, videos, or both.
Click Save to apply your changes.

Feed Requirements

Your Media JSON feed must be:

Hosted on a valid HTTPS server
Or returned from a public API endpoint

Example Media JSON Format:

{
  "channel": {
    "items": [
      {
        "title": "Image 1",
        "mediaContent": {
          "url": "https://files.cloud-digitalsignage.com/mrss/files/1.jpg",
          "type": "image/jpeg",
          "medium": "image",
          "duration": "10",
          "changeKey": "a077ae97dfe45af878f0e0fafdc05c85"
        }
      },
      {
        "title": "Video 1",
        "mediaContent": {
          "url": "https://files.cloud-digitalsignage.com/mrss/files/a.mp4",
          "type": "video/mp4",
          "medium": "video",
          "duration": "10",
          "changeKey": "f11b8c8d750d2087e0a6c0478840063d"
        }
      }
    ]
  }
}

Download feed file example: https://files.cloud-digitalsignage.com/media-json/media-json.json

Media JSON Field Guide

Understanding each field ensures your content displays correctly on EasySignage screens.

Root Structure

Field	Required	Description
`channel`	✅	Container for all items in the feed
`items`	✅	Array of media entries

Each `item`

Field	Required	Description
`title`	✅	Title of the media item
`mediaContent`	✅	Object containing the media file details

`mediaContent` Attributes

Attribute	Required	Description
`url`	✅	Direct HTTPS URL to the media file
`type`	✅	MIME type, e.g. `image/jpeg` or `video/mp4`
`medium`	✅	Either `image` or `video`
`duration`	✅	Display duration in seconds
`changeKey`	❌ (Recommended)	Unique identifier (e.g., MD5 hash) that forces refresh if media content changes at same URL

Example Entry

{
  "title": "Video 1",
  "mediaContent": {
    "url": "https://yourdomain.com/media/video1.mp4",
    "type": "video/mp4",
    "medium": "video",
    "duration": "15",
    "changeKey": "abc123xyz456def789"
  }
}

This entry will display video1.mp4 for 15 seconds. The content will refresh only if the url or changeKey changes.

How Updates Work

Content is updated if the URL or changeKey changes.
If nothing changes, media is not re-downloaded.
Update the changeKey (e.g., new hash) when media content is replaced without changing its URL.

Update Frequency

Feeds are checked every 15 minutes
Only online players with active playlists trigger feed checks
Offline players will update when they reconnect — may take up to 15 minutes

Media Storage

Files are downloaded from the JSON feed to cloud storage
Synced to your players for offline playback

Supported Media Types

Images: image/jpeg, image/png
Videos: video/mp4, video/webm

Each mediaContent object must include:

url
type
medium
duration
changeKey (optional, but recommended)

Tips

Keep feeds small for faster loading.
Use a CDN or fast host for media files.
Always update changeKey when replacing files using the same URL.

Need help setting up your Media JSON feed?
Contact EasySignage support for assistance.

Media JSON Integration