Introduction to the CircleCI Web App
The CircleCI web application is a graphic user interface for many of the same features that are available in the CircleCI command line interface. The application can be found at https://app.circleci.com.
Inside the application, you will find the status of builds, workflows and jobs, as well as organization settings. This page is not an extensive guide to the web app, but is an introduction to some of the information, options, and settings available.
Dashboard and side navigation
Upon logging in, you will see the Dashboard, showing you the status of pipelines in the projects that you are following. The dropdown menus at the top of the dashboard allow you to select to view everyone’s pipelines, or just your own pipelines, as well as all projects, or specific projects. Clicking the organization name will open the organization switcher, which shows all organizations that have been set up. You can switch between these organizations to see their individual dashboards.
If you do not have any projects in your dashboard, or you are missing specific projects, you can select Projects on the side navigation. The projects view shows the list of all projects within the organization, which you can choose to follow or unfollow. Following a project will add it to your dashboard. Unfollowing a project will remove it from your dashboard.
The side navigation allows you to visit the following web application pages:
Projects: Allows you to see all projects associated with your organization. Choose to follow or unfollow projects, as well as set up new projects.
Insights: Provides you with time-series data overviews of credit usage, success rates, and pipeline duration, among other things.
Self-Hosted Runners: Shows a list of your resource classes and self-hosted runners. This page also allows you to set up self-hosted runners, so you can use your own infrastructure for running jobs.
Organization Settings: Settings for your organization including contexts, security, and orbs, among other things. You can also find your organization ID on this page.
Plan: Shows your network and storage usage, as well as additional settings related to your plan.
Notifications: A tooltip with new features or changes. New notifications are identified with a badge next to the navigation item.
Status: The status badge will display the operational health of CircleCI. Clicking on this navigation item will bring you to CircleCI’s status page.
Support: A tooltip with links to community help forums, CircleCI support, as well as links to CircleCI’s feature requests and changelog pages.
At the very bottom of the side navigation (you may have to scroll down), you will see your individual user icon. Clicking on this will bring you to your individual User Settings.
The sections below describe some of the pages of the web application in more detail.
View and navigate pipelines
Your pipelines appear on the Dashboard of the CircleCI web app as they are triggered. You can view workflows or single jobs by expanding a pipeline and clicking in on any workflow or job descriptor.
When viewing a single job in a pipeline, you can use the breadcrumbs at the top of the page to navigate back to a job’s respective workflow or pipeline.
In the top left of the web app, you will find the organization (org) switcher.
If you do not see your project and it is not currently building on CircleCI, check your org in the top left corner of the CircleCI application. For example, if the top left shows your user
my-user, only projects belonging to
my-user will be available. If you want to add the project
your-org/project, you must select
your-org from the org switcher.
Projects associated with your organization will appear on the Projects page. You have the option to:
Set Up any project that you are the owner of in your VCS.
Follow any project in your organization to gain access to its pipelines and to subscribe to email notifications for the project’s status.
Following or setting up a project adds it to your dashboard. Unfollowing a project removes it from your dashboard.
Clicking the three dots (meatball menu) in the project row will allow you to open an individual project’s configuration file, Insights, and settings. If you are following a project, you will also see an option to unfollow the project from this menu. There is also a Project Settings button found on individual project pages, which you can view by clicking on a project’s name in the main Projects dashboard.
Configuration File: This option opens the project’s configuration file inside a text editor within CircleCI’s web app. You can make changes to the config file and commit them. At the top of the text editor, you will see the project’s branch you are committing the changes to (most often
Insights: This is a link to the Insights page.
Overview: Shows your project ID, as well as links to docs on how to set up certain features available to projects. You may also find the option to Stop Building on the overview page. This option halts builds, and will automatically unfollow from all dashboards.
Triggers: Allows you to define a timetable, parameter, and attribution to automatically run a pipeline when the criteria is met.
Advanced: Toggle options on and off for: VCS status updates, build forked pull requests, pass secrets to builds from forked pull requests, only build pull requests, auto-cancel redundant workflows, free and open source, enable dynamic config using setup workflows. More information on these settings can be found on this page, as well as in our documentation.
Environment Variables: Add or import environment variables to your jobs to keep sensitive data out of your repository.
SSH Keys: See information related to your SSH keys, or set up new SSH keys. CircleCI uses deploy and user keys. There is an option to add additional SSH keys.
API Permissions: Allows you to create API tokens, as well as revoke project-specific API tokens.
Jira Integrations: Authenticate Jira and set up the Jira orb in your config file to integrate Jira into your projects.
Slack Integrations: Authenticate Slack and set up the Slack orb in your config file to integrate Slack into your projects.
Insights Snapshot Badge: A tool that allows you to generate a code snippet that will display a snapshot of your project’s Insights metrics in a README or other web document.
Status Badges: A tool that allows you to generate a code snippet that will display your project’s build status in a README or other document.
Webhooks: Set up webhooks through CircleCI’s Webhook API. This allows you to connect a platform you manage (either an API you create yourself, or a third party service) to a stream of future events.
The Insights page shows you specific numbers related to workflow run, workflow duration, credits consumed, and the overall success rate for all projects in your organization over a selected time range. At this time, the ranges you can choose are 24 hours, seven, 30, 60, and 90 days.
While the main Insights page gives you an overview of all projects, you can also click on an individual project to get further insights into that project’s workflows. You may also click on individual workflows to see insights on workflow runs.
New resource classes will require an existing namespace, or creation of a new namespace if no namespace for the organization has been created yet (organizations can only create a single namespace), as well as a label to match your CircleCI job with a type of runner.
In this process you select the environment you are working with (Linux, macOS, etc) and the web app will display the instructions for installing self-hosted runner software. This process is also laid out on the self-hosted runner page.
Overview: Shows your organization ID.
Contexts: Set up a new context, view a list of existing contexts, or remove contexts. Contexts provide a mechanism for securing and sharing environment variables across projects.
VCS: Menu will differ per VCS. For example, if your VCS is GitHub, you can manage GitHub checks.
Security: Allows you to set whether or not you want to allow the use of partner and community orbs. Depending on your plan, you can also set up a security contact to retrieve audit logs.
Orbs: View a list of all the orbs being used in projects within your organization.
If you have administrative privileges, the plan overview and upgrade page shows the features available in your current plan, as well as a snapshot of your usage. Details of the next tier of plan upgrade are also shown. You can read more about plans in CircleCI’s Plan section.
Depending on which plan you have, you can also choose to share your plan, which lets any organization you belong to share and run builds on your current plan, and you can also transfer your plan to another organization.
The plan usage section is a detailed overview of your usage by billing period. Here you can find usage information about projects, resource classes, users, network, storage and IP ranges. CircleCI uses a credits based system, and these overviews are meant to help you see how you are using credits, and what some potential cost saving measures could be.
In terms of network and storage, usage can be tricky to understand, so it is suggested you familiarize yourself with these pages and how credits work. You can learn more about network and storage usage on the Persisting data page.
You can learn more about billing in the billing section of the FAQ page.
Depending on your plan, you will also have the option to manage the retention periods of artifacts, workspaces, and caches. These settings allow you to keep your workflows clean, but can also help reduce storage costs.
User settings can be found by scrolling to the bottom of the side navigation and clicking on your user icon.
Account Integrations: Shows your user ID as well as account integrations such as your VCS provider.
Notifications: Set your individual email and web notification preferences. This includes preferences around builds, branches, and project notifications. Web notifications will appear in your browser.
Privacy & Security: Disable third-party tracking. You may opt in or opt out of third party tracking pixels.
Personal API tokens: View and create personal API tokens, used to access the CircleCI API.
Organization Plans: See the list of organizations you are a part of. If you have administrative privileges, you may also view the plan each organization is on.
Beta Program: Opt in to CircleCI’s beta program. Beta features you opt in to will be listed on this page.
Help make this document better
This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.
- Suggest an edit to this page (please read the contributing guide first).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.
You can also visit our support site to find support articles, community forums, and training resources.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.