Skip to content

Audience settings reference

Most Audience Integrations workflows are set up in the Showcase Editor. The server-wide options and limits below are set in the server configuration file, production_users.yaml, instead. See File locations for where the file lives on each platform.

To change a setting, add it to production_users.yaml (or remove the # in front of it, if the file already lists it commented out), enter the value, and restart Showcase Server. A setting left commented out uses its default. Where a setting takes a list, separate the values with commas.

Feature switch

Setting Default Meaning
integrations_enabled true Turns Audience Integrations on or off. The SHOWCASE_INTEGRATIONS_ENABLED environment variable overrides it. See Turning Audience Integrations off.

Addresses and pages

Setting Default Meaning
audience_public_origin empty (uses the public URL) The address phones use for QR codes and upload links. The Audience and phone URL saved in Network & Public Access takes precedence over this setting.
audience_upload_page_path /upload The page an Audience Upload QR opens. Override it only to point at your own Hosted Site, for example /www/<site>/.

Personal Folders

Setting Default Meaning
audience_person_fields firstName, lastName The person details a visitor may edit on their Personal Folder page.
person_accepted_mime image/jpeg, image/png, image/webp, video/mp4, application/pdf File types a visitor may upload to their own Personal Folder.
person_upload_per_codice_per_hour 30 Maximum uploads to one Personal Folder in any hour.

Audience Upload

Setting Default Meaning
audience_max_upload_bytes 10485760 (10 MB) Largest single upload accepted.
audience_max_pixels 50000000 (50 megapixels) Largest image accepted, in total pixels.
audience_accepted_mime image/jpeg, image/png, image/webp, video/mp4 File types visitors may upload through an Audience Upload QR.
audience_max_uploads_per_token 10 Uploads allowed per Audience Upload QR.
audience_upload_token_ttl_seconds 600 (10 minutes) How long an Audience Upload QR stays valid.
audience_max_pending_per_target 50 Uploads that can wait for moderation per target before new ones are refused.
audience_upload_per_ip_max 30 Uploads allowed from one network address within the window below.
audience_upload_per_ip_window 10 minutes The window for the per-address limit.
audience_quarantine_retention_days 30 How long rejected uploads are kept, in days.

These limits do not apply to Personal Folder Access QR links, which stay valid until an operator resets them.

Public assets

Setting Default Meaning
public_asset_folders empty (public asset API off) Folders, relative to the asset root, that anyone can read through the public asset API without signing in. Set it only for folders you intend to publish.