PressKit Portal Settings

Applies to version/build: PressKit docs v1 baseline (released February 16, 2026; see changelog for updates)

Portal settings are the policy layer for PressKit in a HubSpot portal. They apply across every Company EPK in that portal.

Read this page before you enable auto-publish. It’s one-way.

Quick links

What these settings control

Publishing defaults (including irreversible auto-publish).
Public page presentation (Quick Facts rail, press copy layout, hero pills, hero spotlight).
Media behavior (embedded previews + per-type limits).

Boundaries

epk.autoPublishByDefault cannot be turned off once enabled.
Some settings affect presentation only; they do not rewrite stored profile data.
Quick Facts is available on public pages only when epk.quickFactsEnabled is enabled; default posture is off.
Press-copy generation is optional and may be disabled (treat manual copy as the baseline).
Settings are portal-wide; per-company theming/layout customization is not supported in v1.

Support intake checklist

When you contact support, include:

Portal ID
Screenshot of the relevant settings section
Setting key(s) changed (and intended values)
Timestamp with timezone and any visible error text (include requestId when shown)

Public visibility modes (default vs auto-publish)

PressKit supports two portal-level visibility postures:

Default mode (auto-publish OFF): draft and missing records are not publicly accessible. Publishing requires Artist Name and Description. Public route contract is /epk/:portalId/:publicId.
Auto-publish mode (portal setting, irreversible): public pages are accessible by default (including empty profiles). Operators should treat this as always-on public visibility, and per-record publish toggling may be disabled.

Publishing Defaults

Setting	Portal key	What it changes
Enable Tribute field by default	`epk.tributeEnabledDefault`	Controls whether new Company profiles start with Tribute enabled (you can still override per record in PressKit Editor).
Auto-publish all company EPKs by default (irreversible)	`epk.autoPublishByDefault`	Makes Company EPK pages publicly accessible by default, including empty profiles. Once enabled, it cannot be disabled.

Public Page Content

Quick Facts rail

epk.quickFactsEnabled controls whether the public EPK page shows the Quick Facts rail and related nav anchor.

Default posture is off.
When enabled, public pages render Quick Facts.
When disabled, Quick Facts stays hidden.

Image metadata display (optional)

epk.showImageMetadata controls whether image title/metadata text renders on public photo surfaces.

Copy presentation mode

Copy mode controls how the biography/copy section renders on public pages:

epk.pressCopyLayoutMode=about: renders a single long-form About Us section.
epk.pressCopyLayoutMode=press_copy: renders Press Copy blocks for reuse.

When press_copy mode is enabled, these per-block settings control which blocks are shown publicly:

epk.pressCopyBlocks.fullBio
epk.pressCopyBlocks.bio50
epk.pressCopyBlocks.bio120
epk.pressCopyBlocks.elevatorPitch
epk.pressCopyBlocks.suggestedIntro

Press-copy generation is optional and may be disabled by runtime gating. When disabled (default), the editor hides Generate and manual overrides are the primary workflow.

Generation is draft-only until you save profile changes.

Hero pills display

Hero pills are the highlight row beneath the hero description on public pages:

epk.heroPillsMode=full: show all hero pills.
epk.heroPillsMode=minimal: hide hero pills.
epk.heroPillsMode=custom: show only enabled pills:
- epk.heroPills.photos
- epk.heroPills.downloads
- epk.heroPills.audienceFit
- epk.heroPills.trailerClips
- epk.heroPills.photoCount
- epk.heroPills.techDocsReady
- epk.heroPills.downloadableAssets

Hero spotlight media

epk.heroSpotlightMode controls the hero spotlight style:

trailer: prefers interactive trailer playback (when embeddable video exists).
photo: forces a static hero photo spotlight with no trailer controls.

Media & Limits

Setting	Portal key	What it changes
Allow embedded video previews	`epk.allowVideoEmbed`	Controls whether video links can render embedded previews on public pages.
Maximum images per EPK	`epk.maxImages`	Max image items allowed per Company EPK profile.
Maximum documents per EPK	`epk.maxDocuments`	Max document items allowed per Company EPK profile.
Maximum videos per EPK	`epk.maxVideos`	Max video link items allowed per Company EPK profile.

Video links must use HTTPS URLs. Media limits and validation guardrails are described in Known Limitations.