{
"label": "Gauge Visualization",
"category_label": "plug-ins",
"branding": {
"image_uri": "https://marketplace-api.looker.com/visualization-screenshots/gauge_icon.png",
"tagline": "Use the Gauge visualization to display a measure and progress to a goal."
},
"constants": {
"vis_label": {
"label": "Visualization Label",
"description": "This label will appear in the visualization selector in the Looker Explore UI."
},
"vis_id": {
"label": "Visualization Id",
"description": "This must be a unique ID across all visualizations.",
"value_constraint": "visualization"
}
}
}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-08-18 (世界標準時間)。"],[],[],null,["# Developing a custom visualization for the Looker Marketplace\n\nThis page describes how to create a custom visualization type that can be added to the [Looker Marketplace](/looker/docs/marketplace) and accessed by other Looker users. You can also create a [custom visualization](/looker/docs/reference/param-manifest-visualization) directly in your project without making it available to other Looker customers.\n\u003e Please note that you must be a member of the Looker Partner Network or a Looker customer to submit content to the Looker Marketplace.\n\nThe Looker Marketplace is a central location for finding, deploying, and managing many types of Looker content, such as Looker Blocks™, applications, visualizations, and other plug-ins.\n\u003e With the Looker [**Marketplace**](/looker/docs/admin-panel-platform-marketplace) feature enabled, Looker customers can [install Looker Marketplace **plug-ins**](/looker/docs/marketplace#installing_a_tool_from_the_marketplace), which include visualization types to add to Looker's native visualization library.\n\nTo develop a custom visualization and make it available to all Looker customers through the Looker Marketplace, follow these steps:\n\n1. [Develop a visualization](#developing_a_visualization_type).\n2. [Create a Looker project for the visualization](#creating_a_looker_project_for_the_visualization).\n3. [Push the Looker project to a Git repository](#pushing_the_project_to_git).\n4. [Test the functionality of the visualization](#checking_the_functionality_of_the_visualization).\n5. [Submit your visualization to Looker](#submitting_the_visualization_for_review).\n\n### Developing a visualization type\n\nIdentify a visualization type that you'd like to develop. (Confirm that this visualization is not already listed in the [Marketplace](/looker/docs/marketplace) or as a [native Looker visualization](/looker/docs/visualization-types).)\n\nDevelop your custom visualization in JavaScript using the [Looker Visualization API](https://github.com/looker-open-source/custom_visualizations_v2/blob/master/docs/getting_started.md) with your Javascript environment.\n\n### Creating a Looker project for the visualization\n\nCreate a Looker [project](/looker/docs/generating-a-model) to represent your custom visualization. The project should contain the following files:\n\n- LICENSE file: Lists the license or licenses with which the visualization is distributed, using the text:\n\n \u003cbr /\u003e\n\n `This Looker visualization is distributed with the following license:...`\n\n \u003cbr /\u003e\n\n- `README.md` file: Provides a description of your visualization, how it works, and any additional information.\n\n- JavaScript (`.js`) file: Contains a condensed version of the JavaScript code that you used to produce your visualization. With the Marketplace, JS files are included within the project, which allows for proper versioning and package management.\n\n- [Manifest (`manifest.lkml`) file](/looker/docs/other-project-files#project_manifest_files): Specifies an `id` (a unique identifier) and a `label` (shown in the Looker UI for this visualization). For example:\n\n constant: vis_id {\n value: \"default_id\"\n export: override_optional\n }\n constant: vis_label {\n value: \"default_label\"\n export: override_optional\n }\n visualization: {\n id: \"@{vis_id}\"\n label: \"@{vis_label}\"\n file: \"my_local.js\"\n sri_hash: \"my_sri_hash\"\n dependencies: []\n }\n\n- Listing (`marketplace.json`) file: Configures the Marketplace listing for the custom visualization and includes a label for how the visualization will appear in the Marketplace, the location of the `image_uri`, a tagline that describes the use case for the visualization, and also defines the [Marketplace field constants](/looker/docs/marketplace-develop-custom-blocks#marketplace_constants_field) that users input during installation. For example:\n\n {\n \"label\": \"Gauge Visualization\",\n \"category_label\": \"plug-ins\",\n \"branding\": {\n \"image_uri\": \"https://marketplace-api.looker.com/visualization-screenshots/gauge_icon.png\",\n \"tagline\": \"Use the Gauge visualization to display a measure and progress to a goal.\"\n },\n \"constants\": {\n \"vis_label\": {\n \"label\": \"Visualization Label\",\n \"description\": \"This label will appear in the visualization selector in the Looker Explore UI.\"\n },\n \"vis_id\": {\n \"label\": \"Visualization Id\",\n \"description\": \"This must be a unique ID across all visualizations.\",\n \"value_constraint\": \"visualization\"\n }\n }\n }\n\n### Pushing the project to Git\n\nHost your visualization LookML on a publicly accessible GitHub repository. Assuming that you created the visualization in a Looker project, follow these steps to push it to a new repository:\n\n1. [Create a publicly accessible GitHub repository](https://docs.github.com/en/get-started/quickstart/create-a-repo).\n2. [Set your Looker project's Repository URL](/looker/docs/setting-up-git-connection) to the URL of your GitHub repository.\n3. Follow the Git prompts in Looker to [validate, commit, and deploy your code to production](/looker/docs/version-control-and-deploying-changes#getting_your_changes_to_production).\n\n\n### Testing the functionality of the visualization\n\nTest the new visualization by applying it to an appropriate Explore or Look on your Looker instance:\n\n1. Navigate to the Look or Explore.\n2. If on a Look, click **Edit** to edit the Look.\n3. Click the three-dot menu in the visualization type menu to open the drop-down list of visualizations.\n4. Select your custom visualization.\n5. Click **Save** to save the change to the Look. Note any dashboards that may be impacted by this change.\n\nLooker requires these functions in the visualizations available from the Looker Marketplace:\n\n### Submitting the visualization for review\n\nOnce your visualization is ready for submission, follow the instructions at [Submitting content to the Looker Marketplace](/looker/docs/marketplace-submit-content) to create supporting documentation for your visualization, submit your visualization to the Looker team for review, and publish your visualization to the Looker Marketplace."]]
