Working with Widgets > 2D > File
  
File
* 
The file widget does not work in offline experiences on iOS. This is because iOS security for external files does not allow you to open local files in web view.
What Does This Widget Do?
The File widget allows you to include a link to a file from within your experience.
When Should I Use This Widget?
Use a file when you want to give an experience viewer access to a file.
Are There Any Special Properties, Services, Events, or Actions?
To view a list of common widget properties, services, and events, see Common Widget Properties, Services, and Events.
The following table is a list of properties that are specific to this widget.
Property
JavaScript
Type
Description
Text
text
string
Text that appears as the link.
File URL
url
string
To include a file, you can do one of the following:
• Click next to the field to add a new image file.
• Enter or copy and paste a file URL directly into the field.
• Select a file from the drop-down menu.
* 
The device used for viewing experiences and the file viewing apps installed on it will determine which files an experience user can open and view.
The Widget in Action
Here’s an example of what your widget might look like!
Minimum Steps Required for Use
What It Looks Like
1. Drag and drop an File widget onto the canvas.
2. Enter the link text you want to display in the Text field.
3. In the File URL field, select an existing file, add a new file, or enter the URL to the file you want to display.
Style the Widget with CSS
You can use CSS to style the widget! The following is an example of a CSS class you could create and apply:
* 
Keep in mind that it’s best to give your classes unique names so they do not conflict with other classes or OOTB properties.
CSS Example
What It Looks Like
.ptc-file {
font-size: 18px;
font-family: Century Gothic;
font-weight: bold;
text-decoration: underline;
color: rgb(0, 122, 62);
}
For more information on implementing CSS classes, see Application Styles.