List app

The List app is useful for managing various everyday tasks, including order lists for office supplies, company vehicle management, and dynamic lists for telephone numbers. You can allow users to create list entries to add information to the list.

Set up the app

Once you've added a List app to your page or community, you can configure it. Also, read Apps overview for general information on apps.

  • Name: Give your app a meaningful name that best reflects its topic and use case.
  • Activate this app: Activate it immediately or leave it in the deactivated mode. A deactivated app is only visible to admins of a page or community. The app is in draft mode.
  • URL: By default, the URL is generated from the app's name, but you can change it to something else. Any old links leading to the app won't work anymore after you change it.
  • Element name: Define the name that is shown in the list overview.
  • New entry notification: Depending on your selection, no one, all subscribers, or only admins of the page or community will be notified when new list entries are added.
  • Permissions: Define what regular users can do in the app. Some permissions are connected; that is, if View entries are set to No, Edit entries and Delete entries are also set to No. This is because users cannot edit or delete entries that they cannot see.
    • Create entries: Users can create entries in the app
    • View entries: Users can see the entries in the app
    • Edit entries: Users can edit entries in the app
    • Delete entries: Users can delete entries in the app

Create a list

To be able to create list entries, you need to add and configure the fields to fill in. You need to be a page or community admin with "Manage apps of a page/community" permission to configure the list fields.

  1. Select Add field
  2. Select a field type that best fits with your list's use case.
  3. For each field type, you can always configure the fields listed below. Additionally, every field type has its individual configuration settings that are explained in the table.
    • Name: Enter a descriptive name for the field. The name is displayed when making an entry and in the list overview. This field is mandatory.
    • Required: Check if you want the field to be required to fill out when making a list entry.
    • Hidden: Check if you want the field to be hidden in the list overview. A hidden value is shown when opening the list entry detail view or exporting the entire list.
    • Description: Provide a description for the field. This description will be displayed above the field as help text to guide users when filling it in. This field is optional.
    Field type Description Individual configuration options (optional)
    Checkbox

    Adds a checkbox. Users can check it or leave it unchecked.

    Displays or for checked/yes or unchecked/no, respectively.

    • Choose whether the checkbox is preselected or not.
    Date Adds a date field. Users see a calendar drop-down and can select a date.
    • Enter a placeholder to indicate what the field should display
    File Adds a Select file button. Users can select a file from their file library or upload a new file. Files are stored in the page or communities file library.
    • Choose if multiple files can be uploaded. If unchecked, only one file can be uploaded.
    Link Adds a link field. Users can paste a valid link starting in http:// or https://.
    • Choose if the link is opened in the current window. If unchecked, the link opens in a new window.
    • Enter a placeholder to indicate what the field should display
    Number Adds a number field. Users can input only numbers, not text.
    • Define a minimum and maximum value that can be entered.
    • Enter a placeholder to indicate what the field should display
    Options Adds a drop-down menu of choices to choose from. Users can select one or many, depending on the configured settings.
    • Choose if multiple options can be selected.
    • Enter all the options that are presented to the user to choose from. You can reorder the options by dragging and dropping.
    • Enter a placeholder to indicate what the field should display
    Text Adds a text box. Users can add unformatted text. If no minimum or maximum limit has been set, there is no limit on the text answer.
    • Define a minimum and maximum length for the entered text.
    • Decide if the text field should display as a larger text box for multiple lines of text. If unchecked, the text field is a smaller single-line text box.
    • Enter a placeholder to indicate what the field should display
    User Adds a Select users user chooser. Users can select one or many users, depending on the configured settings.
    • Choose if multiple users can be selected. If unchecked, only one user can be selected.
  4. Repeat the process to add the fields that your list needs. Once a field is added, it is immediately included in the list.
    • There is no limit to the number of fields your list can have. You can also add the same field type multiple times.
  5. You can reorder your field types in the Configure fields view by dragging and dropping. You can also edit or delete a field. If you delete a field, all the entries in it will be deleted as well.

configure fields in a list app.png

Create a new entry

  1. Select Create a new entry / Create entry
  2. Fill in the list entry fields
  3. Select Save to add your entry

View list entries

Depending on the app's permission configurations, you can interact with and view list entries in the list overview.

  • Search: Search for any text found in a list entry field. This includes text, numbers, links, etc.
  • Configure fields: A page or community admin with the "Manage apps of a page/community" permission can configure the fields in the list.
  • Export current list: Download all list entries with only the details included in the list overview. Any hidden fields aren't included in the export.
  • Export entire list: Download all list entries with all details. Any hidden fields are included in the export.
  • Open detail view: Select the icon or the Open detail view option from the drop-down menu to view the full entry in a pop-up. The detail view shows all list fields, including any fields marked as hidden from the overview. You can also see an entry's history, i.e., when and by whom it was created and last edited.
  • Subscribe: If you subscribe to an individual list entry, you'll be informed if it's edited. The list entry creator is subscribed to their entry by default.
  • Edit: Depending on the app's permission configurations, you can edit an entry and its filled-in information.
  • Delete: Depending on the app's permission configurations, you can delete an entry.

List app interaction options.png

Was this article helpful?