---
title: "Secret"
canonical: "https://support.appfire.com/space/SECC/477727234/Secret"
format: markdown
---
> Macro (aura-html)

> ℹ️ [DECember 2023]  We have released an improved version of Security and Encryption for Confluence Cloud with enhanced security. Check out the [next steps for administrators](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477727589).

## Description

Encrypts text for secure sharing of sensitive information on Confluence Cloud pages.

![image](media://1898fbf4-b4c0-4845-aac7-dc2f4b99f733)

> ℹ️ A step-by-step guide is available - [Using and sharing secrets](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726002).

## Parameters

| **Name** | **Required** | **Default Value** | **Description** |
| --- | --- | --- | --- |
| Title | - [(/)] |  | Enter a title for the secret.<br>Used as secret identifier, although it doesn't have to be unique across the space.<br>Also used as search keywords and shown in multiple locations in Confluence.<br>> ℹ️ Can store up to 255 characters. |
| Description | - [(X)] |  | Enter a description for the secret.<br>> ℹ️ Used to provide context about the secret, as search keywords and shown in multiple locations in Confluence. |
| Secret | - [(/)] |  | The secret to be encrypted in text format.<br>> ℹ️ The only parameter value of the macro that is encrypted. |
| Access Control | - [(X)] |  | ![Highlight of tabs for Secret Macro](media://3e19f2b8-4c8e-4846-8878-eca99d4bc270)<br>Click on the **Access **tab to use this feature and select how you want specified users and/or groups to access the secret.<br>> ℹ️ If you leave the **Users** and the **User Groups** fields blank, then only ***you*** (the owner of the secret) will be able to view it.<br>> ⚠️ The **Deny access** control is now deprecated, and is no longer available in the latest version of this app.
> ⚠️ 
> ⚠️ For more details, read [Deny access control is now deprecated](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726509). |
| Users | - [(X)] |  | Specify user(s) who are allowed to decrypt the secret.<br>> ✅ Start typing in the field to search for a Confluence user or click to select from a menu. |
| User Group | - [(X)] |  | Select group(s) that are allowed to decrypt the secret.<br>> ✅ Start typing in the field to search for a Confluence group or click to select from a menu. |
| User Owners | - [(/)] | (Creator of the secret) | Select user(s) who are allowed full access to the secret, including updating secrets, and add/remove access to secrets.<br>> ℹ️ By default, the secret creator is also the owner.<br>> ✅ Start typing in the field to search for a Confluence user or click to select from a menu. |
| Group Owners | - [(X)] |  | Select group(s) who are allowed full access to the secret including updating secrets, and add/remove access to secrets.<br>> ✅ Start typing in the field to search for a Confluence group or click to select from a menu. |

## Editor View

![image](media://132fd3ad-6700-4690-af41-a97641015cfe)

## Macro Edit View

![image](media://d4ae5d1d-4c7f-4d7e-a8f7-14ce52016931)

![image](media://8d26d9bc-5b0f-412b-8650-c82c3b5e944a)

> ℹ️ The secret macro is an entity of the space, not the page. Users with access to the space can view a list of all the secrets. However, only those who are part of the access control can access the information.

## Related pages

- [Creating and editing secrets](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726008)
- [Managing access to secrets](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477725978)