Mattermost Handbook
Need help?How to spend company moneyHow to update the HandbookRelease overview
0.2.1
0.2.1
  • Mattermost Handbook
  • Company
    • About Mattermost
      • List of terms
      • Business model
      • Mindsets
    • "How to" guides for staff
      • How to set up a 1-1 channel
      • How to update the handbook
      • How to manage Handbook notifications
      • How to change mobile device
        • How to handle a lost mobile device
      • How to do a mini-retrospective
      • How to autolink keywords in Mattermost
  • Operations
    • Company operations
      • Areas of Responsibility
      • Mattermost Leadership Team (MLT)
        • MLT cadence
      • Company measures
        • Metrics definitions
        • FY23 goals board
        • MLT metrics
      • Company cadence
      • Company policies
        • Community response policy
        • Security policy
      • Company processes
        • Issue/solution process
        • Company agreements
        • Publishing
          • Public web properties
          • Publishing guidelines
            • Brand and visual design guidelines
            • Voice, tone, and writing style guidelines
              • Contribute to documentation
            • Confidentiality guidelines
          • Post-publication quality control process
      • Handbook processes and policies
        • Handbook onboarding
      • Fiscal year planning
    • Research and Development
      • Organization
        • Tech Writing
        • Data engineering
        • Delivery
        • Cloud Platform
        • Site Reliability Engineering
        • GRC
        • Product Security
        • Security Operations
      • Processes
        • Feature Labels
      • Product
        • Product planning
          • Product philosophy and principles
          • Prioritization process
          • Release planning process
          • Roadmap views
          • Release plan
          • Launch plan
          • Feature requests
        • Development process
          • Mobile feature guidelines
          • Deprecation policy
          • Mattermost software requirements process
          • Jira ticket lifecycle
          • Creating new Jira bug tickets
            • Priority levels for tickets
            • Jira fix versions
        • Release process
          • Release overview
          • Feature release process
          • Dot release process
          • Security release process
          • Mobile app release process
          • Desktop app release process
          • Release tips
          • Release scorecard definitions
        • How-to guides for Product
          • How to use productboard
          • How to record a roadmap video
          • How to update integrations directory
          • How to write a feature release announcement
        • Product Management team handbook
          • Product Management Areas of Ownership
          • Product Manager onboarding
          • Product Manager levels
          • Professional development
        • Product Design team handbook
          • Product Design levels
        • Technical Writing team handbook
          • Work with us
          • User interface text guidelines
          • Documentation style guide
          • Our terminology
          • Guidelines for PMs and developers
          • Guidelines for community contributions
          • Technical Writer levels
          • Docathon 2021
            • Getting started with contributing
        • Growth
          • A/B testing methodology
          • PQL definition
        • Analytics
          • Product Analyst Engineer levels
          • Looker
            • Dashboards
            • Explores
          • Telemetry
        • Developer relations
        • Product team hangouts
      • Engineering
        • Infrastructure engineering
          • Cloud infrastructure cost KPIs
          • Cloud data export process
          • Cloud churn process
          • Reliability Manifesto
          • Production Readiness Review
          • Infrastructure Library
        • Integrations team processes
        • Plugin release process
        • Data Engineering
        • Sustained Engineering
          • On call
        • How to go to a conference
        • Public speaking
        • Core contributor expanded access policy
      • Quality Assurance
        • QA workflow
        • QA testing tips and tools
        • Rainforest process
    • Messaging and Math
      • How-to guides for M&M
        • How to create release announcements
        • How to create screenshots and GIFs
        • How to write Mattermost case studies
        • How to write guest blog posts for Mattermost apps and services
        • How to write Mattermost recipes
        • How to compose tweets
        • How to create a split test for web page
        • How to run meetups
        • How to run executive dinners
      • Checklists for M&M
        • Blog post checklist
        • Bio checklist
      • Mattermost websites
      • Demand generation reporting
      • M&M Asana guidelines
      • Content marketing
        • How to use the editorial calendar
        • Content development and distribution
        • Video content guidelines
        • How to contribute content
    • Sales
      • Deal Desk
      • Partner programs
      • Lead management
    • Deployment Engineering
      • Overview
      • Workflows
      • Frequently Asked Questions
      • Playbook for MME Sev 1 Outages
      • Status Update Template
    • Program Management
    • Customer Success
      • Customer Support
    • Legal
      • Contracts
      • Ironclad Basics
        • Company-Wide Workflows
        • Sales Contracts and Workflows
        • Signing a Contract and Contract Repository
    • Finance
      • Budget
      • How to use Airbase
        • Access Airbase
        • Navigate Airbase
        • How to submit a purchase request
        • How to submit a reimbursement request
        • How to review a reimbursement request
        • Vendor portal guide
        • Frequently asked questions
      • Onboarding
        • Vendor onboarding
        • ROW staff onboarding
      • Staff member expenses
        • How to spend company money
        • How to spend company money: Internships
        • Corporate credit card policy
        • How to access Airbase
        • Gifting policy
        • How to book airfare and travel
        • How to reimburse the company
        • How to convert currencies
        • How to get paid
      • Arrange a Bounty Program
      • Naming files and agreements
      • Risk management
        • Mattermost U.S. consulting agreements
      • Operations playbook
    • Security
      • Policies
      • Privacy
        • Data deletion requests
        • Data subject access requests
      • Product Security
        • Product Vulnerability Process
        • Working on security-sensitive pull requests
        • Secure Software Development guide
      • Security Operations
        • User guides
    • Workplace
      • PeopleOps
        • HR cadences
        • HR systems
        • HR Processes
        • Working at Mattermost
          • Onboarding
            • Things everyone must know
            • Staff onboarding
            • Engineer onboarding timeline and expectations
            • Manager onboarding
            • Frequently asked questions
          • Learning and development
          • Mattermost communication best practices
          • Paid time off
            • Out of office email example
          • Travel
            • Business travel insurance
          • Leaves of absence
            • Pregnancy leave
            • Baby bonding parental leave
            • Jury duty
          • Workplace program
          • Relocation
          • Total rewards
        • Performance reviews
          • Formal review process
          • New staff performance review
          • Informal review process
        • Transfers and promotions
        • Offboarding instructions for managers
        • People compliance
      • People policies
      • Groups
        • Staff Resource Groups
      • Approvals and iteration
      • IT
        • IT helpdesk
        • Hardware and software purchases
        • Hardware buy back policy
        • Software systems
  • Contributors
    • Contributors
      • Equity, diversity, and inclusion
      • How to contribute to Mattermost
        • Community Content program
        • Documentation contributions
        • Help Wanted tickets
        • Localization
        • Contribution events
      • Mattermost community
      • Contributor kindness
      • Community systems
      • Guidelines and playbooks
        • Social engagement guidelines
        • Contribution guidelines and code of conduct
        • Mattermost Community playbook
        • How to run a Hackathon
        • Hacktoberfest event organizer guide for Mattermost
    • MatterCon
      • Staff information privacy management
      • Mattermost events code of conduct
      • MatterCon2021
    • Join us
      • Ice-breakers
      • Help Wanted tickets
      • Localization
      • Mattermost GitHub sponsorship
      • Things candidates should know
      • Staff recruiting
      • Recruiting cadences
        • Product Manager hiring process
      • Exec recruiting
        • EA logistics
  • Help and support
    • Contact us
Powered by GitBook
On this page
  • Initial steps
  • Integration elements
  • Title
  • Description
  • Author
  • Language
  • License
  • Download URL
  • Source code URL
  • Date Published
  • Categories
  • Featured image
  • Date last updated
  • Guidelines
  • Marketing
  • Announcement
  • Release date T-0

Was this helpful?

Edit on Git
Export as PDF
  1. Operations
  2. Research and Development
  3. Product
  4. How-to guides for Product

How to update integrations directory

PreviousHow to record a roadmap videoNextHow to write a feature release announcement

Last updated 4 years ago

Was this helpful?

This document outlines the internal process for updating . New integrations get submitted in the via .

Initial steps

  1. Go to and log in with your account. If you don’t have an account, ask Marketing for access.

  2. Navigate to Posts on the left hand sidebar.

  3. To add a new integration select Add New.

Integration elements

The following includes guidelines for specific elements of an integration.

Title

Short title of the integration, effectively its name. Examples:

  • Facebook

  • Twitter

  • BigBlueButton Plugin

Note: If the integration is a plugin, please include “Plugin” in the title.

To confirm whether an integration is a plugin, check its install instructions to see what it refers to. For example, if it says to configure it as a webhook in Mattermost and as a plugin in Jenkins, it's a plugin in Jenkins, not in Mattermost.

Note: If it's an Amazon-related integration, include both the official and short form in the title. For example "Amazon AWS SNS Plugin".

Description

Include a short description of the integration, typically provided by the integration creator. You can also usually find a description of the integration on the GitHub project.

Note: Don’t end the description with a period.

Author

This is the GitHub author of the integration. Depending on the details in their GitHub profile this should always be a full name or a company name. If neither a full name or a company name is public on their GitHub profile, using their GitHub username is also fine.

Language

This is the programming language of the integration.

You can find this by clicking on the colored bar in the GitHub project, below the header containing Commits, Branches, Releases, Contributors, and choose the language(s) higher than 30%.

Tips:

  • Don't add "Makefile" unless it's the only language on the repo.

  • Use "Go" instead of "Golang".

  • If there is no language, set to "N/A" instead of leaving it blank.

License

This is typically found in the GitHub project, on the file named “LICENSE”. The license file should specify the license type.

For formatting, write "Apache 2.0", "BSD 2-Clause" or "BSD 3-Clause".

When the integration is not open source, mark the license as "N/A - not open source".

Download URL

Link to the README file on the GitHub project which typically includes install instructions.

Source code URL

Link to their GitHub repo.

Date Published

Typically found in the GitHub project by selecting the Releases tab in the header. Navigate to the oldest release, and use its date as the Date Published field. If there are no releases, go to the Contributors tab in the header, and select the start date as the Date Published field.

Categories

Choose the categories you feel best fit the integration. If you’re uncertain, compare what categories are used by Slack, Atlassian, and/or Salesforce (see list below). If you're still uncertain, ask the Integrations PM.

Featured image

This is a logo of the integration, e.g. Facebook logo for Facebook integration.

Use an icon that's at least 80x80px in size.

Date last updated

Check the date of "Last Commit" on the repository.

Guidelines

  1. The integration must have been updated in the last 12 months.

  2. Every integration link must be related to Mattermost. Especially if the integration is not open source, it should be obvious to users that it's related to Mattermost.

Marketing

  • Add integration/plugin creators to changelog’s list of contributors.

    • For example: For March release, add any new ones from February.

  • Post a tweet for all new integrations.

Announcement

  1. Once the integration entry has been added to the directory, please reply back in the Integrations channel with a screenshot of the entry that was added, a link to its install guide, and an at-mention for the Integrations PM. Example:

[@-username] Standup Raven Plugin added to https://integrations.mattermost.com

https://github.com/standup-raven/standup-raven/blob/master/README.md

[Attached image]

Release date T-0

  1. Add integrations with more than 50 stars to the “New and Noteworthy” category.

  2. Add 8 most recent integrations to the “New and Noteworthy” category. The oldest on this list should be removed when a new integration is added.

  3. Update the Date Last Updated for all integrations.

  4. Remove any integrations that haven’t been updated in the last 12 months.

    • Note: Keep this relaxed. Some older ones are still important to keep.

  5. Ask the Integrations PM if any integrations are good to add or remove from the "Staff Picks" section.

Note: These integrations should be kept in the "New and Noteworthy" category:

Note: License must be compatible with (e.g. not GPLv3, nor APGLv3). If it's not compatible with Apache 2.0, do not add the integration to the website.

Use Twitter to find official logos if none are provided by the integration creator. If there is no good icon/logo to use, go to and choose an icon that best fits the integration type.

License of the integration must be compatible with (e.g. not GPLv3 or APGLv3). The only exception is if the integration is not open source.

For example: .

Once the Integrations PM has acknowledged, please re-post to .

https://integrations.mattermost.com/
Integrations and Apps channel
this form
https://mmapps.wpengine.com/wp-login.php
Apache 2.0
https://marketplace.atlassian.com/
https://slack.com/apps
https://appexchange.salesforce.com/
https://mattermost.wayfx.com/0ddc9bpne/p/45193
Apache 2.0
https://twitter.com/Mattermost/status/1102709312231596032
Announcements channel
https://www.pagerduty.com/docs/guides/mattermost-integration-guide/
https://marketplace.atlassian.com/apps/1215055/slack-for-confluence?hosting=cloud&tab=overview
https://github.com/cpanato/mattermost-plugin-statuspage
https://github.com/Lujeni/matterllo
https://docs.opsgenie.com/docs/mattermost-integration
https://github.com/blindsidenetworks/mattermost-plugin-bigbluebutton
https://github.com/cvitter/mattermost-bitbucket-bridge
https://github.com/42wim/matterbridge
https://github.com/loafoe/hubot-matteruser
https://github.com/mattermost/mattermost-plugin-github
https://github.com/mattermost/mattermost-bot-sample-golang
https://github.com/mattermost/mattermost-plugin-jira
https://github.com/mattermost/mattermost-plugin-zoom