Roll20 Wiki

<noinclude>{{revdate}}{{clear}}{{main|Journal}}
{{SidebarNav}}
[[Handouts]] are found and managed on the {{Journal}}, and only a [[GM]] can create them. They work differently than [[Journal#Character|Characters]].
{{#evp:youtube|hLELEovjrDQ|Characters, Handouts, and Folders|right|600}}</noinclude>
Handouts are very similar to Characters, and have some of the same fields. 

== Handout Dialog ==
When you click on a '''Handout''' in the '''Journal Listing''', it will open the '''Handout Dialog'''.  This is where you view the contents of the '''Handout''', including the '''Image''' (if one is associated), the '''Description &amp; Notes''' text (if any has been entered) and the '''GM Notes''' (if the viewer is a GM).  

If you include an image that's larger than the '''Handout Dialog''', a magnifying glass will appear over the image when you view the '''Handout'''. Clicking on the image in the '''Handout Dialog''' will display either the original dimensions or a full-screen version of that image.

The '''Name''' of the '''Handout''' will be shown across the top of the '''Handout Dialog''' with several buttons:

=== Pop-Out Button ===
[[File:ShowPopupButtonPictosPipe.png|left]]
This button is to the left of the '''Name''' and looks like two overlapping rectangles.  Clicking it will open the character/handout in a separate browser window from your primary Roll20 window, which can then be moved independently, viewed side-by-side with your Roll20 Game page, moved to a different monitor, or switched between with your operating systems native commands.

{{orange|See '''[[Character_Sheets#Character_Sheet_in_a_separate_window|Character Sheet in a separate window]]''' for issues & limitations of character sheets when they are popped out. Some sheet features don't work when they are popped out. }}

=== Show To Players Button (''GM Only'') ===
This button is to the right of the '''Name''' and allows the GM to cause the '''Handout Dialog''' to be displayed on the screens of any players that can '''View''' the '''Handout'''.  If no players can '''View''' the '''Handout''', a dialog will prompt the GM and ask if it should be shared with all players.  Clicking '''Show to Everyone''' will insert '''All Players''' into the '''In Players&apos;s Journals''' field of the '''Handout''' (see below).

=== Edit Button ===
The GM always has this button, as do any players that can '''Edit''' the '''Handout''' because of inclusion in '''Can Be Edited By''' (see below).  Clicking this button will move the '''Handout Dialog''' into the '''Editing''' view.

== Editing ==
[[File:EditHandoutDialog.png|right|border|300px]]
The '''Editing''' view of the '''Handout Dialog''' allows GMs and players who can '''Edit''' to make changes to the '''Handout'''.

Handout Editing & Formatting:

You can copy-paste content from outside Roll20 into the Editor, and the styling will stay, enabling you style your handouts, beyond the editor's normal tools.
* [[Journal#Journal_Command_Buttons|Journal Command Buttons]]
* [[Journal#Link Between Journal Entries|Link Between Journal Entries]] 
* [[Journal#Linking to a Compendium Page|Linking to a Compendium Page]]
=== Name ===
You can change the default text of '''''Mysterious Note''''' to whatever you like.  This will be the title of the '''Handout''' in the '''Journal''' tab, and will show across the top of the '''Handout Dialog''' when it is opened.

=== In Player's Journals (''GM Only'') ===
Just like for '''Characters''', the [[GM]] is the only person that can see a '''Handout''' by default.  You can allow viewing by select [[players]] by putting their name in this field, or select '''All Players''' to allow access to all. Players with a '''Handout''' in their journal will be able to view it whenever they like.  It will be shown in whatever folder the GM has put it in, complete with the name of the folder.  You may want to move a handout before allowing your players to view it (For example, if it is in the ''Cursed Items'' folder).

You can also drag and drop a Handout from the Journal tab in the right sidebar onto a player.  That player will be given permission to view the Handout, and it will also appear on their screen immediately.

=== Can Be Edited By (''GM Only'') ===
Similar to the '''In Player&apos;s Folder''', by default only the GM can edit a '''Handout'''.  Placing a player's name in this field allows that player to both '''View''' and '''Edit''' that '''Handout'''.  This is particularly useful for allowing players journals or secret notes for correspondence with the GM.  The same notes about folders apply as with the above.

=== Tags (''GM Only'') ===
The '''Tags''' field allows you to assign words to associate with this '''Handout''' which are useful for finding it later via the '''Search''' field or the '''Tag List Dropdown'''.

=== Image ===
You can upload an '''Image''' to represent this '''Handout''' in the '''Journal''' listing.

Either drag & drop an image from your computer, or drag a& drop an image from your {{Art Library}}.

=== Description &amp; Notes ===
This field lets you associate a freeform block of text with the '''Handout'''.  This text is visible to players that can '''View''' the '''Handout''' and editable by players that can '''Edit''' the '''Handout'''.

=== GM Notes (''GM Only'') ===
This field is just like '''Description &amp; Notes''' save that only the GM can edit and view it, regardless of other settings.

=== Duplicate Handout (''GM Only'') ===
The {{button|Duplicate}}-button creates a copy of the handout, named "Copy of (name of handout)", which will appear at the bottom of the journal. Multiple copies of the same handout will all be named "Copy of..." when created, though these can all be renamed as needed.

=== Archive Handout (''GM Only'') ===
The {{button|Archive}}-button will move the '''Handout''' to a special area where it will no longer show up in the '''Journal Listing''' or in results from the '''Search''' field or '''Tag List Dropdown'''.  Archived handouts can be accessed in the '''Archived Handouts Dialog''' at the bottom of the '''Journal Listing''', and can be restored there.

=== Delete Handout (''GM Only'') ===
The {{button|Delete Handout}}- button will prompt for confirmation and then permanently remove the '''Handout''' from the '''Game'''.

<noinclude>
=Journal Options=
main: {{Journal}}
== Link Between Journal Entries ==
[[File:Journallinkss.png|540px|right]]
You can easily create links between your Journal Entries(Handouts & Characters).

Put single brackets around the name of a character or handout (for example: <code>“[Mr. Bearington] is most-known for his long, flowing hair”</code>), and when you save the entry, it will automatically create a clickable link to the other journal entry. Links to other handouts are purple, while links to compendium entries or other hyperlinks are blue.

It works both inside and outside the app, and it’s smart enough to obey [[player]] permissions as well (so a player can’t open a handout they don’t have access to, even if they see a link to that handout).

You can use the links in [[#Bio_.26_Info_Tab|character bio]], GM notes (both for characters and [[tokens]]), and for handouts in the '''Description & Notes'''-field. Use links to tie entries together, or even create a “table of contents” page for your game to quickly access your most-used journal items.

[[File:Link-handouts.gif|thumbnail|center|800px|Example of creating a link from one journal entry to another, and using it to open the other handout.]]

==Linking to a Compendium Page==
If your game uses a {{Compendium}}, links to that compendium in handouts and character sheets will automatically open a handout from the in-app compendium. Use the full URL in the link in the text editor, including the <code>https://</code> part of the URL, but do not include bookmarks and arguments (anything that's after a <code>?</code> or <code>#</code> in a copied URL).

If you access the [[External Compendium]], you can search and navigate to the pages you want and simply copy the URLs from the address bar.

{{ex}}

To link to the [[5E|D&D 5E]] Rogue's compendium page, save the following as the link in the handout: <code><nowiki>https://roll20.net/compendium/dnd5e/Classes:Rogue</nowiki></code>

== Journal Command Buttons ==
{{#evp:youtube|pkDC-nP3vCE|Running Commands from Handouts by Nick Olivo|right|400}}
Within the [[Journal#Bio_.26_Info_Tab|Bio & Info]] and [[Journal#GM_Notes_Field|GM Notes]] text fields of a Character, or the [[Journal#Description_.26_Notes|Description & Notes]] and [[Journal#GM_Notes_.28GM_Only.29|GM Notes]] text fields of a Handout, you can create '''Journal Command Buttons'''; special hyperlinks that can output macros to the Text Chat when clicked.

Here's how to create a Journal Command Button within one of the aforementioned fields:
# Insert a link using the link button on the redactor toolbar.
# At the very start of the "URL" field of the Link Window, type a backtick character: <code>`</code>
# Add in your macro code after the <code>`</code> character.
# Give your Journal Command Button a label using the "Text" field.
# Press the "Insert" button and Save Changes; you have created a Journal Command Button!
<br>

Another way to create Journal Command Buttons is to copy and paste an [[API:Chat#API_Command_Buttons|API Command Button]] or [[Macros#Ability_Command_Buttons|Ability Command Button]] from the Text Chat into one of the aforementioned text fields.

'''Note:''' Journal Command Buttons will not work if you have the [[My_Settings#Use_Window_Popouts_for_Characters|Use Window Popouts for Characters]] option enabled.

== External Journal Access ==
{{main|External Journal}}

{{:External Journal}}

=Related Pages=
* {{Journal}}
** [[Character]]
** [[External Journal]] - {{Plus}} feature
** [[Journal#Journal_Command_Buttons|Journal Command Buttons]]
** [[Journal#Link Between Journal Entries|Link Between Journal Entries]]
* [[Video Guides#Handouts]]
<br><br>
[[Category:Game Management]]</noinclude>