Storyden

Settings Page

The various settings available in the admin dashboard and how to use them to run the best site you can!

When logged in as an administrator, open the Account menu at the bottom of the sidebar and choose Admin. The admin sidebar groups settings for appearance, community, security, operations and extensions.

Brand settings using Storyden’s name, icon previews and mountain banner

Brand settings

Here you can change your community's name, this controls a few aspects of the site:

  • The browser tab title
  • If the site is installed as a Progress Web App (PWA) it will be the name of the app
  • The heading in the navigation

The Icon section allows you to upload a custom logo which is used in:

  • The favicon
  • The PWA app icon used on device home screen, taskbar and dock
  • The social share image for when the index page is shared

The description is used in the meta description tag for SEO and social share embeds.

You can read more about how these impact SEO here.

Use Appearance → Custom theme for installation-wide CSS and JavaScript. See Custom themes for the supported styling hooks.

Interface and layout

Appearance → Interface controls the default editor and how member signatures are displayed.

Interface settings for the default editor and member signatures

To arrange the home feed and navigation, return to the community and choose Edit site in the sidebar. Use the block handles to configure the feed, and the navigation controls to move or add sidebar items.

The site editor with movable feed blocks and sidebar navigation controls

If you want to see more settings for administrators to control, please open an issue.

Media

Operations → Media controls image upload limits for attachments, avatars, and branding. Saved changes take effect without restarting Storyden.

SettingDefaultWhat it controls
Maximum image size8 MiBThe uploaded image file size.
Maximum image resolution1.5 megapixelsWidth multiplied by height, before any resizing.

Both limits must be satisfied. They do not limit documents, archives, or other non-image uploads. The pixel limit applies to JPEG, PNG, WebP, and GIF images. Vector images have no pixel count to check.

Calculate megapixels as width × height ÷ 1,000,000. For example, 1920 × 1080 is 2.0736 MP, so a limit of 2.1 MP allows that resolution with a little headroom. This is a total pixel limit, not separate width and height limits: a different aspect ratio with the same pixel count also fits.

Storyden preserves accepted originals and creates optimized versions of static JPEG, PNG, and WebP images in the background. Animations, SVGs, and unsupported image formats keep their original files. Accepting an upload and creating optimized versions are separate decisions: an image can fit the upload policy but exceed the worker's memory budget. In that case, the original remains available, while some or all optimized versions may be skipped. If no sufficiently large optimized version is ready, Storyden displays the original.

Example: allow Full HD images

To allow images such as 1920 × 1080 and give the worker room to generate their optimized versions:

  1. Open Operations → Media.

  2. Set Maximum image resolution to 2.1 megapixels.

  3. Set Maximum image size to 8 MiB and save.

  4. Set these environment variables in your deployment, then restart Storyden:

    IMAGE_MEMORY_BUDGET=536870912
    IMAGE_WORKERS=1

536870912 bytes is 512 MiB. The image file must still fit the 8 MiB limit; dimensions alone do not determine file size. Storyden does not resize an oversized upload to make it fit these limits.

Starting points for other image sizes

These are rough starting points for ordinary landscape, portrait, and square images with one background worker. The suggested budgets allow room to generate large optimized images as well as thumbnails.

Example sourceMaximum resolutionMaximum image sizeIMAGE_MEMORY_BUDGET
1920 × 10802.1 MP8 MiB536870912 (512 MiB)
2560 × 14404 MP16 MiB536870912 (512 MiB)
3840 × 21608.5 MP32 MiB1073741824 (1 GiB)
4000 × 300012 MP32 MiB1073741824 (1 GiB)

The deployment defaults are 1.5 MP, 8 MiB uploads, a 256 MiB processing budget, and one worker. They allow images such as 1600 × 900 and keep the estimated processing requirement below the default budget, without an immediate warning in Media settings. Full-size phone and camera photos usually need resizing before upload, or higher upload limits and a larger worker budget. The examples above show starting points for larger images. Allowing a 4K upload preserves its original resolution; the largest fitted variant still fits within 1920 × 1920.

Extremely wide or tall images can need more memory than these examples. Use the advisory in Media settings to compare your saved limits with the configured budget. It estimates a square image at those limits and is guidance, not a guarantee for every image or format.

Server memory and background processing

IMAGE_MEMORY_BUDGET controls how much memory Storyden reserves for image processing on each running server. Storyden uses this budget to decide which images it can process. Your server or container also needs memory for normal requests and the rest of the application, so allow additional memory beyond this budget.

IMAGE_WORKERS defaults to 1. Increasing it lets Storyden process more images at once. All workers share the same memory budget. If you run multiple Storyden servers, each has its own workers and budget.

Environment changes require a restart. Increasing the budget does not automatically retry variants that were already marked as skipped; verify the new policy with a new upload.

Discovery

Operations → Discovery controls how search engines and other tools discover your site. Changes take effect without restarting Storyden.

  • Search indexing publishes sitemaps and allows search crawlers in the default robots.txt. Turning it off also disables the sitemap endpoints.
  • AI training crawlers are discouraged by default through robots.txt. This preference is separate from search indexing and discovery documents.
  • Discovery documents have individual switches for llms.txt, auth.md, the AI catalog, the API catalog and the MCP Server Card. Disabled documents return 404, and the remaining guides omit links to them. These controls do not change member permissions, OAuth or MCP functionality.
  • Custom robots.txt replaces the entire generated policy, including crawler rules and sitemap links. Leave it empty, or choose Use default robots.txt and save, to restore the generated policy.

Search indexing is enabled by default. Discovery documents are disabled by default; enable each one when you want to advertise it. MCP Server Cards are only available when MCP is configured. Search indexing, AI training crawlers and discovery documents can be configured independently.

Crawler rules are requests to cooperating crawlers. They do not restrict access to public content; use member permissions to control access.

API

You can configure anything you see on the admin page via the API programmatically. This is useful if you want to set up a new site with a script or change settings based on schedules or other events.

Client IP and SSR

Client IP mode, trusted CIDRs and related settings on this page affect how Storyden resolves client IPs for API request context.

If you use the official Storyden Next.js frontend with SSR, Storyden forwards only X-Forwarded-For from the SSR request back to the API, and the backend applies the same client-IP mode logic to both browser and SSR API calls.

See SSR Client IP Forwarding for deployment guidance and when each layer should be configured.

On this page