Skip to main content

Per-category settings

Path: AdminCP > [MC] Downloads Manager > Categories > (edit a category).

Categories carry their own copies of many global options. The per-category value, when set, beats the global default. A blank per-category value falls back to the global default. This page lists every per-category setting and where the global default is documented.

File policy

SettingTypeFalls back toWhat it does
Allowed file extensionsstringDefault allowed file extensionsOne per line or comma-separated. Empty allows any extension subject to the dangerous blocklist.
Maximum file sizeint (KB)Maximum individual file sizePer-file upload cap.
Maximum total size per versionint (KB)Maximum total size per versionCombined cap of all files in one version.
Maximum total upload sizeint (KB)Maximum total upload sizeCombined cap of all files across every version of one download.
Allow multi-file versionsbooln/aWhen on, an author may attach more than one file per version. When off, exactly one file per version.
Maximum files per versionintn/aCap on the number of files per version when multi-file is allowed. Range 1 to 1000.

The dangerous extension blocklist (set globally) overrides any per-category allow list.

Approval and visibility

SettingDefaultWhat it does
Accept new downloadsOnWhen off, the upload form is hidden.
Require approvalOffWhen on, new and edited downloads enter the approval queue. Users with Bypass approval skip the queue.
Enable versioningOnWhen off, downloads in this category have a single fixed file.
Show on overviewOnWhether the category appears in the top-level /downloads/ overview.

Throttling

SettingFalls back to
Guest downloads per hourGuest download rate limit
Guest burst allowanceGuest burst allowance
Member downloads per hourMember download rate limit
Member burst allowanceMember burst allowance

A blank value uses the global default. A value of 0 means "no limit" only when the global is also 0. Otherwise treat 0 explicitly as "disable for this category".

External URLs

SettingFalls back to
External URL modeExternal URL uploads (global)
Allowed schemesExternal URL allowed sources (global)

The external URL mode allows: Inherit, Disabled, Cache only, Link only, Cache, Link. Set to "Inherit" to use the global default. The global value "Disabled" overrides every category, regardless of the per-category setting.

Previews

The following toggles default to off:

  • Text previews
  • Image previews
  • Audio previews
  • Video previews
  • PDF previews
  • Archive previews

When a toggle is on, viewers with the View previews permission can open the matching file type in-browser. Size caps are global; see general options.

Tagging and teams

SettingDefaultWhat it does
Minimum tags0Minimum number of tags an author must apply at upload.
Allow teamsOffWhether teams (co-owners) are allowed in this category.
Maximum team members0Cap on co-owners per download. Use 0 for no limit. Range 0 to 1000.

SEO

SettingWhat it does
Open Graph titleOpen Graph title for the category page. Up to 150 characters.
Meta titleHTML page title for the category page. Falls back to the category title. Up to 150 characters.
Meta descriptionMeta description. Up to 300 characters.
Exclude from sitemapWhen on, the category and its downloads are omitted from the sitemap.
Exclude from search indexWhen on, the category's downloads are not indexed by site search.

Content terms

SettingWhat it does
Content termSingular noun for "download" in this category. Up to 50 characters.
Content term pluralPlural noun. Up to 50 characters.

If either is blank, the category falls back to the standard "download" / "downloads" wording.

Criteria gate behaviour

SettingDefaultWhat it does
On criteria failureShow lockedWhat viewers who fail a criteria gate see. Pick "Hide" to remove the download from listings entirely, or "Show locked" to show it with a locked indicator.

See the criteria gate.

Custom fields and prefixes

Per-category, see custom fields and prefixes.