--- title: Manage custom properties slug: manage-custom-properties description: Setting up and utilizing custom properties in Roster allows brands to collect specific information from ambassadors and manage data efficiently. docTags: createdAt: 2024-12-11T23:15:57.699Z --- Setting up and utilizing custom properties in Roster allows brands to collect specific information from ambassadors and manage data efficiently. These properties can be used in application forms, to filter contacts, or internally within the Roster platform. By customizing the information you collect, you can easily search and filter contacts based on custom properties, improving the ability to manage ambassadors effectively. This guide will walk you through accessing, creating, and managing custom properties in Roster. *** ## Step-by-step instructions ::::WorkflowBlock :::WorkflowBlockItem ### Navigate to the properties page 1. Click on your brand logo in the bottom of your left hand navigation 2. Select `Brand settings`and click on `Custom properties`tab ::: :::WorkflowBlockItem ### Edit an existing custom property 1. Click `Edit` next to a custom property to see its details. 2. Review or modify the `field type`, `public label`, and `internal label`. 3. Decide if the property should be `searchable in contacts` or `pinned to the contact drawer`. ::: :::WorkflowBlockItem ### Add a new custom property 1. Click `Add Property`. 2. Select the `field type` from the following options: - `Date ` - The date property accepts any date as input. This is useful when you need to collect and filter by a date value, such as when an ambassador did or earned something like an industry certification. Date properties can be used as a filter the Contacts search page. - `Multiple Choice` - The multiple choice property displays all the options in a list with radio buttons, much like a multiple choice test question. This is useful when there is a small number of options from which you want the user to select. Multiple choice properties can be used as filters on the Contacts Search page. - `Short Answer` - The short answer property allows the user to enter a value up to 50 characters in length. This is helpful when you want free-form but limited responses from users. Short answer properties can be used as filters on the Contacts Search page. - `Paragraph` - The paragraph property allows users to enter a value up to 1,000 characters in length. This type is useful when you need to collect a more detailed response from an applicant or ambassador. Paragraph properties **cannot** be used as filters on the Contacts Search page. - `Drop Down` - The drop down property allows users to select a singe value from a drop down list of values. This is useful for when you want users to select from a long list, making the multiple choice less convenient. Drop down properties can be used as filters on the Contacts Search page. - `Checkboxes` - The checkbox property allows users to select more than one answer, making it useful for collecting structured feedback when more than one answer might apply. Checkbox properties can be used as filters on the Contacts Search page. - `File Upload` - The file upload property allows users to upload files PDF, JPG, and PNG files. This is useful when you need to collect information such as industry certification, tax docs, signed contracts, etc. File upload properties **cannot** be used as filters on the Contacts Search page. 3. Save the new property. ::: :::WorkflowBlockItem ### Use custom properties in the contact drawer 1. View a contact's profile to see pinned custom properties. 2. Click the `edit` icon next to a property to update it. ::: :::WorkflowBlockItem ### Filter contacts using custom properties 1. Access the contact search and click `Add Filters`. 2. Scroll to the `CUSTOM` section and select a property. 3. Filter the contact list by the chosen property's value. ::: :::WorkflowBlockItem ### Use custom properties in application forms 1. Click `Programs` in the left navigation. 2. Access `Program settings` for the desired program. 3. Click `Edit` within the `Application form` section. 4. Click `Form questions` from the left panel. 5. Scroll down to the `Custom Questions` section. 6. Add new custom questions or select from existing custom questions. 7. Mark questions as required if needed. - Note: marking a question as required is specific to the form. As such, you can use the same custom question two different programs' applications forms and one could be optional and the other could be required. ::: :::WorkflowBlockItem ### Use custom properties in ambassador campaigns 1. Click to edit an ambassador campaign. 2. Scroll to `Ambassador Custom Properties`. 3. Click `Add Property` to select properties like t-shirt size. 4. Set properties as required if applicable for the campaign. ::: :::WorkflowBlockItem ### Ambassador portal experience with custom properties 1. When ambassadors log into their portal, they will see `Brand questions` as an item in their onboarding checklist. Any custom question that appears on the program's application form will appear in the Brand questions section. 2. Ambassadors can also access the `Brand questions` by clicking the hamburger menu, then selecting `Account settings` > `Brand questions` 3. When an ambassador joins a campaign that has custom properties, they will be prompted to answer the questions before accessing the campaign brief. ::: :::WorkflowBlockItem ### Examples of property use Collect custom data from ambassadors such as: - Why do you love our brand? - Have you purchased from us before? - What is your favorite food? ::: :::: *** ## Need help? If you need any additional assistance with with your Roster account, feel free to contact our support team at [support@getroster.com](mailto\:support@getroster.com). We're here to help!