The content library is where all your uploaded assets are stored and tagged in PathFactory.
https://about.gitlab.com/customers/extra-hop-networks/ and https://about.gitlab.com/customers/extra-hop-networks would be considered different URLs and both would be uploaded to the library (note the trailing /).Add Content in the top right of the content library.Public Configurations. Ensure that the title is free of SEO meta information such as | GitLab.content type selected. Scoring thresholds by content type can be referenced heresource URL and locate Custom URL slug.[LIVE] content track. You can see whether an asset is part of a live content track by clicking on it in the content library and scrolling to the bottom of the preview pane. This action can affect any links to this item that have been previously shared.https:// to content tracks by default. As a result, all assets must use https:// in the link to work in the content track properly. If you upload content that is not secure, it will not show a lock icon next to the URL and it will not work in a secure content track. Please manually add https:// if it is not already there.If you need to replace an asset source but keep the same link, you can do so from the content library.
Source URLSource URL a pencil appears to the rightFile Upload or Website URL as relevantYou can bulk upload multiple new assets to the content library via a CSV file.
Overwrite all duplicate content assets.Upload File button.Content owners understand how their content should be tagged. Marketing operations can assist with a bulk upload but are not responible for tagging the content with metadata (types, topics, etc.). If you would like marketing operations assistance with a bulk upload, open an issue in the marketing operations project using the PathFactory Bulk Upload template.
Expiry dates will not automatically deactive content after expiration. You must manually deactivate the content if it’s past the expiry date. To expire an analyst report from PathFactory, open an issue in the Campaigns project using the campaigns-expire-analyst issue template.
To upload a Vimeo video to PathFactory, you must first upload your video to Vimeo. Once your video is uploaded to Vimeo, follow these steps to add to PathFactory:
Settings of your video in Vimeo.General > Privacy, select Hide this video from vimeo.com. Note: Other privacy settings will not allow the video to be embedded in a content track.Where can this be embedded? select Specific domains and enter https://learn.gitlab.com.save, and you'll notice Vimeo now indicates the video is private (in the top right corner).Embed in the left sidebar.Embed Code Button in the top right corner.Example embed code with Vimeo player URL:
<iframe src="https://player.vimeo.com/video/514439220" width="640" height="360" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe>
The Vimeo player URL is the https://player.vimeo.com/video/514439220 link within the embed code. This is the link used to upload to PathFactory.
When the asset is added to a content track, you'll have a working, embedded, private Vimeo video.
Important: Do not remove an asset from the content library without first checking which content tracks it is in and following the procedure below. Certain assets within content tracks may be directly tied to an integrated campaign, digital advertising, or other live campaign. If you remove the asset from the library, it consequently removes it from whatever content tracks it is in, thus breaking the campaign setup and tracking.
Author of the respective tracks the asset resides in to ensure it is not linked within an ad, email, etc.For assets that don't pull in a relevant thumbnail image, you can choose to upload a thumbnail image that closely matches the topic of the asset. The design team has made topical thumbnail images available for upload to PathFactory. The thumbnail images are available in either an orange or dark purple background for the following topics:
To use a thumbnail image, visit the web design repository where they are stored, choose the png folder, choose your preferred background color, then select the .png that most closely matches the topic of the asset in PathFactory you're uploading the image to. Use the list of topics above to determine the best topic fit.
Public Configurations, you'll find the thumbnail for the asset. Hover over the image and click the edit icon.Unsure what content types align with your asset? Use the table below as a guideline to tag content you upload to PathFactory accordingly.
| Type | Use | Example |
|---|---|---|
| Analyst report | Third-party content licensed from an analyst firm | Gartner Magic Quadrant for ARO |
| Assessment | Content with the primary purpose of providing a self-assessment, quiz, or maturity model. | |
| Case study | Web articles that focus on the stories and opinions of GitLab customers. | Goldman Sachs improves from 1 build every two weeks to over a thousand per day |
| Data sheet | A document providing the specifications of GitLab the product or feature/feature set. | GitLab data sheet |
| Demo | A live-action video recording demonstrating how to do or use a technical product. | GitLab Security & Compliance Capabilities Demo |
| eBook | An eBook presents educational information that helps the reader gain a comprehensive understanding of a subject. eBooks are casual in tone and are most often an awareness-stage asset. | Modernize your CI/CD |
| Infographic | A visual asset used to represent information or data. | |
| Landing page | ||
| Presentation | Video recording or slides of a live talk. | Multicloudcon Keynote: The Multicloud Maturity Model |
| Pricing | A document that details pricing for GitLab products. | (GitLab pricing)[https://about.gitlab.com/pricing/] |
| Product article | ||
| Research report | An informational report which uses a specific research metholody to validate findings. | 2019 Global Developer Survey: DevSecOps |
| Solution article | ||
| Technical blog post | ||
| Testimonials | A formal statement from a customer or user regarding GitLab's value. | |
| Thought leadership blog post | ||
| Topic article | ||
| Video | A scripted, edited, & post-produced video. Videos can be promotional, educational, and/or animated. | GitLab Infomercial |
| Webcast | A live broadcast & recording that includes a presenter, slides, and a live audience. | Cloud Native Transformation with Ask Media Group |
| Whitepaper | Whitepapers are data-driven, persuasive, and opinionated reports that address a specific problem for a niche audience. A whitepaper presents new research, addresses a specific problem, and argues in favor of a specific solution. Whitepapers are academic and authoritative in tone. Whitepapers are most often introduced in the consideration or decision making stage to prove or validate a concept or solution. | A seismic shift in application security |
Unsure what content topics align with your asset? Use the table below as a guideline to tag content you upload to PathFactory accordingly.
| Topic | Use | Example |
|---|---|---|
| Agile | ||
| All-remote | Content that covers remote work, including best practices, stories, and advice. | The case for all-remote companies |
| Amazon Web Services (AWS) | Content that relates Amazon Web Services. Likely use cases are case studies where the customer uses GitLab + AWS and integration information & tutorials. | How to set up multi-account AWS SAM deployments with GitLab CI/CD |
| Azure | Content that talks specifically about Microsoft Azure. Likely uses cases are tutorials on using GitLab + Azure cloud or competitive content. | Competitive analysis page for Azure DevOps |
| Bitbucket | ||
| Checkmarx | ||
| Cloud native | Content that relates container-based environments. Specifically, technologies are used to develop applications built with services packaged in containers, deployed as microservices and managed on elastic infrastructure through agile DevOps processes and continuous delivery workflows. | A Cloud Native Transformation |
| Continuous delivery | Content that covers methods and tools for delivering or updating software in smaller increments, resulting in a better end-user experience. Both technical and strategic content may be found. | Securing the journey to Continuous Delivery |
| Continuous integration | ||
| DevOps | Content that relates to DevOps methods, process, culture, and tooling. Keys to DevOps success with Gene Kim | |
| DevSecOps | Content that relates specifically to integrating and automating security into the software development lifecycle. Content that relates to cybersecurity should be tagged security and not devsecops. |
A seismic shift in application security |
| Digital transformation | Content that covers the process, methods, and strategy of integrating technology into all aspects of business. This content also includes strategies, tools, and tactics for furthering innovation, building new efficiencies, and delivering higher value faster. | The cloud adoption roadmap |
| GitHub | ||
| GitOps | ||
| Google Cloud Platform (GCP) | ||
| Hashicorp | ||
| Infrastructure as code | ||
| Infrastructure automation | ||
| Jenkins | Content that is specifically about Jenkins. Likely uses cases are integrations, competitive, comparisons, and case studies. | 3 Teams left Jenkins: Here's why |
| JFrog | ||
| Jira | ||
| Kubernetes | Content that relates to implementing and using kubernetes. Likely use cases are cost/benefits, tutorials, and use cases. | Kubernetes and the future of cloud native: We chat with Kelsey Hightower |
| Open source | Content that covers open source projects, partnershipship initiatives, and community contributions. | What to consider with an open source business model |
| Pulumi | ||
| Rally | ||
| Source code management | Content that relates to source code management, Git, GitLab Flow, and version control. | GitLab Workflow: An Overview |
| Veracode | ||
| Version control and collaboration |
Industry verticals are set using a standard list in SFDC per this issue.
If you try to upload a web page from a domain that you do not own and that web page has not whitelisted your PathFactory track URLs, you will be served an error message telling you that you cannot upload this content to the Content Library.
Because you do not own this web page, your options are limited. You will be unable to add these third party web pages to the Content Library. You can use this content in an End Promoter in a content track if the following is true:
What you can do:
When you enable the End Promoter, add the destination URL of the blocked content. When a visitor reaches the end of the Content Track, they will be prompted with your call to action End Promoter. If the visitor clicks on this promoter, the destination URL (of the blocked content) will open in a new tab.
More on iFrame blocking can be found here.
When uploading third-party assets, always ensure they are secure URLs (https://). Content that is not secure will not display in content tracks. Also, third-party web pages would need to allow iFraming as PathFactory tracks are served within an iFrame.
Two years from the day it was uploaded. Please review any assets in the library older than two years and consider expiring from the content library.
Important: Please consult with marketing operations before removing an asset from the library as it can have negative impacts (reporting, attribution) on content tracks that are tied to integrated campaigns.
On a quarterly to bi-quarterly basis, the marketing operations and content teams will conduct content audits in PathFactory to ensure the assets in the library are tagged with the correct metadata. Content audits in PathFactory are done to ensure the content performance reports are accurate. This helps all teams understand how certain types and topics of content perform. Without an accurate tagging of assets in the library, the data in our reports would be skewed, and thus our understanding of how our content performs.
Both marketing operations and the content marketing team work in collaboration with demand generation and product marketing to ensure alignment to GTM strategies as well.