Replace a custom dashboard

Update a Custom Dashboard in place by importing a new JSON definition. The dashboard keeps its original ID and URL, and the previous state is saved to version history so you can revert if needed.

Use this flow when you maintain dashboard definitions as JSON outside of Coralogix — for example, after editing an exported file or applying a bulk find-and-replace — and want to push the updated configuration to an existing dashboard without recreating it.

What you need

The team-dashboards:Update permission on the target dashboard.
A valid Coralogix Custom Dashboard JSON file or JSON snippet to import. Export the current dashboard first if you want a baseline to edit. For details, see Import & export Custom Dashboards.

Replace from the dashboard

1.

Open the dashboard you want to replace. In the upper-right corner, open the more actions menu and select Replace & override.

2.

The Override dashboard dialog opens with the following warning:

Replacing imports the JSON into this dashboard. The dashboard ID and URL stay the same, and the current version is saved to version history.

Provide the new definition in one of two ways:

Select Select file, and then choose a .json file from your machine.
Or paste the dashboard JSON into the text area. The placeholder reads Paste the JSON here.

3.

Select Next.

4.

The dialog title updates to Override <dashboard name> dashboard, using the current name of the dashboard you opened. Review the summary of the incoming dashboard, and then select Approve and override to confirm.

To revise your input before confirming, select Back to return to the previous step — your uploaded file or pasted JSON is preserved.

When the replacement succeeds, the dashboard reloads with the new configuration and a Dashboard overridden successfully confirmation appears.

Replace from the dashboards list

You can also replace a dashboard from the dashboards catalog without opening it first.

1.

In the dashboards sidebar, hover over the dashboard you want to replace and open its context menu.

2.

Select Replace & override, and then follow steps 2–4 of Replace from the dashboard.

What happens when you replace a dashboard

The dashboard ID and URL are preserved. Existing bookmarks, shared links, and references continue to resolve.
The dashboard's folder placement is preserved. Replacing does not move the dashboard, even if the imported JSON specifies a different folder.
The custom URL slug is updated if the imported JSON includes one. The slug must be unique within your team. If it conflicts with another dashboard, the override is blocked — see Validation errors.
A new version is saved. The previous configuration is retained in version history. To compare or revert, open the more actions menu and select Version history. For details, see Manage dashboard version history.

Validation errors

The dialog blocks the action if the input is not a usable dashboard definition:

Invalid JSON — the file or pasted text is not valid JSON. Verify the syntax and try again.
Invalid Dashboard — the JSON parses but does not match the Custom Dashboard schema. Export a working dashboard as a reference to confirm the expected structure.
Slug conflict — the imported JSON specifies a custom URL slug that is already used by a different dashboard in your team. The error surfaces on the Override <dashboard name> dashboard confirmation step and blocks submission until you edit the slug in the JSON and re-upload.

If validation passes but the save fails, you'll see Couldn't replace this dashboard. Try again. Retry the action; if the error persists, contact Support.

Additional resources


Documentation	Custom Dashboards
Documentation	Import & export Custom Dashboards
Documentation	Manage dashboard version history