---
layout: handbook-page-toc
title: "Brand and Digital Design Handbook"
---
## On this page
{:.no_toc .hidden-md .hidden-lg}
- TOC
{:toc .hidden-md .hidden-lg}
# Brand & Digital Department
Note: This handbook is currently WIP - estimated to be final by April 1, 2020
---
# Mission
We build deliverables and experiences in both digital and physical realms such as the about.gitlab.com website, brand collateral, and more.
We assist with conversion design, growth marketing, user experience (UX), search-engine optimization (SEO), and performance metrics to build the logged out experience. We're involved with related marketing campaigns, events, lead-generation, and more. We guide the brand design and experience to assist with creating a cohesive identity.
## Lean Design
### Metrics & Measures
[ TODO : Document ]
## Value-Focused
### Objectives
[ TODO : Document ]
### Design is Good Business
[ TODO : Document ]
t
## Co-Design
### Inclusive
[ TODO : Document ]
---
# Workflow
## Prioritize
### Value-focused
[ TODO : Document ]
### Metrics
[ TODO : Document ]
#### Periscope Dashboards
[ TODO : Document ]
## MVC
### Product Performance Indicators
[ TODO : Document ]
### Function Team Grooming
[ TODO : Document ]
### Digital Board
[ TODO : Document ]
## Iterative Co-Design
### Design Systems
[ TODO : Document ]
We've broken out the GitLab interface into a set of atomic pieces to form our design system, [Pajamas](https://design.gitlab.com/). Pajamas includes information such as our principles, components, usage guidelines, research methodologies, and more.
#### [GitLab Product UX Guide](https://docs.gitlab.com/ee/development/ux_guide/)
The goal of this guide is to provide written standards, principles and in-depth information to design beautiful and effective GitLab features. This is a living document and will be updated and expanded as we iterate.
## Feedback & Validation
#### AB Testing
[ TODO : Document ]
---
# Contribute
## Submit Early
Please submit your request early to allow for our team to plan accordingly. The earlier the better.
### Website
#### Prioritization
We use the following criteria to assess issue priority:
**Common**
* Frequency of use - How often is the single application diagram used? Web traffic to this page?
* Number of people impacted - How many GitLabbers would benefit from this asset? How many unique users would benefit from this page?
**Critical**
* High customer risk - If we don't do this, what are the risks to customers? How severe are those risks?
* High business risk - If we don't do this, how might it create risk for our business? Could it create a large volume of support calls? Make us non-GDPR compliant?
* Business criticality - Part of high ROI opportunity or other business critical initiative?
* Impact to important stakeholders - CEO or CMO request? Impacts bottom of funnel (BOFU) prospects very close to buying? Impacts key partners or customers?
**Differentiator**
* Brand and or product differentiator - Creates value by positioning our brand and or product against competition.
**Reusable**
* Can we reuse - If we build this, can we reuse it elsewhere to get more ROI. Perhaps it's low value score for this project, but high "lifetime" value via reuse.
**Time & Cost**
* Time and cost required to complete the work.
**Deadlines**
* Are there any hard deadlines due to contract or event obligations?
#### Issue Templates
Because the website exists as a project at the top level, labels and boards for the digital team should usually be created in the root gitlab.com group. For more information on this works, please see [How it all fits together](https://about.gitlab.com/handbook/marketing/#how-it-all-fits-together).
* [Website bug report](https://gitlab.com/gitlab-com/www-gitlab-com/issues/new?issuable_template=-website-bug-report)
* [Website work request](https://gitlab.com/gitlab-com/www-gitlab-com/issues/new?issuable_template=-website-work-request)
#### Labels
**At a minimum, website related issues should have the label `mktg-website` applied in order to populate appropriate boards.**
They should also have a label for your team and/or subject matter (ex: `blog`, `Digital Marketing`, `SEO`). These labels need to exist in either the root `GitLab.com` group or the `www-gitlab-com` repository.
Issues should follow the [standard marketing status labels](/handbook/marketing/#boards-and-labels) flow labels, with a few additions.
* `mktg-status::triage` this work is in the pre-planning stage. We're still discussing what to do.
* `mktg-status::plan` this work is in the planning stage. We know what we want to do but don't know how we want to do it yet.
* `mktg-status::design` this issue needs some prototyping or other UX designs before we know where we're going.
* `mktg-status::groomed` this issue has been planned and detailed. We know what needs to be done. We can start building it.
* `mktg-status::wip` this issue is actively being worked on.
* `mktg-status::blocked` something is blocking progress on this issue.
* `mktg-status::review` enough work has been completed that this is ready for review and approval.
* `mktg-status::scheduled` this issue cannot be merged until a scheduled date but the work is complete and approved.
**Issues with an immovable due-date because of contractual and/or meatspace obligations should apply the `hard-deadline` label.**
Examples of optional labels include:
* `OKR`
* `outsource`
#### Issue Boards
**General**
[Design Handbook](https://gitlab.com/groups/gitlab-com/-/boards/1498563)
This board shows the status of all mktg-website issues labeled design-handbook. These are issues relating to team documentation and NOT general issues with the handbook.
**Brand Design**
[Design - Priority](https://gitlab.com/groups/gitlab-com/-/boards/1511332)
This board shows the status of all Brand Design issues labeled with a design priority label.
[Design - Outsource](https://gitlab.com/groups/gitlab-com/-/boards/1511334)
This board shows the status of all outsourcable issues labeled with design.
**Digital Design**
[Blocked](https://gitlab.com/groups/gitlab-com/-/boards/1485169)
This board shows all mktg-website website issues with the mktg-status::blocked label.
[CMO](https://gitlab.com/groups/gitlab-com/-/boards/1486533)
This board shows the status of all mktg-website issues labeled mktg-website which have the CMO Attention label.
[Debt](https://gitlab.com/groups/gitlab-com/-/boards/1485186)
This board shows the status of all mktg-website issues labeled technical-debt.
[OKR](https://gitlab.com/groups/gitlab-com/-/boards/1483333)
This board shows the status of all mktg-website issues labeled OKR.
[Mktg Web - Priority](https://gitlab.com/groups/gitlab-com/-/boards/1483370)
This board shows the status of all mktg-website issues labeled with a design priority label.
[Marketing Web - Outsource](https://gitlab.com/groups/gitlab-com/-/boards/1502288)
This board shows the status of all outsourcable issues labeled mktg-website.
[Team Dev](https://gitlab.com/groups/gitlab-com/-/boards/1485124)
This board shows all issues assigned to a member of the marketing website design & delivery teams. It is recommended to filter this by a particular mktg-status:: label such as ::wip or ::groomed.
[Hard Deadlines](https://gitlab.com/groups/gitlab-com/-/boards/1485208)
This board shows the status of all mktg-website issues labeled hard-deadline (please refer to the definition on the label).
#### Team-subject boards
**Digital Design**
* [All Remote](https://gitlab.com/groups/gitlab-com/-/boards/1485066)
* [Analyst Relations](https://gitlab.com/groups/gitlab-com/-/boards/1485071)
* [Blog](https://gitlab.com/groups/gitlab-com/-/boards/1483337)
* [Content Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1483354)
* [Corporate Events](https://gitlab.com/groups/gitlab-com/-/boards/1485090)
* [Corporate Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1485085)
* [Digital Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1485086)
* [Field Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1533790)
* [Marketing Ops](https://gitlab.com/groups/gitlab-com/-/boards/1485111)
* Marketing Programs](https://gitlab.com/groups/gitlab-com/-/boards/1580521)
* [Product Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1485129)
* [Recruiting (Talent Brand)](https://gitlab.com/groups/gitlab-com/-/boards/1580510)
* [Strategic Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1489415)
* [Social](https://gitlab.com/groups/gitlab-com/-/boards/1485179)
* [Talent Brand](https://gitlab.com/groups/gitlab-com/-/boards/1580510)
* [Technical Evangelism](https://gitlab.com/groups/gitlab-com/-/boards/1485182)
**Brand Design**
* [All Remote](https://gitlab.com/groups/gitlab-com/-/boards/1571555)
* [Blog](https://gitlab.com/groups/gitlab-com/-/boards/1571570)
* [Content Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1571561)
* [Corporate Events](https://gitlab.com/groups/gitlab-com/-/boards/1541174)
* [Corporate Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1541149)
* [Digital Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1571582)
* [Field Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1541162)
* [Marketing Programs](https://gitlab.com/groups/gitlab-com/-/boards/1571580)
* [Recruiting (Talent Brand)](https://gitlab.com/groups/gitlab-com/-/boards/1571573)
* [Strategic Marketing](https://gitlab.com/groups/gitlab-com/-/boards/1571417)
* [Social](https://gitlab.com/groups/gitlab-com/-/boards/1571585)
* [Technical Evangelism](https://gitlab.com/groups/gitlab-com/-/boards/1596489)
#### Tools
[Adobe Creative Cloud / Suite](https://www.adobe.com/)
Adobe Creative Cloud is a set of applications and services from Adobe Inc. that gives subscribers access to a collection of software used for graphic design, video editing, web development, photography, along with a set of mobile applications and also some optional cloud services.
[Sketch](https://www.sketch.com/)
Create, prototype, collaborate and turn your ideas into incredible products with the definitive platform for digital design.
[Mural](https://mural.co/)
MURAL is an Online Virtual Collaboration Space, Easy to Use Specially Designed for Teams. You can Post Stickies, Share Ideas, Brainstorm and Run Product Sprints.
[Google Analytics](https://analytics.google.com/analytics/web/)
Google Analytics lets you measure your advertising ROI as well as track your Flash, video, and social networking sites and applications.
[Sisense ( previously Periscope )](https://www.sisense.com/product/data-teams/)
Sisense for Cloud Data Teams (previously Periscope Data) empowers data teams to quickly connect to cloud data sources, then explore and analyze data in a matter of minutes. Extend cloud investments with the Sisense analytics platform to build, embed, and deploy analytics at scale.
[Hotjar](https://www.hotjar.com/)
Hotjar is a powerful tool that reveals the online behavior and voice of your users. By combining both Analysis and Feedback tools, Hotjar gives you the ‘big picture’ of how to improve your site's user experience and performance/conversion rates.
[Launch Darkly](https://launchdarkly.com/)
LaunchDarkly is a Feature Management Platform that serves over 100 billion feature flags daily to help software teams build better software, faster.
[Google Optimize](https://optimize.google.com/optimize/home/)
Google Website Optimizer was a free website optimization tool that helped online marketers and webmasters increase visitor conversion rates and overall visitor satisfaction by continually testing different combinations of website content.
#### Experiments
This section is related to A/B and multivariate testing on the marketing website, about.gitlab.com. It is a work in progress while we assess new testing tools for integration into our toolkit.
Until the toolkit assessment is finalized, please reference digital marketing's [testing documentation](https://about.gitlab.com/handbook/marketing/revenue-marketing/digital-marketing-programs/digital-marketing-management/#create-a-culture-of-testing-and-optimization).
Going forward, we hope newly created issues align with the [growth team's testing template](https://gitlab.com/gitlab-org/growth/product/-/blob/master/.gitlab/issue_templates/Growth%20experiment.md).
**Before you experiment**
Always gather relevant heatmaps, analytics, metrics, KPI (key performance indicators), etc.
**Testing Tools**
We are in the process of establishing a new toolset for running experiments. Our hybrid suite of tools will include:
*Testing via feature flags*
This is where we plan to do the bulk of our testing. We can run several of these at the same time. For full-page, partial-page, component, and small changes.
*Feature flag best practices*
Feature flags should be implemented in code similarly to the includes system. Example:
* Login to our third party service and create a feature flag and related configuration variables.
* Assign ownership of that flag from within the interface.
* Edit a page.
* Put the existing contents of the page into an include file named `/source/experiments/1234-control.html.haml`, where experiments is the folder name instead of includes and 1234 is the id number of the associated issue. "Control" refers to the baseline measurement you are testing against.
* Duplicate that include file with the name `/source/experiments/1234-test.html.haml`
* Make your changes and validate the feature toggle works locally and/or on a review app before deployment.
* Ensure you'll be able to collect all the data you need. Setup appropriate tools like heatmaps and analytics.
* Note that one advantage of feature flags is that they can be released to production without being turned on.
* When ready, enable the test. Start gathering data.
**Testing via CDN**
This is an advanced tool meant to test large-scale changes at a systemic level. For now we plan to run only one of these at a time.
**Testing via WYSIWYG**
This is a rudimentary tool for small-scale changes with few safeguards and important caveats. We can use this for small items like colors and copy but not layout. This is mainly meant as a tool for non-developers.
### Brand
#### Issue Templates
* [General Design request](https://gitlab.com/gitlab-com/marketing/corporate-marketing/-/issues/new?issuable_template=design-request-general)
* [Content Resource Design request](https://gitlab.com/gitlab-com/marketing/corporate-marketing/-/issues/new?issuable_template=design-request-content-resource)
* [Integrated Campaign Design requirements](https://gitlab.com/gitlab-com/marketing/corporate-marketing/-/issues/new?issuable_template=design-requirements-integrated-campaign)
#### Labels
[ TODO : Document ]
The `Design` label helps us find and track issues relevant to the Design team. If you create an issue where Design is the primary focus, please use this label.
#### Cross-link to design system
[ TODO : Document ]
---
# Brand Guidelines
## Home
### How we work
[ TODO : Document ]
#### Partnership with third parties
[ TODO : Document ]
#### Requesting design help
1. Create an issue in the corresponding project repository.
1. For tasks pertaining to [about.gitlab.com](/) create an issue in the [www-gitlab-com project](https://gitlab.com/gitlab-com/www-gitlab-com/issues).
1. For all other marketing related tasks create an issue in the [corporate marketing project](https://gitlab.com/gitlab-com/marketing/corporate-marketing/issues).
1. Add all relevant details, goal(s), purpose, resources, and links in the issue description. Also `@` mention team members who will be involved.
1. Set due date (if possible) — please leave at least 2 week lead time in order to generate custom design assets. If you need them sooner, ping @luke in the #marketing-design Slack channel and we will make our best effort to accommodate, but can't promise delivery.
1. Add the `Design` and `Website Redesign` (if applicable) label(s) to your issue.
#### Project prioritization
Per the Design team's discretion, the prioritization of design projects will be based on the direct impact on Marketing.
To get a better sense of [corporate marketing project](https://gitlab.com/gitlab-com/marketing/corporate-marketing/issues) prioritization, you can view the [Design Issue Board](https://gitlab.com/gitlab-com/marketing/corporate-marketing/boards/913023?&label_name[]=Design).
Design projects within the [www-gitlab-com project](https://gitlab.com/gitlab-com/www-gitlab-com/issues) can be tracked using the [Website](https://gitlab.com/gitlab-com/www-gitlab-com/issues?scope=all&utf8=%E2%9C%93&state=opened&label_name[]=Website) label. The prioritization of projects for [about.gitlab.com](/) can be viewed on the [Website Issue Board](https://gitlab.com/gitlab-com/www-gitlab-com/boards/349137?milestone_title=No+Milestone&).
Any design requests that do not fall in line with the goals and objectives of Marketing will be given a lower priority and factored in as time allows.
#### Team logo request guidelines
As the company continues to grow, incoming requests for internal team logos are increasing at a rate that is not scalable for the Brand Design team. We understand the desire for teams within GitLab to have their own identity, so we've created these guidelines to help direct your request:
* Teams can create their own logos that are for internal (non-public) use only.
* If you believe a public-facing team logo would be valuable to our business, please submit a [design request issue](https://gitlab.com/gitlab-com/marketing/corporate-marketing/issues) outlining how it will be used, who will see it, and it's perceived value. Logos will be created and approved on a case-by-case basis to capitalize on brand opportunities and ensure brand integrity.
### Privacy
[ TODO : Document ]
### License
[ TODO : Document ]
### What's new
[ TODO : Document ]
## Design principles
### Generate value
[ TODO : Document ]
### Omni-channel experiences
[ TODO : Document ]
### Everyone can contribute
[ TODO : Document ]
### Grow a community
[ TODO : Document ]
## Foundations
### Personality
[ TODO : Document ]
### Writing style
[ TODO : Document ]
### Logos
To download the GitLab logo (in various formats and file types) check out our [Press page](/press/).
The GitLab logo consists of two components, the icon (the tanuki) and the wordmark:
{: .small.left}
GitLab is most commonly represented by the logo, and in some cases, the icon alone. GitLab is rarely represented by the wordmark alone as we'd like to build brand recognition of the icon alone (e.g. the Nike swoosh), and doing so by pairing it with the GitLab wordmark.
#### Logo safe space
Safe space acts as a buffer between the logo or icon and other visual components, including text. this space is the minimum distance needed and is equal to the x-height of the GitLab wordmark:
{: .medium.left}
{: .small.left}
{: .small.left}
The x-height also determines the proper spacing between icon and wordmark, as well as, the correct scale of the icon relative to the wordmark:
{: .small.left}
#### Minimum logo size
Here are the recommended minimum sizes at which the logo may be reproduced. For legibility reasons, we ask that you stick to these dimensions:
**Logo**
{: .small.left}
- Digital: 100px wide
- Print: 1.25in (31.75mm) wide
**Stacked logo**
{: .small.left}
- Digital: 60px wide
- Print: 0.75in (19mm) wide
**Icon**
{: .small.left}
- Digital: 30px wide
- Print: 0.50in (13mm) wide
#### Using other logos
Logos used on the about.gitlab.com site should always be in full color and be used to the specifications provided by the owner of that logo, which can usually be found on the owners website. The trust marks component found throughout the site is the only exception and should use a neutral tone:
The tanuki logo should also not have facial features (eyes, ears, nose...); it is meant to be kept neutral, but it can be accessorized.
### The Tanuki
The [tanuki](https://en.wikipedia.org/wiki/Japanese_raccoon_dog) is a very smart animal that works together in a group to achieve a common goal. We feel this symbolism embodies GitLab's [mission](/company/strategy/#mission) that everyone can contribute, our [values](/handbook/values/), and our [open source stewardship](/company/stewardship/).
### Brand oversight
Occasionally the [old GitLab logo](* https://gitlab.com/gitlab-com/gitlab-artwork/blob/master/_archive/logo/fox.png) is still in use on partner websites, diagrams or images, and within our own documentation. If you come across our old logo in use, please bring it to our attention by creating an issue in the [Marketing](https://gitlab.com/gitlab-com/marketing/general/issues) issue tracker. Please include a link and screenshot (if possible) in the description of the issue and we will follow-up to get it updated. Thanks for contributing to our brand integrity!
### Trademark
GitLab is a registered trademark of GitLab, Inc. You are welcome to use the GitLab trademark and logo, subject to the terms of the [Creative Commons Attribution Non-Commercial ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/). The most current version of the GitLab logo can be found on our [Press page](/press/).
Under the Creative Commons license, you may use the GitLab trademark and logo so long as you give attribution to GitLab and provide a link to the license. If you make any changes to the logo, you must state so, along with the attribution, and distribute under the same license.
Your use of the GitLab trademark and logo:
- May not be for commercial purposes;
- May not suggest or imply that you or your use of the GitLab trademark or logo is endorsed by GitLab, or create confusion as to whether or not you or your use of the GitLab trademark or logo is endorsed by GitLab; and
- May not suggest or imply or that you are affiliated with GitLab in any way, or create confusion as to whether or not you are affiliated with GitLab in any way.
Examples of improper use of the GitLab trademark and logo:
- The GitLab name may not be used in any root URL, including subdomains such as `gitlab.company.com` or `gitlab.citool.io`.
- The GitLab trademark and/or logo may not be used as the primary or prominent feature on any non-GitLab materials.
### Typography
The GitLab brand uses the Source Sans Pro font family. Headers (h1, h2, etc.) always have a weight of 600 (unless used in special situations like large, custom quotes) and the body text always has a weight of 400. Headers should not be given custom classes, they should be used as tags and tags alone (h1, h2, etc.) and their sizes or weights should not be changed, unless rare circumstances occur. Here are typography tags.
`H1: Header Level 1`
`H2: Header Level 2`
`H3: Header Level 3`
`H4: Header Level 4`
`p: Body text`
### Color
While the brand is ever-evolving, the GitLab brand currently consists of six primary colors that are used in a wide array of marketing materials.
##### Hex/RGB

### Buttons
Buttons are an important facet to any design system. Buttons define a call to action that lead people somewhere else, related to adjacent content. Here are buttons and their classes that should be used throughout the marketing website:
**Note**: Text within buttons should be concise, containing no more than 4 words, and should not contain bold text. This is to keep things simple, straightforward, and limits confusion as to where the button takes you.
#### Primary buttons
Primary buttons are solid and should be the default buttons used. Depending on the color scheme of the content, purple or orange solid buttons can be used depending on the background color of the content. These primary buttons should be used on white or lighter gray backgrounds or any background that has a high contrast with the button color. They should also be a `%a` tag so it can be linked elsewhere and for accessibility. Buttons should also be given the class `margin-top20` if the button lacks space between itself and the content above.