This page is the single source of truth for all administrative tasks, templates, and processes focused on GitLab brand social channels. If your question is "how?", the answer will be here.
Many requests for social media coverage could sound like one ask, but ultimately have different end-user objectives or where we'll need to promote different assets or links. Please keep the following in mind to help us better manage requests.
If you are requesting coverage for something that is:
This will allow us all to better understand due dates, milestones, and to close issues promptly when the specific request is fulfilled.
If you're not sure if you need an epic or just an issue, feel free to ask in the #social_media Slack channel.
Once you've opened the epic (if the ask is a part of the list above)
When sharing a link on social media, all channels will look for opengraph frontmatter information, allowing the sites to pull a social media sharing card. This includes unique specifics for the page like its title, a description, and a unique image. It's critical that all pages intended to be shared across social media sites have this informaton attached, so that our users are aware of where we're linking them to, as well as, following best practices.
Social Media Sharing tags are set by the post or page frontmatter. Please use the following template and add it to the frontmatter:
title: your page title/cta description: page description twitter_image: "/images/opengraph/file-name.png" twitter_image_alt: "describe the image being used here" twitter_site: "@gitlab" twitter_creator: "@gitlab"
Be sure to update the
twitter_alt_image, and other non-social tags necessary for your page. The
twitter_creator tags should remain the static value: "@gitlab"
description meta tag is important for SEO, but it's also a part of Facebook and Twitter social cards. The
description should be a short summary of the page. You can think of this as a subtitle.
The description is not meant to repeat the post or page title, use your creativity to describe the content of the post or page. Try to make your description less than 100 characters, if possible.
Adding an image file to the frontmatter for
twitter_image should be added to the [www-gitlab-com] project at
/images/opengraph/ and must be named after the page's file name. While listed as an image for Twitter, this code works for all social sharing sites.
It is important to be as inclusive as possible, which is why providing an alternative text for your image is necessary. Image alt's provide a written summary of what is in the image for users who prefer to be read what is in the image vs seeing it, think of users who use screenreaders to read social media. Text included here should not repeat the title or description and it is not another way to add additional SEO properties - you should simply describe the image. Is the picture a group of GitLab Team Members gathering at Contribute New Orleans? Then that is your image alt text.
This frontmatter aides sites like twitter in understanding how to present additional content. When the link is shared on Twitter, a user may see content that Twitter believes is related to the one shared. This is more of an administrative tag that assists on the backend. These values will always be the same and do not require you to update them.
Frontmatter requires a merge, therefore, you'll need to include this as a step in page creation. Once merged, please test your link. Preview the social cards by adding your link to the [Twitter Card Validator], or the [Facebook Debugger].
UTMs are used to track traffic sources & reach of posts/links. All external posts should contain a UTM parameter, please see details in the Digital Marketing handbook.
If you have questions or are unsure how to tag a URL please reach out to the Digital Marketing team &/or the Social Media Manager responsible for the campaign.
Consider our labels as a way to be transparent about our work at every level of our marketing organization. At any given time and at any given level, a Team Member can recall what volume and mix of work is happening. Not only does this help the social team to better organize, but would allow our Team Members up our organization to better understand their entire team, too.
Every social media-related issue should have the following labels, each of which covers our organization in a broader look further up the chain.
More on optional labels will be available soon.
We use giveaways to encourage and thank our community for participating in marketing events such as surveys, user-generate-content campaigns, social programs, and more.
If you're looking for steps on how to create and process swag for a giveaway, please use the GitLab Giveaway Guide
Share your GitLab story!
Tell us your favorite thing you made with GitLab
tell us a time GitLab helped you out of a tight spot)
/source/community/sweepstakesin the www-gitlab-com project. Name the directory the same as the giveaway