- 4 minutes to read

SharedFilePolicy - System Parameter

New 7.5.0

The SharedFilePolicy System Parameter is a JSON configuration that governs how the Nodinite File Library accepts and serves shared files. It defines the allowed MIME types for uploads and the default link behavior used when shared files are opened from Articles and Shared File Custom Metadata.

  • Control which non-image files users may upload to the File Library
  • Define the default link target for shared file links in the Web Client
  • Keep browser-displayable files readable without forcing every document download
  • Separate shared-file governance from the Image Library and private Attachment uploads
  • Keep the JSON shape ready for future file-policy options

Important

SharedFilePolicy applies to reusable shared files in the File Library and the Shared File custom metadata type. It does not replace the rules for the Image Library and it does not change how private Attachment values store their own file copies.

SharedFilePolicy system parameter
Example of the SharedFilePolicy system parameter in the Nodinite Web Client showing the JSON configuration for allowedMimeTypes, defaultLinkTarget, and defaultDeliveryBehavior.

System Parameter Name Data Type Values / Example Comment
SharedFilePolicy JSON JSON object (see example below) Controls File Library upload validation and default shared-file link behavior

What Does SharedFilePolicy Control?

Property Meaning Documented Example
allowedMimeTypes Allowlist of MIME types accepted by the File Library for shared-file uploads application/pdf, application/json, application/xml, Office Open XML formats, ZIP
defaultLinkTarget Default browser target for shared file links rendered in Articles and Custom Metadata NewTab
defaultDeliveryBehavior Default delivery mode used when a shared file link is opened BrowserDefault

How It Works

graph LR Admin[" Administrator"] -->|Configures| Policy[" SharedFilePolicy"] Policy -->|Validates uploads| Library[" File Library"] Library -->|Reusable links| Articles[" Articles"] Library -->|Reusable references| Metadata[" Shared File\nCustom Metadata"] Articles --> Browser[" Browser"] Metadata --> Browser

The SharedFilePolicy configuration validates uploads into the File Library and supplies the default behavior for shared-file links opened from Articles and Custom Metadata.

JSON Configuration Structure

The following JSON example documents the initial SharedFilePolicy structure used by the Files feature:

{
  "allowedMimeTypes": [
    "application/pdf",
    "text/plain",
    "text/csv",
    "application/json",
    "application/xml",
    "text/xml",
    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "application/vnd.openxmlformats-officedocument.presentationml.presentation",
    "application/zip"
  ],
  "defaultLinkTarget": "NewTab",
  "defaultDeliveryBehavior": "BrowserDefault"
}

Documented Properties

Property Type Description
allowedMimeTypes string array Defines which file formats can be uploaded as shared files. Use this to keep executables and other unwanted formats out of the File Library.
defaultLinkTarget string Sets the default target used when shared file links are rendered. The documented example uses NewTab.
defaultDeliveryBehavior string Controls the default link delivery mode. The documented example uses BrowserDefault so browser-displayable files can remain in the browser when possible.

Use SharedFilePolicy to align the File Library with your documentation and security standards:

  • Allow business and technical document formats that teams genuinely need in Articles and Custom Metadata
  • Exclude unrestricted executable or script uploads from the shared library
  • Review the MIME type list with the teams that own shared runbooks, schemas, and partner documents
  • Keep the default link behavior predictable so users know whether a file opens inline or in a new tab

Prerequisites

Before changing SharedFilePolicy, make sure the following are true:

  • You are a member of the built-in Administrator Role
  • Your team knows which file formats should be allowed in the File Library
  • The consuming Articles and Custom Metadata scenarios are understood before you tighten the policy

Frequently Asked Questions

How do I change the value?

To update the SharedFilePolicy System Parameter, follow the steps in How do I change the System Parameters?.

Why was my upload rejected?

The uploaded file's MIME type is not present in allowedMimeTypes. Compare the file's detected MIME type with the JSON allowlist and update the policy only if the format is intentionally supported.

Does SharedFilePolicy affect images or Attachment fields?

No. SharedFilePolicy governs the File Library and the Shared File custom metadata type. The Image Library keeps its own image-specific behavior, and private Attachment values still store their own binary copy per value.

The documented example uses defaultLinkTarget = NewTab. Combined with defaultDeliveryBehavior = BrowserDefault, this lets browser-friendly documents such as PDF, JSON, XML, and text files open without forcing an immediate download.

Next Step