Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This macro will hide its contents from the viewer if the context matches the parameters specified.

On Cloud, if If you have large significant content on Cloud, consider breaking it into smaller chunks over multiple Hide If macros to avoid performance issues.

Note

Notes about migration

Some legacy Macro parameters from the Confluence Server are not supported yet. More details at are on our FAQ page. 

In Confluence Cloud, the legacy Macro parameters will be shown in a section that is accessible by showing and hiding the legacy field parameters dropdown.

If the migrated macro has no legacy parameters, the "Show legacy field parameters" dropdown will not be visible in the macro editor.

⚠️  Be aware that content is only hidden in the Confluence page view , and that the content is still available when editing a page, viewing page history, email notifications, etc. To truly secure sensitive information, consider using use the Security & Encryption app instead.

Parameters

Name

Required

Migratable to Cloud?

Default Value

Description

Start Date

  • Status
    title(X)

  • Status
    titleNO

The date and time from when the content should start being hidden, with respect to the

server’s

End Date

  • Status
    title(X)

  • Status
    titleNO

The date and time from when the content should stop being hidden, with respect to the server’s timezone.

Match Using

  • Status
    title(X)

  • Status
    titleYES

any

 

If set to "all",

server's timezone.

If no value is set, the system will not enforce any date and time restrictions.

 

The system will” then all items listed must match.

Users

  • Status
    title(X)

  • Status
    titleYES

 

The list of user(s) to match. Type the username and select from the dropdown option.

Special Usernames

  • Status
    title(X)

  • Status
    titleNO

 

The user to match, using

special

unique usernames:

  • @anonymous - No user is currently logged in

  • @authenticated - Any authenticated user is logged in.

  • @self - The current user.

 

User Groups

  • Status
    title(X)

  • Status
    titleYES

 

The list of user group(s) to match. Type the group name and select from the dropdown option. (Cloud only)

The group(s) to match

,

are separated by a comma or semicolon (Server and Data Center only).

e.g.

:

, 'confluence-users' will match all logged-in users.

Space Permissions

  • Status
    title(X)

  • Status
    titleNO

 

This property allows you to define whether the

content inside this macro is hidden to a certain user based on his space permissions. This can be done by either of the following:Using @self to specify current space, followed by ":",

content” then followed by permission type e.g., @self:view

Using
  • Use the Space Key

then
  • , followed by ":" and permission type. e.g., PROJ:admin

These are the permission types:

  • view - (default) The user can view the space.

  • edit - The user can edit pages.

  • admin - The user can administer the space.

  • news - The user can post a blog entry.

 

Content Types

  • Status
    title(X)

  • Status
    titleNO

 

The (list of) page types. May be:

  • page

  • blogpost

  • comment

  • spacedesc

 

Display Types

  • Status
    title(X)

  • Status
    titleNO

 

This property allows the user to hide content only in a document

that has been

exported to PDF or Word and not on the Confluence page. 

The (list of) display modes:

  • default - content is hidden only in the Confluence default view.

  • printable - content is hidden only in the exported PDF or Word document.

For more detailed information on Display Types usage and behaviors, check the Display Types parameter matrix page.

Current Space

  • Status
    title(X)

  • Status
    titleNO

 

The

(

list of

)

space keys for the spaces

this

will be displayed in

.

Action Types

  • Status
    title(X)

  • Status
    titleNO

 

The action is taking place.

  • view - The content is editable and is currently being viewed.

  • edit - The content is editable and is currently being edited.

  • template - The content is a template being previewed.

  • dashboard - The content is the dashboard.

 

Labels

  • Status
    title(X)

  • Status
    titleNO

 

The list of labels to test

are

is present or absent.

For more detailed information on Label usage and behaviors, check the Label parameter matrix page.

HTTP Headers

  • Status
    title(X)

  • Status
    titleNO

 

The list of header "name:value" pairs to check for. This can either be of the form "name*:exact value" or "name::*regular expression".

For example, to check if the current browser is

FireFox

Firefox, set it to 'header=User-Agent::.*Firefox.*'

This will confirm that the 'User-Agent' header contains 'Firefox'.

What headers are available will depend on the browser being used.

Scope

  • Status
    title(X)

  • Status
    titleNO

 

(Since 1.6.0) Tests if the current location is in the specified scope.

You can specify a particular page

,

or set the scope to the children, descendants, or ancestors of another page:

  • > children - The direct children of the specified page. e.g.: 'scope=My Page > children'

  • > descendants - All descendants of the specified page. e.g.: 'scope="My Page" > descendants'

  • > ancestors - All ancestors of the specified page. E.g. 'scope=My Page > ancestors'

 

Trim

  • Status
    title(X)

  • Status
    titleNO

true

If set to false, the content will not be trimmed before being output (if appropriate).

Editor View

  • Not applicable.

...