Splunk® Enterprise

Dashboards and Visualizations

Acrobat logo Download manual as PDF


Splunk Enterprise version 7.1 is no longer supported as of October 31, 2020. See the Splunk Software Support Policy for details. For information about upgrading to a supported version, see How to upgrade Splunk Enterprise.
Acrobat logo Download topic as PDF

Editing Simple XML

You can use interactive editors to create and edit dashboards without having to edit Simple XML source code. However, some advanced dashboard features are not available from interactive editors. You can access these features by editing the underlying simple XML code.

Edit dashboard source code

Edit dashboard Simple XML source code to customize settings that are not accessible from the user interface. The dashboard source code editor provides interactive validation as you make updates.

Prerequisites
If you are unfamiliar with Simple XML, review the following information before you edit source code.

Steps

  1. From the Dashboards listing page, open the dashboard that you want to edit.
  2. Select Edit to open the dashboard editor.
  3. Click Source to open the source code editor.
  4. Edit the source code.
    The editor provides automatic tag closing and validation. It also displays warnings or error messages as needed. Hover over a warning or error icon next to a line of source code to view details.
  5. If the Save button is disabled, correct any code with validation warnings or errors. Otherwise, click Save to save your edits.

Special characters in XML files

Some characters have special meaning in Simple XML files. To prevent the source code parser from treating them as special characters, wrap them in <![CDATA[]]> tags.

<![CDATA[
<content_with_special_characters>
]]>

You can also escape these characters using HTML entities.

Character Description HTML Entity
' apostrophe &apos;
? question mark &quest;
' plus sign &plus;
" quote &quot;
< left angle bracket &lt;
> right angle bracket &gt;
& ampersand &amp;

Read-only access to dashboard Simple XML code

Access a read-only version of dashboard source code by appending the showsource query parameter to the dashboard URL. See the following example.

https://host:port/en-US/app/my_app/my_dashboard?showsource

Note: Read-only source code access is available only for Simple XML dashboards. Read-only HTML or Advanced XML source code is not accessible using the URL.

Additional information

Before you edit Simple XML, review the following resources.


Splunk Enterprise users can edit Simple XML using a third-party editor. This option is not available in Splunk Cloud Platform. See Using a third party XML editor.

Last modified on 21 July, 2021
PREVIOUS
Convert a dashboard to HTML
  NEXT
Searches power dashboards and forms

This documentation applies to the following versions of Splunk® Enterprise: 7.0.0, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7, 7.0.8, 7.0.9, 7.0.10, 7.0.11, 7.0.13, 7.1.0, 7.1.1, 7.1.2, 7.1.3, 7.1.4, 7.1.5, 7.1.6, 7.1.7, 7.1.8, 7.1.9, 7.1.10, 7.2.0, 7.2.2, 7.2.3, 7.2.4, 7.2.5, 7.2.6, 7.2.7, 7.2.8, 7.2.9, 7.2.10, 7.3.0, 7.3.1, 7.3.2, 7.3.3, 7.3.4, 7.3.5, 7.3.6, 7.3.7, 7.3.8, 7.3.9, 8.0.0, 8.0.1, 8.0.2, 8.0.3, 8.0.5, 8.0.10, 7.2.1, 7.0.1, 8.0.4, 8.0.9, 8.1.0, 8.1.1, 8.1.2, 8.1.3, 8.1.4, 8.1.5, 8.1.6, 8.1.7, 8.1.8, 8.1.9, 8.1.10, 8.1.11, 8.1.12, 8.1.13, 8.1.14, 8.2.0, 8.2.1, 8.2.2, 8.2.3, 8.2.4, 8.2.5, 8.2.6, 8.2.7, 8.2.8, 8.2.9, 8.2.10, 8.2.11, 8.2.12, 9.0.0, 9.0.1, 9.0.2, 9.0.3, 9.0.4, 9.0.5, 9.0.6, 9.0.7, 9.0.8, 9.1.0, 9.1.1, 9.1.2, 9.1.3, 9.2.0, 8.0.6, 8.0.7, 8.0.8


Was this documentation topic helpful?


You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters