Skip to main content
Video tutorial · 1:17

General tab

The General tab holds what identifies the company and what it covers: its name, its time zone, whether it is active, and the branches whose merge requests Merge Pilot follows.

Company page → General. Company admins of the company and platform admins change these settings, except Active, which only platform admins change; they are saved with Save changes (see Saving). None of them is held for four-eyes review.

Settings​

Setting (label in the UI)What it doesDefaultAllowed valuesWho can change itAPI field
NameThe company's name, shown in the company selector, on the company page and on the Companies page. Change approval templates can use itSet when the company is createdAny text, required (Name is required; a blank name is refused with 400)Company admin, platform adminname
SlugPart of the company's webhook URLs, so it does not change. Made from the name when the company is created; renaming the company keeps itFrom the nameRead-onlyNobodyslug
DescriptionA note shown on the Companies pageEmptyAny textCompany admin, platform admindescription
Time zoneThe company's time zone (IANA name, e.g. Europe/Istanbul or UTC). Change windows, change freezes and the change calendar use it. The audit report's days are in it tooEmpty: UTCEmpty, or an IANA time zone name, such as Europe/Istanbul, America/New_York or UTC. Anything else is refused: the form says Enter a time zone name, such as Europe/Istanbul or UTC, the API answers 400Company admin, platform admintimezone
ActiveAn inactive company's webhooks are ignored, its people cannot sign in and nothing of it is processed. See Deactivating a company for what stops. For company admins the switch is disabled: Only platform admins turn a company off or on.OnOn, offPlatform admin (the API answers 403 when anyone else turns the company off)active
Branch patternsThe branches whose merge requests Merge Pilot follows. See Branch patternsRepository default branchAt least one branch or pattern (Branch patterns cannot be empty. At least one pattern is required.)Company admin, platform adminbranch_patterns
Production branches for DORAThe branches whose merges DORA counts as deployments: Repository default branch, main, master, and other names or patterns such as release/*Empty: each repository's default branchBranch names and patterns; a blank entry is refusedCompany admin, platform admindora_production_branches

Turning the company off​

Switching Active off asks first: Deactivate the company? (Once saved, all webhooks and processing for this company stop until it is active again.), with Deactivate. Nothing changes until Save changes.

Only a platform admin turns a company off (here, or from the Companies page) and back on (here). When the company is saved as inactive, everyone of the company is signed out.

Branch patterns​

The branch patterns name the target branches Merge Pilot follows: a merge request into another branch is not evaluated, and putting a repository under change management protects these branches, so that they change only through approved merge requests.

The field has three quick choices and a list:

  • Repository default branch: each repository's own default branch, whatever it is called (main, master, develop …). Stored as ~DEFAULT_BRANCH.
  • main, master: these branch names.
  • Other branches or patterns: any other branch or pattern your changes go through before production, such as prod-release, release/* or hotfix/**. Press Enter (or type a comma) after each.

Patterns are matched as in policies, against the whole branch name and case-sensitively (see Matching): release/* matches release/v1.0 but not release/v1/hotfix; hotfix/** matches both hotfix/a and hotfix/a/b.

A project may set its own target branches; it then uses those instead of the company's (see The project page).

When the branch patterns change, Merge Pilot updates the webhook of every registered repository of the company in the background, a batch at a time (the events_sync job, see Jobs).

In the API, branch_patterns is a list of strings; an empty list is refused with 400. A company created without patterns gets ["~DEFAULT_BRANCH"].

API​

PUT /api/v1/companies/{id} with any of name, description, timezone, active and branch_patterns; the fields left out keep their values. See Company API.

Video tutorial

Short videos of this feature working on real GitLab and Jira projects. English audio, English and Turkish subtitles. All video tutorials →

Sign In and Create Your CompanyYouTube ↗