Project Layouts and Fields | Online Help | Zoho BugTracker

Project Layouts & Fields

What is a Layout?

Project layout in Zoho BugTracker is used to create forms for collecting project details. You can create different project layouts based on your project requirements. Initially, all projects will be associated with the standard layout. If the standard layout is modified, the changes will reflect in all the associated projects.

What is a Section?

A set of sections form a layout. Similar attributes are placed inside a section. Every project layout will have two default sections - Project Information and Budget. You can also create your own section and use it in your layout. A section named Schedule Reviews can accommodate fields such as First Review, Second Review, and Third Review.

What is a Field?

Customize fields to collect project details based on your project requirements. You can add a new field or an existing field to your layout.
The default fields can neither be edited nor deleted. They can only be reordered. The following are the default fields in Project Information section of a project layout. 
  1. Start Date, End Date, Project Overview, Status, Group Name, and Completion Percentage
  • Feature Availability: Enterprise plan
  • Navigate to > Customization > Layouts and Fields > Projects to create custom fields for projects. If you are an admin but unable to access the above path, write to support@zohobugtracker.com
    •

    Standard Layout

    • Every project will have a default layout called the Standard Layout. All the projects in the portal will be associated with this layout. 
    • The standard layout has two default sections - Project Information and Budget.
      • The fields - Start Date, End Date, Project Overview, Status, Group Name, and Completion Percentage are the default fields in the Project Information section.
      • The fields - Currency, Billing Method, Project Budget, and Default Billing Status are the default fields in the Budget section.
    • The default fields can neither be edited nor deleted. 
    • You can add new sections and fields to the standard layout.

    Create Layout

    1. Click  in the upper-right corner of the top navigation bar.
    2. Navigate to Customization > Layouts and Fields > Projects.
    3. Click Create Layout in the upper-right corner.
    4. Select a base layout that you want to build (clone) your new layout on. If you haven't created any layouts, the standard layout will be listed in the drop-down.
    5. Enter a Layout Name.
    6. In Layout Permissions, select the user profiles who can access the project layout.
    7. Click Create.

  • Only the user based Enterprise plan can access this feature.
  • A maximum of 40 layouts can be created.
  • A layout can be associated while creating or editing a Project. You can also associate the layouts while creating or editing a Project Template. 
  • When a project is switched from Layout A to Layout B, the common fields available in A and B will be retained, however, the fields which are not common to the layouts will not be available and their data will be lost.
  • Associating a project with a layout will overwrite its current layout mapping if any.

    • Associate Layout with User Profiles

    1. Click  in the upper-right corner of the top navigation band.
    2. Navigate to Customization > Layouts and Fields > Projects.
    3. Click the plus icon  to the right of the selected layout.
    4. Select one or more user profiles from the drop-down to associate. 
    5. Confirm your action.
    6. Click Associate.
      1. To view the list of associated user profiles of any layout, navigate to  > Customization > Layouts and Fields > Projects > Layouts.
      2. The associated user profile names will be displayed below every layout.

    View or Edit Layout

    1. Click  in the upper-right corner of the top navigation band.
    2. Navigate to Customization > Layouts and Fields > Projects.
    3. In the Layouts section, you can view the list of project layouts that have been created already.
      • The layouts that are listed can neither be deleted or reordered.
      • You can associate a layout with any user profiles who can access that layout. 
    4. Click the layout you want to edit, do the necessary changes, and save.

    Delete Layout

    1. Click  in the upper-right corner of the top navigation bar.
    2. Navigate to Customization > Layouts and Fields > Projects.
    3. Click the Layouts section.
      • Hover over a layout that you would like to delete and click the trash icon .
      • Confirm your action.

    Create and Edit Section

    A set of sections form a layout. Similar attributes are placed inside a section. The standard layout of the project will have two default sections- Project Information and Budget. You can also create your own section and use it in the standard layout.

    1. Click in the upper-right corner of the top navigation bar.
    2. Navigate to Customization  > Layouts and Fields > Projects.
    3. Click a layout to add a section.
    4. Drag and drop the +Add Section component from the left tray to the layout editor (main panel). Initially, the sections will be named "Untitled Section", "Untitled Section 1", "Untitled Section 2" and so on as you keep adding new sections in the layout editor.
    5. Hover over the section name and edit it.
      • You can also add new or existing custom fields to your section.
    6. Click Save Layout.

    A section cannot be empty.

    Delete Section

    1. Click  in the upper-right corner of the top navigation bar.
    2. Navigate to Customization > Layouts and Fields > Projects.
    3. Click a layout to delete a section in the layout.
    4. Hover over the section and click the trash icon .
      • The  icon will be visible only when all the custom fields inside the section are removed. We recommend you to remove the custom fields first and then delete the section.
    5. Confirm your action.

    Create Custom Fields

    1. Click  in the upper-right corner of the top navigation bar.
    2. Navigate to Customization > Layouts and Fields > Projects.
    3. Click a layout to add a custom field.
    4. Drag and drop a field type from the New Fields tray into the layout editor (main panel).
    5. Set a Default Value if necessary.
    6. Select Mandatory checkbox if you want the field to be filled compulsorily. 
    7. Select Insert Tooltip checkbox if you want to set tooltip information for the field. 
    8. Click Add to Layout to include the field in the layout. When you Cancel, the field is never stored anywhere.
    You can create the following custom fields:
    1. Number: Store numbers in this field. A number can have a maximum of 19 digits. You can either store an integer or a decimal in this field.
    2. Single-Line text field: Add one line of text.
    3. Multi-Line text field: Add multiple lines of text. Hit Enter to key in more information.
    4. Pick-List field: Create your own drop-down using a pick list. Set values and wrap them under a pick list as per your business needs. Enter valid data in the editable text area and click Add Value. Click the cross icon  beside a value to delete it.
    5. Multi-Select Pick-List field: Create drop-downs with multiple selections.
    6. User Pick-List field: Use this field when you have to store usernames.
    7. Multi-User Pick-List: Use this field when you have to store and select multiple users from the drop-down.
    8. Date: Store dates in this field.
    9. Email: Store email addresses in this field.
    10. Phone: Store contact numbers in this field.
    11. URL: Store URLs or links in this field.
  • A maximum of 105 custom fields can be created.
  • Number, Single-Line text, Multi-Line text, Email, Phone, and URL fields can be marked as PII (Personally Identifiable Information). If you select Encrypt Field, the data will be encrypted at the backend.
  • These fields cannot be duplicated.
  • Removing a field’s association from a layout will not result in loss of data. However, deleting a field will delete the data.
    •

    Edit Custom Field

    1. Navigate to >  Customization > Layouts and Fields > Projects.
    2. Open the standard layout editor and hover over the custom field you would like to edit.
    3. Click the pencil icon .
    4. Edit the field properties except the field name. You can change the field name also but the new name will be reflected in all the projects.
    5. Click Save Changes.
    Custom fields can be edited only in the Enterprise plan.

    Reorder Custom Fields

    1. Navigate to > Customization > Layouts and Fields > Projects.
    2. Open the standard layout editor and hover over the custom field you would like to reorder.
    3. Drag and swap with another field in the editor. You can reorder fields as many times as you want until you get the desired order.
    4. Click Save Layout.

    Remove Custom Field from Layout

    1. Navigate to  > Customization > Layouts and Fields > Projects.
    2. Open the standard layout editor and hover over the custom field you would like to dissociate.
    3. Click the remove icon ().
    4. Confirm your action.
  • Removing a project custom field will not permanently delete it from the database.
  • The custom field will be moved to the Available Fields tray and it can be reused anytime later from this tray.
  • The data stored in the field will not be lost.

    • Delete Custom Field Permanently

    1. Navigate to > Customization > Layouts and Fields > Projects > Fields.
    2. Hover over the field you would like to delete.
    3. Click the trash icon .
      • Deleting a custom field will affect all the projects in the portal. 
      • The data stored in the field will be lost.
    4. Confirm your action.
    Deleting a field from a portal will permanently delete it from the database.

    Create or Edit Custom Project Status

    1. Navigate to  > Customization > Layouts and Fields > Projects.
    2. Click Standard Layout and hover over the Status field in the Project Information section.
    3. Click  on the right-side of Status.
    4. Click the +Add Status link to create a new status.
    5. Give a status name.
      • Clickto the left of the status name to assign a color. Pick any color from the palette that matches the status name and type.
    6. Set a default status.
    7. Click Apply Changes.