Bug Layouts and Fields | Online Help | Zoho BugTracker

Bug Layouts & Fields

What is a Layout?

Bug Layouts are used for creating forms where customers can fill details relevant to the bug. Create unique layouts based on the business requirement.

Initially, all projects will be associated with the standard bug layout. If the standard layout is modified, the changes will reflect in all the associated projects.

What is a Section?

The various parts of the layout are called a section. The standard layout has a default section called Bug information. You can customize each section by adding fields based on the requirements. 

What is a Field?

Customize fields to collect bug details based on your requirement. 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. Module, Severity, Reproducible, and Classification fields can be renamed.

Reporter, Assignee, Created, Last closed time, Modified, Due date, Status & Workflow, Severity, Release Milestone, Affected Milestone, Module, Classification, Reproducible and Flag are the default fields in a layout.

Standard Layout

  • Every portal will have a Standard Layout to start with.
  • The standard layout has one default section - the fields in this section can neither be edited nor deleted. They can only be reordered.
  • Users can clone the standard layout and create a new layout. After cloning, they will be able to add new sections and fields to the new layout.

Create Layout

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization >  Layouts and Fields  >  Bugs.
  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 have not created any layouts, the standard layout will be listed in the drop-down.
  5. Enter a Layout Name.
  6. Click Create.

  • The standard layout and the layouts associated with a project cannot be deleted. You can delete the layout after associating the projects to a different layout.
  • To view the list of layouts available in a portal, navigate to Portal Configuration  >  Layouts and Fields  >  Bugs  > Layouts.
  • You can also edit a layout's name by directly editing its name in the layout editor screen.

Associate a Project with Bug Layout

  1. Click  in the upper-right corner of the top navigation band.
  2. Navigate to Customization >  Layouts and Fields  >  Bugs.
  3. Click the plus icon  to the right of the selected layout.
  4. Select one or more projects from the drop-down to associate. You can also associate project templates with a layout.
  5. Confirm your action.
  6. Click Associate.

View Layout

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization >  Layouts and Fields  >  Bugs.
  3. In the Layouts section, you can view the list of bug layouts that have been created already.
    • The layouts that are listed cannot be reordered.
  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 band.
  2. Navigate to Customization >  Layouts and Fields  >  Bugs.
  3. Click the Layouts section.
    • Hover over a layout that you would like to delete and click the trash icon .
    • Confirm your action.
The standard layout and the layouts associated with a project cannot be deleted. You can delete the layout after associating the projects to a different layout.

Create or Edit Section

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization > Layouts and Fields > Bugs.
  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.
  6. You can also add new or existing custom fields to your section.
  7. Click Save Layout.

Delete Section

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization > Layouts and Fields > Bugs.
  3. Click a layout to delete a section in the layout.
  4. Hover over the section and click .
  5. 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.
  6. Confirm your action.

Create Custom Field

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization > Layouts and Fields > Bugs.
  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. Enter field name.
  6. Select appropriate access permission. (Project Users: Field will be available to only users who are part of the project; Client Users: Field will be available to project and client users; All Users: Field can be made available to all users via the Web to Bug Form).
  7. Select options in Field Information. PII denotes that the custom field captures Personally Identifiable Information.
  8. Select Encrypt Field option if the data should be encrypted at the back-end.
  9. Set a Default Value if necessary.
  10. Select Mandatory checkbox if you want the field to be filled compulsorily. 
  11. Click Add to Layout to include the field in the layout. When you cancel, the field is never stored anywhere.
  12. Click Save Layout to update.

You can create the following custom fields:

  • Single-Line text field: Add one line of text.
  • Multi-Line text field: Add multiple lines of text. Hit Enter to key in more information.
  • 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.
  • User Pick-List field: Use this field when you need to store usernames.
  • Date: Store dates in this field. 
  • Number: Store numbers in this field. A number can have a maximum of 19 digits.
Single-line text, Multi-Line text, and Number fields can be marked as containing PII (Personally Identifiable Information). If you select Encrypt Field option while creating the custom field, the data will be encrypted at the backend.

Edit Custom Field

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization >  Layouts and Fields  >  Bugs.
  3. Open the layout editor and hover over the custom field you would like to edit.
  4. Click the pencil icon .
  5. 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.
  6. Click Save Changes.

Reorder Custom Field

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization >  Layouts and Fields  >  Bugs.
  3. Open the layout editor and hover over the custom field you would like to reorder.
  4. Drag and swap with another field in the editor. You can reorder the fields as many times as you want until you get the desired order.
  5. Click Save Layout.

Remove Custom Field

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization  >  Layouts and Fields  >  Bugs.
  3. Open the layout editor and hover over the custom field you would like to dissociate.
  4. Click .
  5. Confirm your action.
  • Removing a project custom field will not delete it permanently.
  • The custom field will be moved to the Available Fields tray and it can be reused anytime later from this tray.

Delete Custom Field

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization >  Layouts and Fields  >  Bugs  >  Fields.
  3. Hover over the field you would like to delete.
  4. Click . The data stored in the field will be lost
  5. Confirm your action.

Create Custom Status

  1. Click in the upper-right corner of the top navigation band.
  2. Navigate to Customization  >  Layouts and Fields  >  Bugs  >  Fields.
  3. Open an existing layout or create a new layout.
  4. Click  on the right-side of Status & Workflow.​
  5. Change the default status for a bug under Set Default Status section.
  6. Click the +Add Status link to create a new bug status.
    • A new status will fall under either Open or Closed status types.
    • Default Status can't be deleted and there should be at-least one open & one closed status.
  7. Give a status name.
  8. Clickto the left of the status name to assign a color. Pick any color from the palette that matches the status name and type.
  9. Define a Workflow by selecting the next available status. The workflow is determined by the next available status specified in the box.
  10. Click Apply Changes to add the Status.



    Zoho DataPrep Personalized Demo

    If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

    Zoho CRM Training

      Create, share, and deliver

      beautiful slides from anywhere.

      Get Started Now





              Zoho CRM Training Programs

              Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

              Zoho CRM Training

                  Zoho SalesIQ Resources



                      Zoho TeamInbox Resources




                                Zoho DataPrep Resources

                                  Zoho DataPrep Demo

                                  Get a personalized demo or POC

                                  REGISTER NOW


                                    Design. Discuss. Deliver.

                                    Create visually engaging stories with Zoho Show.

                                    Get Started Now











                                                          • Related Articles

                                                          • Timesheet Layouts & Fields

                                                            Zoho BugTracker supports custom fields and layouts for timesheets. Create your own fields and use them for customizing timesheets as per your business requirements. You can also associate a layout while adding time log. Feature Availability: View ...
                                                          • 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 ...
                                                          • Milestone Layouts & Fields

                                                            Zoho BugTracker supports custom fields and layouts for milestones. Create your own fields and milestone layouts and use them for creating milestones as per your business requirements. Click here to learn more about access privileges for Custom ...
                                                          • Bug Reports

                                                            Bug Reports displays bug count against various parameters. Basic Reports: View bug count by Status, Assignee, Reporter, Escalation, Severity, Module, Release Milestone, Affected Milestone, Classification, Reproducible, and Tag fields. Advanced ...
                                                          • Bug Details

                                                            Bug details page displays important information related to the bug. The information can be edited or deleted. Users can also add comments, attachments, provide resolutions, log hours, link other bugs, view activity stream, follow bugs, move or clone, ...

                                                          Resources

                                                          Videos

                                                          Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                          eBooks

                                                          Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                          Webinars

                                                          Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                          CRM Tips

                                                          Make the most of Zoho CRM with these useful tips.



                                                            Zoho Show Resources