---
title: "Common parameters - Cloud"
canonical: "https://support.appfire.com/space/GVIZ/70224003/Common%20parameters%20-%20Cloud"
format: markdown
---
> Macro (aura-html)


The following parameters are available with all Graphviz macros:


| **Macro Editor Label** | **Default** | **Description** | **Macro Parameter** |
| --- | --- | --- | --- |
| <span style="color: #000000">Output type</span> | <span style="color: #000000">svg</span> | <span style="color: #000000">Specifies the output type to be generated by Graphviz. </span><br>- <span style="color: #000000">png</span>
- <span style="color: #000000">svg</span>
- <span style="color: #000000">jpg</span>
- <span style="color: #000000">gif</span> | <span style="color: #000000">output</span> |
| <span style="color: #000000">Profile</span> |  | <span style="color: #000000">Specifies the profile the macro uses to read data from an external application such as GitLab or GitHub. </span><br><span style="color: #000000">Profiles refer to common parameters that administrators create and configure to access data from external sources. Contact your administrator to know more about the profiles that are configured in your instance. Refer to the </span><span style="color: #000000">[administrator guide](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70224052/Configure+for+cloud#gviz_config_profiles)</span><span style="color: #000000"> to understand more about profiles.</span><br>> ⚠️ <span style="color: #000000">This parameter is not available in </span><span style="color: #000000">*Graph from table*</span><span style="color: #000000"> and </span><span style="color: #000000">*Space graph*</span><span style="color: #000000"> macros.</span> | profile |
| <span style="color: #000000">Location of Graphviz source</span> |  | <span style="color: #000000">Specifies the source from where the macro reads the data. </span><br>- <span style="color: #000000">*blank*</span><span style="color: #000000"> - The body is used.</span>
- <span style="color: #000000">*^attachment*</span><span style="color: #000000"> - Data is read from an attachment to the current page. Input the value in the format ^</span><span style="color: #000000">*Filename.extension.*</span>
- <span style="color: #000000">*page^attachment*</span><span style="color: #000000"> - Data is read from an attachment to the page name provided.</span>
- <span style="color: #000000">*space:page^attachment*</span><span style="color: #000000"> - Data is read from an attachment to the page name provided in the space indicated.</span>
- <span style="color: #000000">*global page template name*</span><span style="color: #000000"> - Data is read from a global page template.</span>
- <span style="color: #000000">*space:page template name*</span><span style="color: #000000"> - Data is read from a space template.</span><br>> ⚠️ - <span style="color: #000000">Files and templates are not applicable for Confluence Cloud. Refer to the </span><span style="color: #000000">[Migration guide](https://bobswift.atlassian.net/wiki/x/NYOkOw)</span><span style="color: #000000"> for more details.</span>
> ⚠️ - <span style="color: #000000">Graphviz recognizes the commands only when you nest the commands under </span><span style="color: #000000">*noformat*</span><span style="color: #000000">, </span><span style="color: #000000">*code*</span><span style="color: #000000">, or </span><span style="color: #000000">*code-pro*</span><span style="color: #000000"> macros, for the sources mentioned below:</span>
> ⚠️   - <span style="color: #000000">*global page template name *</span>
> ⚠️   - <span style="color: #000000">*space:page template name*</span> | <span style="color: #000000">script</span> |
| <span style="color: #000000">Show Graphviz markup code</span> | <span style="color: #000000">False</span> | <span style="color: #000000">Shows the Graphviz markup code below the generated graph. Useful for fixing syntax errors or to see the markup that is generated by macro processing or macros like the Space graph macro.</span> | <span style="color: #000000">showCode</span> |
| <span style="color: #000000">Attachment name</span> |  | <span style="color: #000000">The name of the attachment to use. This is useful when the Graphviz image must be uploaded as a new attachment or to update an existing attachment. Although attachments are optional, they can be useful for linking from other places.</span><br><span style="color: #000000">Examples:</span><br>- <span style="color: #000000">*graphviz.png*</span><span style="color: #000000"> — the image is saved as an attachment to the current page.</span>
- <span style="color: #000000">*page^graphviz.png*</span><span style="color: #000000"> — the image is saved as an attachment to the page name provided.</span>
- <span style="color: #000000">*space:page^graphviz.png*</span><span style="color: #000000"> — the image is saved as an attachment to the page name provided in the space indicated.</span> | <span style="color: #000000">attachment</span> |
| <span style="color: #000000">Attachment version</span> | <span style="color: #000000">new</span> | <span style="color: #000000">Specifies how the generated graph is persisted as an attachment.</span><br>- <span style="color: #000000">*New*</span><span style="color: #000000"> — creates a new version of the attachment.</span>
- <span style="color: #000000">*Replace*</span><span style="color: #000000"> — replaces all previous versions of the attachment. To replace an existing attachment, the user must be authorized to remove attachments for the page specified.</span>
- <span style="color: #000000">*Keep*</span><span style="color: #000000"> — only saves a new attachment if there is no existing attachment. An existing attachment will not be changed or updated.</span> | <span style="color: #000000">attachmentVersion</span> |
| <span style="color: #000000">Attachment comment</span> |  | <span style="color: #000000">Specifies the comment on the attachment that is created or updated.</span> | <span style="color: #000000">attachmentComment</span> |
| <span style="color: #000000">Attachment versions to keep</span> |  | <span style="color: #000000">Limits the number of attachment versions of a file that is attached to a page. If the maximum number of attachments exceeds the limit, then the oldest version is deleted.</span><br>> ⚠️ <span style="color: #000000">This parameter is only applicable if you select </span><span style="color: #000000">*New*</span><span style="color: #000000"> from the drop-down list under </span><span style="color: #000000">*Attachment version*</span><span style="color: #000000">, in the macro editor.</span> | attachmentLimit |
| <span style="color: #000000">Thumbnail</span> | <span style="color: #000000">False</span> | <span style="color: #000000">Used when an attachment is specified, and output is </span><span style="color: #000000">*png*</span><span style="color: #000000">, </span><span style="color: #000000">*jpg*</span><span style="color: #000000">, or </span><span style="color: #000000">*gif*</span><span style="color: #000000">. Renders graph as a thumbnail with default size 128x128px.</span><br>> ⚠️ - <span style="color: #000000">In some cases, the image and the thumbnail generated are of the same size. This is because the image is too small and fits the preview screen perfectly.</span>
> ⚠️ - <span style="color: #000000">This parameter is not applicable for </span><span style="color: #000000">*Graph*</span><span style="color: #000000"> macro.</span> | <span style="color: #000000">thumbnail</span> |
| <span style="color: #000000">Render wiki markup macros in body</span> | <span style="color: #000000">False</span> | <span style="color: #000000">Set to true to render wiki markup macros found in the body before processing as Graphviz markup.</span><br>> ⚠️ - <span style="color: #000000">Only the following wiki markup macros are supported for processing as Graphviz markup:</span>
> ⚠️   - <span style="color: #000000">*noformat*</span>
> ⚠️   - <span style="color: #000000">*code*</span>
> ⚠️   <span style="color: #000000">In other words, the output of any other wiki markup macro (that is not available on Cloud), is not a valid input to Graphviz macros. Though you can insert such macros in the Graphviz macro body, you are likely to encounter a rendering error in the published page.</span>
> ⚠️ - <span style="color: #000000">This parameter is not available in </span><span style="color: #000000">*Graph from table*</span><span style="color: #000000"> and </span><span style="color: #000000">*Space graph*</span><span style="color: #000000"> macros.</span> | <span style="color: #000000">macros</span> |
| <span style="color: #000000">Layout</span> | <span style="color: #000000">dot</span> | <span style="color: #000000">Specifies which default layout algorithm to use.</span><br>- <span style="color: #000000">*dot*</span><span style="color: #000000">− filter for drawing directed graphs</span>
- <span style="color: #000000">*neato*</span><span style="color: #000000"> − filter for drawing undirected graphs</span>
- <span style="color: #000000">*twopi*</span><span style="color: #000000">− filter for radial layouts of graphs</span>
- <span style="color: #000000">*circo*</span><span style="color: #000000">− filter for a circular layout of graphs</span>
- <span style="color: #000000">*fdp*</span><span style="color: #000000">− filter for drawing undirected graphs</span> | <span style="color: #000000">layout</span> |
| <span style="color: #000000">URL to 'macro' file</span><br><span style="color: #000000">*(macro ~ Graphviz/ Diagraph/ Graph)*</span> |  | <span style="color: #000000">Specifies the URL link to the Graphviz file. Administrators may restrict use.</span><br>> ⚠️ - <span style="color: #000000">The URLs are restricted to the whitelisted URLs.</span>
> ⚠️ - <span style="color: #000000">This parameter is not available in </span><span style="color: #000000">*Graph from table*</span><span style="color: #000000"> and </span><span style="color: #000000">*Space graph*</span><span style="color: #000000"> macros.</span> | <span style="color: #000000">URL</span> |
| <span style="color: #000000">URL connection timeout</span> |  | <span style="color: #000000">Used to increase the wait time for URL access on slower connections. </span> | <span style="color: #000000">timeout</span> |
| <span style="color: #000000">File encoding</span> |  | <span style="color: #000000">Allows the user to specify the encoding if it is different from the Confluence default (like Windows-1252, UTF-8, MacRoman). </span> | <span style="color: #000000">encoding</span> |