skills.rest
ImproperSubset
ImproperSubsetCOMMUNITY
Explore all skills by this author →
GitHub

fvtt-data-storage

Select optimal Foundry VTT storage among Flags, Settings, and Files.

1|Updated Jan 4, 2026
Search Tags:#flags#settings#storage#files#module-development#data-migration#Foundry VTT
One-click install
npx skills add https://github.com/ImproperSubset/hh-agentics --skill fvtt-data-storage
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fvtt-data-storage
Source: https://github.com/ImproperSubset/hh-agentics/tree/main/fvtt-dev/skills/fvtt-data-storage
Command: npx skills add https://github.com/ImproperSubset/hh-agentics --skill fvtt-data-storage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Foundry VTT modules and systems must decide where to store data: per-document Flags, global Settings, or external Files. Using the wrong storage type can cause performance issues, permission boundaries, or data inconsistency.

Core Features & Use Cases

  • Flags: per-document storage that travels with the object.
  • Settings: global or per-user configuration for broader scope.
  • Files: for large datasets or exportable data that would slow documents.

Quick Start

Decide storage strategy for a given data piece: should a module setting be global, a document flag, or a file reference?

Frequently Asked Questions about fvtt-data-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
When should I use Flags vs Settings vs Files for Foundry VTT module data storage?▼

Choose Flags for per-document metadata that travels with the object, Settings for global or per-user world configurations, and Files for large datasets that would slow down Foundry VTT documents.

How do I store per-document metadata in Foundry VTT modules?▼

Store per-document metadata in Foundry VTT using Flags. Flags ensure the data travels directly with the specific document object, maintaining proper scope and document-level persistence across your module or system.

What is the best way to handle large datasets in Foundry VTT module development?▼

The best way to handle large datasets in Foundry VTT is using File-backed storage. Storing massive data in Flags or Settings causes performance issues, whereas external Files keep document loading fast.

Can I migrate data between storage types in a Foundry VTT module?▼

Yes, you can migrate data between storage types in Foundry VTT. Planning a data migration path between Flags, Settings, and Files ensures you can adjust storage scopes and fix permission boundaries without causing data inconsistency.

Why does my Foundry VTT module have performance issues when loading documents?▼

Foundry VTT module performance issues often occur when large datasets are stored in per-document Flags instead of external Files. Moving heavy data to File-backed storage prevents slowing down document loading and resolves performance bottlenecks.

Related Skills

Explore More Software Engineering Skills→
herveDarritchonherveDarritchon
1

testing-strategy-vitest-playwright

Define Vitest and Playwright testing strategies for Foundry VTT modules.

Community
Advanced
orangehrmorangehrm
1.1k

config

Standardize OrangeHRM hs_hr_config key/value settings handling across runtime and migrations.

Official
Intermediate
ImproperSubsetImproperSubset
1

fvtt-data-migrations

Migrate Foundry VTT module data structures with versioned, idempotent workflows.

Community
Advanced
developerfreddeveloperfred

gaia-storage

Manage decentralized data storage for Stacks applications via Gaia Hub.

Community
Intermediate