Only enter basic, non-negation tags on files.
Entering pagination or advanced search tags on files won't be useful, since pagination and search-related tags will always be used for their special meanings and can't be searched for as normal tags.
| Property | Description |
|---|---|
| Publish date |
A user-specified date meant to represent when files were created or published.
Leaving this blank will set it to the current datetime. Several date formats can be parsed correctly, but it's recommended to use Atom format (Y-m-d\TH:i:s\Z) e.g. 2006-01-07T13:53:10Z You can nudge the creation date by entering + or - and then an amount of time to adjust the current publish date by, e.g. +1d3h22s. Valid nudge increments are y (years), w (weeks), d (days), h (hours), m (minutes), s (seconds). Used as the default order of files in normal search results. This can be set to any date, and is mostly meant to be used to backdate older files that weren't uploaded until after their creation. But it can also be used to postdate files for future automatic publication, because files with future publish dates will not be returned in public searches. Be aware that even if a file isn't returned in a public search result, the file view page and the actual file can be accessed by anyone with the url |
| Owner |
The token that has ownership of a file.
This is mostly leftover from persephone, there shouldn't be much need to keep track of who stored which files. |
| Search management mode is a special state which allows you to select multiple files by their thumbnails and apply actions to them. Search management mode requires JavaScript and is available on any file search page. |
| Toggle search management mode by clicking "Search management" in the top menu, or by pressing "E" on the keyboard. You can leave search management mode either by toggling again or by pressing "Escape" on the keyboard. |
| Clicking a thumbnail while in search management mode will toggle select on that file. You can also click and drag to select a group of files. |
| Most search management mode actions should be self-explanatory, and have counterparts on the individual file edit pages, but note that because search management mode is based around being able to select multiple files the state of the forms that appear in search management mode do not reflect the current state of any files selected. |
| Always pay attention to the actual files you're selecting. |
| e | Toggle search management mode |
| Esc | Exit search management mode |
| t | Add tags |
| r | Remove tags |
| s | Generate set | = | Select all | - | Select none |
| Del | Remove files |
| Shift | Hold while drag-selecting to add new selection to already selected files |
| Ctrl | Hold while drag-selecting to remove new selection from already selected files |
| Some tags have a special meaning that can affect how a file's view page and thumbnail are displayed. | |
| #_:{tag} | Used to prevent this tag from showing in Tags this page, in thumbnail titles, and underneath files on the view page. |
| #hidden |
Used to prevent a file from being returned in public search results except for admin and helper tokens.
Unlike persephone, because there are no user accounts, there is no included option to limit who has access to certain files. Be aware that even if a file isn't returned in a public search result, the file view page and the actual file can be accessed by anyone with the url |
| #protected |
Used to prevent a file from being returned in public search results except for admin, helper, and viewer tokens.
Unlike persephone, because there are no user accounts, there is no included option to limit who has access to certain files. Be aware that even if a file isn't returned in a public search result, the file view page and the actual file can be accessed by anyone with the url |
| #r18 |
Used to indicate if a file is explicit and intended for mature audiences over the age of 18.
Thumbnails in search results will show an indicator and will be blurred (unless the user has selected to show R-18 files in Preferences). |
| #hide tags | Used to prevent tags from being displayed below a file on the view page. |
| #hide file container |
Used to prevent the file container from being displayed around a file on the view page.
(This currently breaks comments and the javascript tag editor for the files it's used on). |
| #focus:{int 0 to 100} |
Used to adjust which part of a non-square visual file's thumbnail is visible (for users which have not selected Uncropped thumbnails in preferences).
#focus:0 moves the thumbnail focus to the left edge for landscape files, or the top edge for portrait files #focus:100 moves the thumbnail focus to the right edge for landscape files, or the bottom edge for portrait files |
| #set:{set name} |
Used to create visual set groupings below a file on the view page.
{set name} can be any text string but should probably be something you can remember and re-type if you're adding it to multiple files manually. By default the order that set files appear in the set is by their Publish date from earliest to latest, but this can be overridden by adding :{weight} to the set tag after {set name} (e.g. #set:some set name:5) in which case the file with {weight} will appear after any files without {weight} and be sorted among any other files with {weight} from least to greatest. If two files in a set have the same {weight} then they will be sorted by their respective Publish dates from earliest to latest You should avoid choosing set names that contain a colon ( A file can be part of multiple sets, in which case multiple set containers will appear below the file. |
| #cover:{file ID} |
Used to make the thumbnail of another file appear for the file you've added the tag to.
This is mostly useful for audio/text/archive/application files, which normally only appear as a filetype placeholder icon. In addition to displaying a thumbnail in search results and in set lists, for audio the cover file will appear above the actual player on the view page. |
| #mirror:{URI} | Used to specify a mirror of a file at an outside URI |
| #superior of:{file ID} | Used to indicate when a file is a superior version of another file |
| #inferior of:{file ID} | Used to indicate when a file is an inferior version of another file |
| #description:{text} | Used to display some short plaintext below the info bar on the view file page |
| #description:file:{file ID of text file} |
Used to display a rendered text file below the info bar on the view file page
Be sure to add a text rendering tag (described below) to the referenced file if the file is anything other than plain text |
| #text:plain | Used to display the actual text contents of a file on the view file page (escaped, so that markup contained in the file can't affect its display) |
| #text:html fragment | Used to embed the actual text contents of a file on the view file page (unescaped, so that markup contained in the file can affect its display) |