Foundry modules / Documentation

Where the Foundry phone keeps your data

Last checked 2026-10-08

The short version

Everything the phone stores stays in your Foundry world and your Foundry data folder. The phone makes no network requests of its own, and nothing is sent to ShawnsVTTs. It needs no account for your players, and no database or file service from us. Your install link is only used to download the module.

Where each kind of data lives

WhatWhere it is storedWho can change it
Texts, email, group chats and the party feedIn the sender's character data, inside the worldThe character's owner, and the GM
Notes, the call log, wallet history and read marksIn the character data of whoever wrote themThe owner, and the GM
Handset state, phone numbers, signal zones, notices, the calendar, battery settings, NPC contacts and voicemail greetingsWorld settingsThe GM only
MoneyOn the character sheet, in your game system's own currencyMoved by a connected GM when a payment is made
Calls ringing, and requests to the GM such as a payment or a chargeNowhere. They travel over Foundry's live connection and are applied by a GM's clientNot applicable
Images and audio files the GM attaches or addsFiles in your Foundry data folder, in a folder named shawnsvtts-phone-uploads, or wherever the link you gave pointsThe GM, who uploads them
A player's wallpaperResized and stored inside their character data, not as a fileThe player

Players do not need upload permission

Players never upload files through the phone. The GM attaches images and audio, and GMs can always upload in Foundry. A player sends a photo from their own gallery, which holds pictures the GM placed there. A player's wallpaper is resized in the browser and stored in their character data. You do not need to give players Foundry's file upload permission for any of this.

Privacy is a friendly-table arrangement

Foundry sends every character's data to every connected player's browser. So the phone hides other people's texts, notes and photos in the interface rather than behind a lock. A player who knows how to open their browser's developer tools could read data that was not meant for them, and could read (though not change) the GM's world settings. Most tables are fine with that. If yours is not, keep real secrets out of phone messages and tell your players that the phone is not a safe.

Two things to know. Unsend blanks a text for everyone, but the copy the optional chat echo wrote into the Foundry chat log stays, and an uploaded file stays on disk. See Unsend a text message and Echo phone messages to chat.

Backups and moving a world

Texts and settings are part of the world, so a world backup or export carries them. Uploaded files live in the Foundry data folder, so back up your data folder, and copy the shawnsvtts-phone-uploads folder along with the world if you move it to another server. Links that point at files elsewhere keep working only while those files exist.

Long campaigns

Messages, notes and wallet history are kept for the life of the world, and there is no rolling window yet. In a long campaign with a chatty table the character data grows, and Foundry loads it for everyone when the world starts. The GM can tidy superseded read marks and similar entries by running game.modules.get('shawnsvtts-phone').api.compact() in a script macro. See Macros and the phone API.

Offline and fonts

The phone works wherever Foundry works, including tables with no internet connection. Its fonts are bundled with the module.

Related

Foundry Virtual Tabletop belongs to Foundry Gaming LLC. ShawnsVTTs modules are independent add-ons and are not made, endorsed or supported by Foundry Gaming LLC.