Skip to main content

Working with KDM Templates

Create and manage KDM templates in Mica to automate key delivery for bookings. Learn about template targeting by country, venue group, venue, or production, and how the template hierarchy works.

Danny Jeremiah
Updated by Danny Jeremiah

KDM templates let you pre-configure delivery parameters — start dates, end dates, holdover windows, and validity times — so Mica applies them automatically when bookings match your targeting criteria. Instead of entering KDM settings manually for every booking, you define templates once and Mica does the rest.

If no KDM templates have been created, Mica falls back to the account-level KDM defaults set in your Shipping Defaults. Templates give you more granular control by letting you target specific countries, venue groups, venues, or productions.

Table of Contents

  1. Where to Find KDM Templates
  2. Creating a KDM Template
  3. Targeting Options
  4. Template Hierarchy
  5. Troubleshooting

Where to Find KDM Templates

Navigate to BookingsKDM-Templates in the sidebar. The KDM Templates page displays all your existing templates in a table with columns for description, targeting criteria (country, productions, venue groups, venues), date created, and the KDM parameters.

KDM Templates list page showing the template table with columns for Description, Country, Productions, Venue Groups, Venues, and KDM parameters

From here you can create new templates with the Add KDM button, or export the list as xlsx, csv, or pdf. Use the column filters to search and sort your templates.

Creating a KDM Template

Click Add KDM to open the template form. Each template has a description, targeting criteria, and five KDM parameters that control delivery timing.

Add Template dialog showing Description, targeting fields for Country, Venue Groups, Venues, and Productions, and KDM parameter fields for Start Date, End Date, Holdover Days, Start Time, and End Time

Template fields

  • Description — A name that identifies the template's purpose and scope (e.g. "USA Standard KDM" or "Pathé Cinemas Extended Window")
  • Country — The territory this template applies to, or "All" for every country
  • Venue Group(s) — One or more circuits or venue groups, or "All"
  • Venue(s) — Specific individual venues, or "All"
  • Production(s) — Specific films, or "All"

KDM parameters

All timing parameters are relative to the booking's play dates. This means the same template works across bookings with different start and end dates.
  • KDM Start Date — Days before the first play date when the KDM becomes valid (default: 0)
  • KDM End Date — Days after the last play date when the KDM expires (default: 41)
  • KDM Holdover Days — Additional buffer days beyond the booking period (default: 7)
  • KDM Start Time — Time of day the KDM becomes valid (default: 00:01)
  • KDM End Time — Time of day the KDM expires (default: 23:59)
KDM times are applied in the venue's local time zone. If your templates cover multiple territories, ensure your timing windows account for this.

Click Save to create the template. It takes effect immediately for any new bookings that match the targeting criteria.

Targeting Options

Templates can target bookings at different levels of specificity. You can use a single targeting option or combine several to create precise rules.

Country

Applies the template to all bookings in a specific territory. Use this to set baseline KDM standards for an entire market — for example, all bookings in the USA or all bookings in the Netherlands.

Venue group

Applies to all venues within a circuit or venue group. This is useful for exhibitors with specific KDM requirements across their chain, such as an extended delivery window for a major circuit.

Venue

Applies to a specific individual venue. Use this for venues with unique requirements, such as screening rooms or festival venues that need different KDM timing.

Production

Applies to a specific film or production. This is useful for high-security releases that need tighter KDM windows, or titles with special distribution requirements.

Combined targeting

You can set multiple targeting criteria on a single template. For example, a template targeting a specific production at a specific venue group in a specific country would only apply when all three criteria match. This lets you create very precise rules for exceptional cases without affecting your broader templates.

Start with country-level templates to establish your baseline KDM settings, then add more specific templates for circuits or productions that need different parameters.

Template Hierarchy

When multiple templates could apply to a single booking, Mica uses the most specific match. Templates with more targeting criteria take precedence over broader ones.

The priority order, from highest to lowest:

  1. Production + Venue — A specific film at a specific venue
  2. Production + Venue Group — A specific film at a specific circuit
  3. Production + Country — A specific film in a specific territory
  4. Venue — A specific venue, all films
  5. Venue Group — A specific circuit, all films
  6. Production — A specific film, all locations
  7. Country — A specific territory, all films (lowest priority)

If no template matches, Mica falls back to the account-level KDM defaults.

Troubleshooting

Issue

Solution

Template not applying to new bookings

Check that the targeting criteria matches your booking — verify the country, venue group, and venue are correct. If another template exists with more specific targeting, it will take precedence. Also confirm that KDM shipping is enabled on the release.

Wrong template applying

Review the template hierarchy above. A more specific template overrides a broader one. Check the KDM Templates list to identify any conflicting templates.

Need to override a template for one booking

Templates set the defaults, but you can edit KDM parameters directly in the booking wizard's Period step. Manual changes override the template for that booking only.

Template not affecting existing bookings

Templates only apply to bookings created after the template is saved. To update existing bookings, edit them individually or use bulk update features.

If you need assistance with any aspect of Mica, we're here to help:

Contact your Mica system administrator for organisation-specific questions or access issues

OR

Reach out to the Mica support team at support.mica@maccs.com

How did we do?

When to Change Playweek Start Day in Mica

Working with Term Templates

Contact