Customize Your Workspace

A CA Agile Central subscription can consist of multiple workspaces. Each workspace can be subdivided into multiple projects. A workspace administrator is delegated and authorized by the subscription administrator for each workspace.

Important!: Before you create a new workspace, carefully consider the fact that rollups and reports are performed within a specific workspace. In other words, the information to rollup or report on, such as projects, work items (including portfolio items), and fields must be stored in the same workspace. For that reason, CA Agile Central strongly recommends you limit the number of workspaces you create.

Once authorized for a workspace, the workspace administrator has the following capabilities:

  • Workspace and project configuration: You can also create, edit, and read projects contained within the workspace for which you are an administrator.
  • Workspace rights: You have full rights to all work items of the workspace.
  • Manage users: Manage users for a subscription if the subscription administrator has provided permissions .
    • Create users for the workspace
    • Add users to each project in the workspace
    • Add existing subscription users to the workspace
    • Update all user profile fields for the workspace users
    • Remove users from the workspace

Customizing your workspace consists of the following:

Use multiple workspaces

Before creating a new workspace, you should be aware of the impact on your organization's tracking and reporting options. Please decide carefully because you cannot merge workspaces.

Advantages of multiple workspaces Advantages of a single workspace
  • Custom fields per workspace
  • Field values per workspace
  • Required fields per workspace
  • Field visibility per workspace or project
  • Tags per workspace
  • Plan estimation units per workspace
  • Shared custom pages per workspace or project
  • Shared custom views per workspace
  • Administration can be delegated to workspace or project administrators
  • Reporting and rollup and statuses across all projects between any user stories
  • Unique projects or teams
  • Enforce common practices and fields for consistent reporting across teams and projects
For CA Agile Central Portfolio Manager:
  • Common portfolio levels definition per workspace
  • Portfolio item types per workspace
  • Portfolio investment categories per workspace
For CA Agile Central Portfolio Manager:
  • Single, common portfolio for consistency across teams and the organization

CA Agile Central's recommendations:

  • Use one workspace whenever possible.
  • There is no security benefit to having multiple workspaces. You can restrict user access to a single project or group of projects.

Manage Workspaces and Projects

Depending on the size of your company, you may want to create additional workspaces and projects to organize your work.

From the Workspace summary page, the subscription administrator can administer all workspaces for your subscription. The workspace administrators can administer the specific workspaces to which they have been assigned. Use the Workspace summary page to create and manage projects and child projects when using project hierarchies.

From the Workspace summary page, the subscription administrator can:

  • Use the Actions button to:
    • Create a new workspace.
    • Print a report for all workspaces and projects for your subscription. You can print a summary list or a detailed listing of all workspaces. Both report types include all projects contained within each workspace.
  • Edit edit a workspace. Edits to each workspace are unique and are applied to all projects created within the specified workspace. Record a change description for each edit to the workspace to help you track changes made to the workspace.
  • Sort by field values by clicking any linked column heading. Click the heading a second time and toggle between ascending and descending sort orders.
  • Filter workspaces using the State or Owner fields.
  • Create a project. Select the New project icon located to the right of the workspace that will contain the project.
  • Create a child project. Select a workspace and expand it to view all current projects for the workspace. Select and expand the project to be designated as the parent project. Click the Add Child To... icon.

Automatic permission setting for new users

Workspace and subscription admins can set a preferred permission default for new users created within a workspace. Edit the workspace settings to access the Default access for new users setting.

When creating a new user, admins will see the selected permission for all projects in the workspace inside the user editor window. You will still have the ability to change the permissions for specific projects while creating the user.


  • Changing this setting will not affect the permissions of existing users.
  • When creating a new user in a different workspace, permissions are still provided in the workspace that has this setting enabled.
  • If a project admin creates a new user in a workspace that has this setting enabled, the new user will be provided permissions to all projects, including projects the admin may not have access to.

Time zones

Time zones are set at the workspace level by the subscription or workspace administrator. Dates are treated as a specific, fixed point in time, not a calendar date. This allows for consistency with distributed teams. The workspace time zone is not necessarily the local server time zone.

Timeboxes start at midnight and end one second before midnight in the workspace time zone. Any dates displayed in grids include the time and time zone abbreviation in the workspace time zone. Emails and notifications are sent in the last time zone the user was in while logged into CA Agile Central.


Workdays are set at the workspace level by the subscription or workspace administrator. Workdays are defined by default as Monday, Tuesday, Wednesday, Thursday, and Friday.

Charts and reports do not include non-workdays.

Set up work product prefixes

As the subscription or workspace administrator, you can customize or edit your workspace settings. Each work item is required to have a unique prefix or tag to help you identify the type of work item at a glance. For example, set up user stories with a prefix of US, so a user story would look like this: US1103. You can set defects with a prefix of DE, so a defect would look like this: DE0415.

In the Work Product Prefixes section, enter the desired prefix into the appropriate work item text box. You can customize an ID prefix for:

  • User Stories
  • Defects
  • Defect Suites
  • Test Cases
  • Tasks

Click Save after you make your changes.

The prefix can be an alphanumeric entry with a maximum length of 10 characters. All special characters are allowed. Each of these fields can be changed after the workspace has been started and data exists. When you edit the workspace in progress, the work item prefixes are updated immediately.

Note: You may change the prefixes of portfolio items when editing the Type field.

Configure units

Use the Units & Planning section of the workspace editor window to specify the increments of measurement applied to work effort at a release and iteration level within your workspace. Examples of units include units, points , hours, and days. To customize units, begin by editing your workspace settings.

  1. Locate the workspace to customize, then click the Edit icon.

    The red highlighted field headings are required.

  2. In the Units & Planning section, enter your Planning Units.
    This label is applied when estimating user stories, defects, and defect suites. The first letter of your entered value displays in a column header icon of the Plan Estimate column on the Iteration Status and Release Status pages. Hover over the icon and the full text of your estimate label ( Points ) displays.

  3. Enter a label for Task Units estimation.
    The first letter of your entered value displays in a column header icon of the Task Est column on the Iteration Status and Release Status pages. Hover over the icon and the full text of your estimate label (Hours) displays.

  4. Click Save.

Units are alphanumeric fields. All special characters are allowed. You can edit units after data has been already recorded in your project; however, the new units label will not be applied to previous data. The new label will only be applied to quantities created or edited after the change was made.

View the Workspace detail page

Go to associated workspace work items from the Workspace detail page using the workspace sidebar.

From the sidebar , you can:

  • View a listing of all associated projects contained within this workspace
  • Click any displayed project in the folder to navigate to its detail page
  • Toggle your display between the associated project and workspace detail
  • Click the Fields link on the sidebar to view, create, and edit fields associated with a work item

Use the Actions button located at the top of the Workspace detail page to edit, print, or create a new workspace.

Manage tags

Use tags within a workspace to logically group work items by a theme recognized by team or organization members. Since users have the ability to create their own tags, the list of available tags can become large over time. The subscription or workspace administrator may rename or archive tags to better organize and reduce clutter in the tag list.

Rename tags

When you rename a tag, its name on associated work items is changed in the tag list.

To rename a tag from a workspace:

  1. Click the Tags link in the sidebar.
  2. Type the name of the tag in the text box and press Enter to locate the tag.
  3. Double-click the tag name to enter edit mode.
  4. Rename the tag. Click outside the tag name field to save your changes.

Archive tags

When you archive a tag, you remove it from the tag list but you do not remove it from associated work items. Even though it is archived, it is still available in all drop-down lists used for filtering page views, notifications, and reports.

To archive a tag from a workspace:

  1. Click the Tags link in the sidebar.
  2. Type the name of the tag in the text box and press Enter to locate the tag.
  3. Mark the checkbox to archive a tag, or to deselect the checkbox to retrieve a tag from the archive.
  4. Click outside the checkbox to save your changes.

Delete tags

When you delete a tag, you remove it from the tag list and any associated work items. Any custom views that use a deleted tag name will need to be edited to remove the invalid criteria.

To permanently delete a tag from a workspace:

  1. Click the Tags link in the sidebar.
  2. Type the name of the tag in the text box and press Enter to locate the tag.
  3. Click the gear icon and select Permanently Delete.
  4. A warning message displays with the number of work items that use the tag. Click the Permanently Delete button.

Set up work item fields

A work item field helps describe the characteristics of a specific work item, such as Display Name, Description, Priority, or Owner. A work item field may be visible or hidden, required or optional, unique to a work item or shared across many work items. Some work item fields are used by CA Agile Central and are visible to you. Others may be defined by you for your own purposes.

Work item fields are managed by the subscription or workspace administrator, and are applied to an entire workspace.

Click here to learn how to create and manage your fields and visibility settings among projects.

Modify the Schedule State field

Schedule State is a built-in drop-down field that is shared by all work items. Modifying one work item's Schedule State will apply to all work items.

There are six values for this field:

  • Custom 1 (customizable value)
  • Defined
  • In-Progress
  • Completed
  • Accepted
  • Custom 2 (customizable value)

Changes to the custom fields will span across all work items that use it. To change either of the two custom values, watch this demo or do the following:

  1. Click the Fields link in the sidebar.
  2. From the Work Item drop-down, select Defect or User Story.
  3. Click the gear icon next to Schedule State, then click Edit.
  4. Select the Custom 1 value in the Drop Down List Values box.
  5. Change the values in the Value and Legend fields.
  6. Select the Enabled field.
  7. Click Save & Close.

Close unused workspaces and projects

You cannot delete workspaces and projects. Instead, edit the workspace or project and set the State to Closed. Learn more.


Need more help? The CA Agile Central Community is your one-stop shop for self-service and support. To submit feedback or cases to CA Agile Central Support, find answers, and collaborate with others, please join us in the CA Agile Central Community.