> ## Documentation Index > Fetch the complete documentation index at: https://docs.pnbr.io/llms.txt > Use this file to discover all available pages before exploring further. # A File has no source date > A File version has no source date until someone sets it, so Penumbra cannot say what date the document states. Troubleshooting · files > **Use when** > > A version shows `source date: none`, or an answer needs the date that a document states and has none. > **Looking for something else?** > > The time when an entity is true (problem [An entity lost its time after an edit](https://docs.pnbr.io/troubleshooting/entity-time-lost-after-edit.md)). A search that ignores dates (card rule search.8). ## Signs * `penumbra files inspect ` prints `source date: none`. * `penumbra files versions ` lists the version without the words `source date`. * `penumbra context entity --json` shows no source date under `time` for an entity from that File. * The person asks what is the latest, or what was true on a date, and the passages carry no date. ## Why it happens The source date is the date that the document itself states, such as a filing, report or sent date. It is not the upload date. It belongs to one version of a File, and it exists only if someone sends it. An upload, a replace or a new document carries it only when the command names it. A person who uploads in the App sets no date. A replace does not copy the date. The new version starts with no date, even if the old version had one. An extraction pins the date of each File when it starts, and writes that date on the entities that it proposes. An entity that you submitted keeps the date it had then. A later change to the date of the version does not reach it. Search does not use the date to filter or to order passages. ## What Penumbra does By itself: * Keeps one source date for each File version, with the precision that you send: a year, a month, a day or a full time. * Gives a new version a source date only when the request named one. A replace does not copy the date of the old version. * Pins the source date of each File when an extraction starts, and writes it on the entities that the extraction proposes. * Keeps on a submitted entity the date it had at submit. A later change to the date of the version does not reach the entity. * Sends no source date from an upload in the App. You must: * Read the date from the text of the document, not from the upload. * Set the date on the exact version, and set it before you extract. * Give the date at the precision that the document gives. Not handled: * Search does not order or filter passages by source date. * Nothing infers a source date from the text of a document. ## Do 1. Find the date in the document: `penumbra files text `. Use the date the document states. If it states only a month, send only the month. 2. Set the date on the current version: `penumbra files source-date 2024-05-03`. For an older version, add `--version `. Read the id from `penumbra files versions `. To remove a wrong date, run `penumbra files source-date --clear`. MCP: call `update_file` with the path of the File and the date. To date an older version, add its version id. A File with no path needs `penumbra files place ` first, or use the CLI. 3. Send the date when you add a File: `penumbra files upload --source-date 2024-05-03`. For a new edition, run `penumbra files replace --source-date `. For a Markdown document, run `penumbra files new --from --source-date `. MCP: `create_markdown` takes a source date. 4. If entities from this File were already submitted, they have no date. Tell the person. If the date matters, extract again from the dated version (recipe [extract-files](https://docs.pnbr.io/guides/extract-files.md)). This is the one case where a second extraction of one version is right (problem [new-version-not-extracted](https://docs.pnbr.io/troubleshooting/new-version-not-extracted.md)). Expect the items to show `updates existing` (card rule [extraction.9](https://docs.pnbr.io/concepts/extraction.md#rule-extraction-9)). An item that updates an entity that exists writes no time. Read `time` on the entity after the submit (problem [entity-time-lost-after-edit](https://docs.pnbr.io/troubleshooting/entity-time-lost-after-edit.md)). 5. When you answer, say the date and its precision. Do not turn a month into a day. ## Don't * Don't use the upload date as the source date. It tells the person when the File arrived, not the date of the document. * Don't set the date after you start an extraction and expect the entities to get it. The extraction pinned the dates when it started. * Don't give a day when the document states only a year. Later answers then claim more than the document says. * Don't expect search to order passages by date. Read the dates from `penumbra files versions ` and order the passages yourself (card rule [search.8](https://docs.pnbr.io/concepts/search.md#rule-search-8)). ## Check * `penumbra files inspect ` prints `source date: ` for the version that you changed. * `penumbra files versions ` shows `source date ` on that version. * Entities from a new extraction show the date: `penumbra context entity --json`. ## Related Card [file](https://docs.pnbr.io/concepts/file.md), with rule [file.5](https://docs.pnbr.io/concepts/file.md#rule-file-5). Card [search](https://docs.pnbr.io/concepts/search.md), with rule [search.8](https://docs.pnbr.io/concepts/search.md#rule-search-8). Recipes [bring-in-a-corpus](https://docs.pnbr.io/guides/bring-in-a-corpus.md) and [new-edition](https://docs.pnbr.io/guides/new-edition.md). Problems [entity-time-lost-after-edit](https://docs.pnbr.io/troubleshooting/entity-time-lost-after-edit.md) and [entities-cite-replaced-version](https://docs.pnbr.io/troubleshooting/entities-cite-replaced-version.md). ## Keep going [File](https://docs.pnbr.io/concepts/file.md) · [Passage and citation](https://docs.pnbr.io/concepts/passage.md) · [Entity](https://docs.pnbr.io/concepts/entity.md) · [Bring in a new edition of a document](https://docs.pnbr.io/guides/new-edition.md) · [An entity lost its time after an edit](https://docs.pnbr.io/troubleshooting/entity-time-lost-after-edit.md) Penumbra Grammar 0.6.26 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.