Feathery Docs
HomeCommunityGitHub
  • Platform
    • Quickstart
    • Form Fields
      • Hidden Fields
      • How to Set Field Values
      • Link Fields Across Forms
      • Custom Field Input Format
    • Build Forms
      • Elements
        • Basic
          • Container
          • Button
          • Text
          • Progress Bar
          • Image
          • PDF Viewer
          • Video
          • Table
          • Tooltip
        • Fields
          • Address
            • Street Address Line 1
            • Street Address Line 2
            • City
            • State
            • Country
            • Zip Code
          • Button Group
          • Checkbox
          • Checkbox Group
          • Color Picker
          • Combobox
          • Dropdown
          • Dropdown Multiselect
          • Date Selector
          • Time Selector
          • Email
          • File Upload
          • Matrix
          • Number
          • Password
          • Picture Choice
          • Pin Input
          • Phone Number
          • Radio Group
          • Rating
          • Signature
            • Legally Binding Signatures
          • Slider
          • Social Security Number
          • Text Area
          • Text Field
          • Payment Method
          • URL
        • Custom HTML, JS, CSS, and Iframes
        • Custom Fields
      • Design
        • Reuse styles and elements
          • Styling
          • Assets
        • Alignment and Spacing
        • Sizing Forms and Elements
        • Responsive Layouts
      • Actions
      • Logic
        • Navigate Steps Conditionally
        • Show Elements Conditionally
        • Custom Field Validation
        • Available Conditions
        • Display Dynamic Text
        • Dynamically Repeating Containers
      • Advanced Logic & API Connections
        • Visual Rule Builder
          • Connect to API Action
            • Salesforce API Connector
          • Set Field Value Action
          • Navigate Step Action
          • Set Field Error Action
          • Open URL Action
          • Set Calendly URL Action
        • Javascript Rule Builder
          • API Connections in Code
          • Trigger Integrations from Logic
          • Reusable Logic Configs
        • Examples
          • API Connectors
            • Dynamic dropdown options
            • Dynamic form navigation
            • Pre-fill form from Salesforce
            • Pre-fill form from Hubspot
            • Pre-fill field options from Google Sheets
            • Generate ChatGPT Message
          • Field Validation
            • Complex Field Validation
            • Date and Time Validations
          • Initialize Date Field
          • Dynamically set field placeholder
          • Randomize Field Option Order
          • Update field options based on previous selection
      • Integrations
        • Event Triggers
        • Examples
          • Upload Files to Google Drive
      • Dev & Staging Environments
    • Launch Forms
      • Embed Your Forms
      • Custom URLs & SEO
      • User Tracking
      • Completion Criteria
      • UTM Parameters
      • Accessibility Standards
      • Analytics
      • A/B Testing
      • Offline Mode
    • Document Intelligence
      • Review Extractions
      • Post Processing
      • Supported Document Types
      • Prompting Guide
      • Examples
        • Investment Report
    • Document Autofill & Signatures
      • Autofill Document Templates
        • PDF Autofill
        • Word Doc Autofill
          • Dynamic Tables
        • Excel Autofill
        • InDesign Autofill
      • Signature Workflows
        • Signature Notifications
        • Access Signed Documents
        • 21 CFR Part 11 Compliance
      • Export Form Submission PDF
    • Workflows
      • Collaboration
        • Email Invite
        • Start Directly
        • Anonymous Starts
      • Review, Edit & Approve
      • Unique Submission Links
    • Enterprise Compliance
      • Security and Privacy
      • Reliability and Performance
      • Document Management
      • Data Sovereignty
    • International Forms
      • Translate Forms
      • Right to Left (RTL) Support
      • International Form Fields
    • White Label Feathery
      • Build Custom Form Fields
      • Offer Custom Form Templates
      • Custom Dashboard Domain
    • Account Settings
      • Managing Your Team
      • Permissions and User Groups
      • Account Attributes
    • FAQs
      • Account & Billing
  • Guides
    • Verify Submissions & Prevent Spam
    • Build a Login or Verification Flow
      • Connect an Auth Integration
      • Add Auth Methods
        • Email SMS Code
        • Email Magic Link
        • Phone Number Verification
        • Social Logins
          • Google
          • Amazon
          • Apple
          • Bitbucket
          • Coinbase
          • Discord
          • Facebook
          • GitHub
          • GitLab
          • LinkedIn
          • Microsoft
          • Slack
          • Twitch
          • Twitter
      • (Optional) Require Auth for Onboarding Steps
      • (Optional) Add Login Flow to Your Site
        • Feathery-Hosted (Recommended)
        • Embed Login Flow
          • Login Embed Tutorial
    • Build a Payment Flow
      • Connect to Stripe
      • Select Products or Plans
      • Collect Payment Method
      • Purchase Products
    • Send Custom SMS Messages
    • Salesforce Picklist Options
  • Developers
    • React SDK
      • API Guide
        • init()
        • <Form>
          • contextRef
          • Event Handlers
            • onSubmit()
            • onLoad()
            • onChange()
            • onAction()
            • onError()
            • onFormComplete()
            • onView()
          • Custom JSX Components
          • PopupOptions
          • initialLoader
        • getFieldValues()
        • setFieldValues()
        • updateUserId()
        • Login API
          • <LoginForm>
          • useAuthClient()
      • Inline vs Popup Form
    • Javascript SDK
    • Context API
      • Field Object
      • field.setStyles()
      • Deprecated Context API
    • REST API
Powered by GitBook
On this page
  • Demo Video
  • Intro to Collaboration
  • Define your collaborator settings
  • Choose how to start the submission(s)
  • User Groups
  • Completion Criteria
  • Track Pending Collaborator
  • Send Custom Emails to Collaborators
  • End User Collaboration Control
  • Prefill Feathery Account Info
  • Custom Logic with Active Collaborator
  • Collaborator Info in Logic Rules
  • Task View
  • Audit Logs

Was this helpful?

  1. Platform
  2. Workflows

Collaboration

Feathery supports advanced collaboration use cases for form workflows.

PreviousWorkflowsNextEmail Invite

Last updated 10 months ago

Was this helpful?

Demo Video

Intro to Collaboration

Feathery allows form designers to invite multiple users to collaborate on a single form submission. They can specify the number of collaborators, assign fields, ordering, and more.

In order to use collaboration with your form, you must first enable form collaboration in form settings and save your settings.

Once enabled, you may define collaborator settings in the same place (form settings) or on the user collaboration dialog available from the form publish dropdown (see below).

Collaboration workflows are accessible via your form publish dropdown, towards the bottom.

Define your collaborator settings

You have the ability to specify how many people will be collaborating on a single submission, along with which fields each collaborator will be able to fill out. You can also specify if you want them to fill out the form sequentially or not via the Set Collaborator Order toggle.

Feathery stores your configuration into a template, so it's easily accessible the next time you're looking to invite users.

Choose how to start the submission(s)

User Groups

Completion Criteria

Now that there are multiple collaborators on a submission, the submission isn't considered "complete" until each one of the collaborators has completed their section. You should set up your event triggers accordingly.

Track Pending Collaborator

For ordered collaborative submissions, you can track the current collaborator whose turn it is to work on the submission. For unordered submissions, you can view all collaborators who still need to complete the submission.

To do this, go to your form results and click Edit Table View. Then, update your table view with a column for the Pending Collaborator attribute. Collaborative submissions will automatically show the pending collaborator in that column.

If you're an admin or the pending collaborator, you can click on the submission and see a button called Open Collaborative Submission, which you can click on to continue working on that collaborator's part of the submission.

Send Custom Emails to Collaborators

End User Collaboration Control

Standard and custom account attributes can be prefilled into a collaborative submission when the owner of a Feathery account is the one who's filling out their portion of a collaborative submission. There are two ways you can do so:

  1. Select a field in the designer, go to the Properties tab, Semantic Meaning section, and set the Attribute to the relevant information you'd like to prefill. Then, the account attribute will automatically be prefilled into this field when they load the collaborative submission.

  1. You can access the relevant attribute via the special hidden field feathery.account.<attribute name>. E.g. if you have an account attribute called First Name, you can access its value via the feathery.account.first_name hidden field.

Custom Logic with Active Collaborator

You can add custom logic to your form that is based on the currently active collaborator on the submission. To do this, use the special hidden field: feathery.collaborator. This is supported in:

  • Custom Validations

  • Show or Hide rules

  • Conditional navigation

  • Logic Rules.

For example, you may wish to hide certain form fields based on the specific collaborator combined with other conditions. The feathery.collaborator hidden field contains the label of the collaborator as configured in settings (see above).

Collaborator Info in Logic Rules

Collaborator Property
Type
Description

label

string

The collaborator label as defined in the collaborator template configuration. Read-only.

orderNumber

number

The order/position of the current collaborator in the collaborator template configuration. Starts at 0. Read-only.

permission

string

The collaborator's form fields access: 'custom' or 'all'. Read-only.

permissionFields

string[]

If permission is 'custom', then this is an array of field keys.

Task View

Feathery also provide a Task view for logged-in users to see all currently assigned tasks (which are form submissions that they've been invited to collaborate on). From this view, they can filter for current or past tasks and complete them. Admins can also see every pending task across their organization.

Audit Logs

  • Invited

  • Viewed the form

  • Edited the form

  • Completed their part of the form

Feathery supports assigning tasks to a collection of users such as a User Groups (defined ) and lists of email addresses. This is useful for assiging tasks to an internal department, for example. Any user in that User Group can claim the collaboration task and complete it. If another user tries to complete the task after it has been claimed, they will be notified that another member has already claimed the task.

When your collaborator template is defined, you'll now see a toggle on your that allows you to define the email recipients as the collaborators on the form submission. This is useful if you want to send a custom email to all of the users who collaborated on a submission.

You have available to set on your form to allow your end users to control the collaboration routing sequence.

Prefill Feathery

Feathery forms make additional information about the active collaborator available within via the feathery.collaborator global object. The collaborator object is a sub-property of the feathery object that is available as a global in all logic rules. The feathery global is documented in the . All properties are READ ONLY.

When the collaboration template is defined, you'll be able to attach an audit log to emails sent out via your . The audit log will contain IP address and timestamps for when each collaborator was:

Invite (and bulk invite) all collaborators via email
Start a submission immediately
here
email integration
collaboration-related click actions
Account Info
advanced logic rules
Context API
email integration