Table of contents
Creating an app
To create an app:
- Go to Box Apps.
- Click New.
- Name your app.
- You land on a page with an empty section.
- Name the first section.
- Configure the app by adding blocks to your first section and/or adding more sections.
- When you finish adding sections and blocks, click Done to save your app.
The Done button is inactive if you forgot to add parameters to any of the sections or blocks.
Configuring a section
Choose how you want to display the blocks in your section – select Grid or List in the Section area under Configure App.
You can also use a context menu that appears when you select a section. Click the Layout icon and select Grid Layout or List Layout.
The grid view displays blocks in your section next to each other. The list view displays blocks in your section under each other.
To delete a section, select it and click the trash icon from the context menu.
Adding, deleting, and configuring blocks
To add a block, drag and drop it to your section from the Blocks area under Configure App, or choose the + Add Blocks drop-down list in a section to add a new block to your app.
To delete a block, select it and click the trash icon from the context menu.
You can add the following blocks:
- View
- Text Block
- File or Folder
- Form
- App
- Shortcut
- Auto Filer
Required and optional block parameters
There is one required parameter for all blocks: Title/Tile Name. You need to add it to every tile to save your app. Other required parameters differ depending on the block type.
Optional parameters are the same for every block type:
- Description – click Add Optional Description to display the Description field.
To add more lines to the field, press enter. Click Hide Description or delete the contents of this field if you want to remove it.
- Theme – choose a color theme. Select Light to choose a color for the block icon. Select Dark to choose a color for the whole block.
The default values for block names are:
- View: Create a View
- Text: Create a text block
- File or folder: Create a file or folder
- Form: Create a form
- App: Link to an App
- Shortcut: Create a shortcut
- Auto Filer: Create an AutoFiler
Block types
Choose the block types you want to have on your app.
View block
Select the Create tab in Create a new View to configure the View block. Add the following parameters:
- View Name – name your View
- Metadata Template – choose one of the available templates from the dropdown list
Click Create to finish adding a new view block. Click the Hide Item Count toggle if you don’t want to show the exact number of view results.
Important:
Once you set the View name and choose the metadata template, these options can’t be changed.
See Configuring view for more information about View blocks.
You can also duplicate a view block. To do so:
- Select the Duplicate tab in Save Views & Parameters.
- Add a name to your View.
- Select a recent View from the Duplicate settings from drop-down list.
- Click Duplicate to save your View.
You can also add the optional description and a theme to the duplicated view block.
Text block
The text block contains only the optional parameters: Title/Tile Name, Description, and Theme. Add your text in the Description field.
File or folder
When you add a file or folder block, you need to specify a root folder where the app users will add new content. Click the Select Content button under Choose from Box. In the next window, you can see a standard search field and your All Files view. Select a folder and click Choose to go back to block configuration.
When you add a name, it changes the folder name in the block. The original folder name in your All Files is not changed.
Form
In a form block, you need to provide a Box Form to use and decide how you want to present it.
Select the specific form under Choose a Box Form by clicking the search field or start typing in the name of the Form to get a suggestion.
There are two options of the Presentation parameter: Overlay / Pop-Up and Open in New Tab.
App
The app tile links to another app you or another Box Apps Admin created. Click the Select an App field under Choose from Box to display the available apps.
Shortcut
Add a link in the Enter a URL field.
Auto Filer
Add Metadata to files or folders while they are uploading. You can add Metadata in the Current File tab. Select the desired Metadata Template from the drop-down list.