The tile serves as a point of entry where customers can learn about your offering, see setup instructions, and install or purchase your offering to unlock out-of-the-box dashboards and additional assets.
For any offerings that do not use the Datadog Agent—including API-based integrations, professional services listings, and software licenses—you only need to create a tile and submit the tile-related files in order to publish your offering. This is called a tile-only-listing. Tile-ony listings apply in situations where Datadog does not host any of the code associated with the API-based integrations, and the other supported offering types do not require any code.
Add any images and a video that you want to use for the integration tile’s media carousel in an images folder. You can add one video to each listing.
Technology Partners can use .png files instead of .jpg files to reduce image compression.
Media Carousel
Define the images you want to add to the integration tile’s media carousel in the media object specified in the tile definition on the manifest.json file.
Contains a list of out-of-the-box metrics included in the integration defined in the following format ending with a comma: metric_name,metric_type,interval,unit_name,per_unit_name,description, orientation,integration,short_name,curated_metric. The metadata.csv file is required for integrations only, not software licenses or professional services.
Provide the JSON files for out-of-the-box dashboards and monitors included in the integration in the dashboards and monitors folders nested in the assets directory.
For both dashboards and monitors, a title and description is required. Dashboards and monitors are required for integrations, not software licenses or professional services.
Technology Partners can create dashboards and monitors in a provisioned sandbox account, and export these assets into JSON files. For more information about dashboards, see Best Practices for Integration Preset Dashboards.
Logos
Add at least one SVG file which can be used in light and dark modes in a logos folder nested in the assets directory, or add the file(s) directly to the assets directory.
Technology Partners are responsible for the licensing of submitted logos.
Changelog
Document release notes and version information in the Changelog.md file using the following format: 1.0.0 / YYYY-MM-DD. This information is displayed in the Release Notes tab of the integration tile.
Technology Partners can add releases and version updates in descending order (latest version at the top).
CODEOWNERS
The CODEOWNERS file belongs in the shared .github directory and defines the individuals or teams responsible for maintaining the content and source code in the Marketplace repository.
When adding links to the README.md file, format them using reference-style links. For example, instead of embedding the URL directly in the text, write see the [official Datadog documentation][1] and define the link reference at the bottom of the file like [1]: https://docs.datadoghq.com/.
Out-of-the-box integrations in the integrations-extras repository can run into validation errors when the forked repository is out of date with the origin.
To resolve validation errors, update the forked repository on the GitHub web app:
