Home

stencila site uploads config

Configure upload settings

Usage

stencila site uploads config [OPTIONS]

Examples

# Set upload path
stencila site uploads config --path data

# Set allowed file types
stencila site uploads config --allowed-types csv --allowed-types json

# Set max file size (5MB)
stencila site uploads config --max-size 5242880

# Require commit message
stencila site uploads config --require-message

# Allow users to specify custom paths
stencila site uploads config --user-path

# Only show on admin pages
stencila site uploads config --include "admin/**"

Options

NameDescription
--publicAllow public (non-team member) access. Possible values: true, false.
--no-publicDisallow public access. Possible values: true, false.
--anonAllow anonymous (no GitHub auth) submissions. Possible values: true, false.
--no-anonDisallow anonymous submissions. Possible values: true, false.
--pathUnified path for visibility and destination.
--target-pathOverride: explicit target directory for uploads.
--allowed-typesAllowed file extensions (can be specified multiple times).
--max-sizeMaximum file size in bytes.
--user-pathAllow users to specify custom upload paths. Possible values: true, false.
--no-user-pathDisallow custom upload paths. Possible values: true, false.
--allow-overwriteAllow overwriting existing files. Possible values: true, false.
--no-allow-overwriteDisallow overwriting existing files. Possible values: true, false.
--require-messageRequire a description/commit message. Possible values: true, false.
--no-require-messageDon't require a message. Possible values: true, false.
--includeGlob patterns for pages to show widget on (can be specified multiple times).
--excludeGlob patterns for pages to hide widget from (can be specified multiple times).

Note

Configuring upload settings will automatically enable uploads if not already enabled. Use stencila site uploads off afterward if you want to disable.

© 2026 Stencila