"use strict";
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
const {useMDXComponents: _provideComponents} = arguments[0];
function _createMdxContent(props) {
  const _components = {
    h2: "h2",
    p: "p",
    ..._provideComponents(),
    ...props.components
  }, {InfoBox, Link, List, ListItem} = _components;
  if (!InfoBox) _missingMdxReference("InfoBox", true);
  if (!Link) _missingMdxReference("Link", true);
  if (!List) _missingMdxReference("List", true);
  if (!ListItem) _missingMdxReference("ListItem", true);
  return _jsxs(_Fragment, {
    children: [_jsxs(_components.p, {
      children: ["Atlassian has introduced ", _jsx(Link, {
        href: "https://developer.atlassian.com/platform/marketplace/runs-on-atlassian/",
        children: "Runs on Atlassian"
      }), ", a Marketplace program that helps customers identify apps that run on Atlassian infrastructure and meet additional privacy and data residency requirements."]
    }), "\n", _jsx(_components.p, {
      children: "Eligible Atly Apps now display the Runs on Atlassian badge on their Atlassian Marketplace listings."
    }), "\n", _jsx(_components.h2, {
      id: "what-the-badge-means",
      children: "What the badge means"
    }), "\n", _jsx(_components.p, {
      children: "Runs on Atlassian is available for eligible Forge apps. Atlassian applies the badge automatically when an app meets the program requirements, including:"
    }), "\n", _jsxs(List, {
      title: "Program requirements",
      children: [_jsx(ListItem, {
        children: "Using Atlassian-hosted compute and storage"
      }), _jsx(ListItem, {
        children: "Supporting data residency aligned with the host Atlassian product"
      }), _jsx(ListItem, {
        children: "Allowing customers to control external data egress through admin controls"
      })]
    }), "\n", _jsx(_components.p, {
      children: "This makes the badge a useful shortcut for teams reviewing Marketplace apps, especially when data privacy, residency and vendor approval requirements are part of the buying process."
    }), "\n", _jsx(_components.h2, {
      id: "why-this-matters",
      children: "Why this matters"
    }), "\n", _jsx(_components.p, {
      children: "Atly Apps has always aimed to keep our apps simple to install, easy to approve and careful with customer data. For apps built on Forge, that means leaning on Atlassian's platform for hosting, authentication, storage and permissions instead of introducing extra infrastructure wherever it is not needed."
    }), "\n", _jsx(_components.p, {
      children: "Runs on Atlassian gives customers a visible Marketplace signal for that architecture. When an Atly app is eligible, customers can see that the app is designed to operate within Atlassian's cloud environment and under the controls provided by the Atlassian platform."
    }), "\n", _jsx(InfoBox, {
      children: _jsx(_components.p, {
        children: "Runs on Atlassian is not a replacement for your own security review, but it\ndoes provide a clear starting point for understanding how an app handles\nhosting, storage, data residency and data egress."
      })
    }), "\n", _jsx(_components.h2, {
      id: "finding-eligible-apps",
      children: "Finding eligible apps"
    }), "\n", _jsxs(_components.p, {
      children: ["You can find the Runs on Atlassian badge directly on supported app listings in the ", _jsx(Link, {
        href: "https://marketplace.atlassian.com/vendors/1220916/atly-apps",
        children: "Atlassian Marketplace"
      }), "."]
    }), "\n", _jsxs(_components.p, {
      children: ["If you are reviewing an Atly app and need more information, our ", _jsx(Link, {
        href: "/app-privacy-policy",
        children: "Privacy Policy"
      }), ", ", _jsx(Link, {
        href: "/app-security-policy",
        children: "Security Policy"
      }), " and ", _jsx(Link, {
        href: "/vulnerability-disclosure",
        children: "Vulnerability Disclosure"
      }), " pages describe how we approach customer data and security across our Marketplace apps."]
    }), "\n", _jsxs(_components.p, {
      children: ["For questions about a specific app or procurement review, contact us ", _jsx(Link, {
        href: "https://atly.atlassian.net/servicedesk/",
        children: "here"
      }), "."]
    })]
  });
}
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = {
    ..._provideComponents(),
    ...props.components
  };
  return MDXLayout ? _jsx(MDXLayout, {
    ...props,
    children: _jsx(_createMdxContent, {
      ...props
    })
  }) : _createMdxContent(props);
}
return {
  default: MDXContent
};
function _missingMdxReference(id, component) {
  throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it.");
}


Atly Apps now Runs on Atlassian

"use strict";
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
const {useMDXComponents: _provideComponents} = arguments[0];
function _createMdxContent(props) {
  const _components = {
    h2: "h2",
    p: "p",
    strong: "strong",
    ..._provideComponents(),
    ...props.components
  }, {AppBanner, BlogScreenshot, Link, List, ListItem, MarketplaceLink} = _components;
  if (!AppBanner) _missingMdxReference("AppBanner", true);
  if (!BlogScreenshot) _missingMdxReference("BlogScreenshot", true);
  if (!Link) _missingMdxReference("Link", true);
  if (!List) _missingMdxReference("List", true);
  if (!ListItem) _missingMdxReference("ListItem", true);
  if (!MarketplaceLink) _missingMdxReference("MarketplaceLink", true);
  return _jsxs(_Fragment, {
    children: [_jsxs(_components.p, {
      children: [_jsx(Link, {
        href: "/apps/markdown-plus-bitbucket",
        children: "Markdown Plus for Bitbucket Cloud"
      }), " is now available on the ", _jsx(MarketplaceLink, {
        appId: "markdown-plus-bitbucket",
        children: "Atlassian Marketplace"
      }), "."]
    }), "\n", _jsx(_components.p, {
      children: "Markdown Plus adds a richer editing and viewing experience for Markdown files directly inside Bitbucket Cloud, without needing to leave your repository."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/markdown-plus-bitbucket/editor.png",
      title: "Split-screen Markdown editor in Bitbucket Cloud"
    }), "\n", _jsx(_components.h2, {
      id: "whats-included",
      children: "What's included"
    }), "\n", _jsxs(List, {
      children: [_jsxs(ListItem, {
        children: [_jsx(_components.strong, {
          children: "Split-screen editing"
        }), " — view the raw Markdown source and the rendered output side by side as you type, so you can always see exactly how your content will look."]
      }), _jsxs(ListItem, {
        children: [_jsx(_components.strong, {
          children: "Extended Markdown features"
        }), " — Markdown Plus renders ", _jsx(Link, {
          href: "https://mermaid.js.org",
          children: "Mermaid"
        }), " diagrams and mathematical notation written in LaTeX, MathML, and AsciiMath directly in the preview pane."]
      }), _jsxs(ListItem, {
        children: [_jsx(_components.strong, {
          children: "Dark mode support"
        }), " — the editor and preview adapt to both light and dark themes in Bitbucket Cloud."]
      })]
    }), "\n", _jsx(AppBanner, {
      id: "markdown-plus-bitbucket"
    })]
  });
}
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = {
    ..._provideComponents(),
    ...props.components
  };
  return MDXLayout ? _jsx(MDXLayout, {
    ...props,
    children: _jsx(_createMdxContent, {
      ...props
    })
  }) : _createMdxContent(props);
}
return {
  default: MDXContent
};
function _missingMdxReference(id, component) {
  throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it.");
}


Introducing Markdown Plus for Bitbucket Cloud

"use strict";
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
const {useMDXComponents: _provideComponents} = arguments[0];
function _createMdxContent(props) {
  const _components = {
    code: "code",
    h2: "h2",
    h3: "h3",
    h4: "h4",
    li: "li",
    p: "p",
    ul: "ul",
    ..._provideComponents(),
    ...props.components
  }, {AppBanner, BlogScreenshot, CheckCircleOutlineIcon, EditIcon, EditorCloseIcon, Gallery, Link, MarketplaceLink, Screenshot, WatchIcon} = _components;
  if (!AppBanner) _missingMdxReference("AppBanner", true);
  if (!BlogScreenshot) _missingMdxReference("BlogScreenshot", true);
  if (!CheckCircleOutlineIcon) _missingMdxReference("CheckCircleOutlineIcon", true);
  if (!EditIcon) _missingMdxReference("EditIcon", true);
  if (!EditorCloseIcon) _missingMdxReference("EditorCloseIcon", true);
  if (!Gallery) _missingMdxReference("Gallery", true);
  if (!Link) _missingMdxReference("Link", true);
  if (!MarketplaceLink) _missingMdxReference("MarketplaceLink", true);
  if (!Screenshot) _missingMdxReference("Screenshot", true);
  if (!WatchIcon) _missingMdxReference("WatchIcon", true);
  return _jsxs(_Fragment, {
    children: [_jsx(_components.p, {
      children: "Labels are a powerful tool to organize issues in Jira Cloud. They are tags that help to group issues which can exist in one or more Jira spaces. For example, labels can be used to categorize issues by topic, space, or priority. This makes it easy for your team find relevant content and see how different of content relates to each other."
    }), "\n", _jsx(_components.h2, {
      id: "adding-labels-to-an-issue",
      children: "Adding labels to an issue"
    }), "\n", _jsxs(_components.h3, {
      id: "-when-viewing-an-existing-issue",
      children: [_jsx(WatchIcon, {
        size: "small"
      }), " When viewing an existing issue"]
    }), "\n", _jsx(_components.p, {
      children: "To add a label when viewing a issue, click on the area to the right of the \"Labels\" section of the issue sidebar."
    }), "\n", _jsx(_components.p, {
      children: "Then, start typing the name of an existing or new label. You can either choose an existing label, or click the dropdown item with \"(New label)\" to create a new label with the text that you've entered."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-jira/add-label-existing-issue.png",
      title: "Adding a new label called project-rocket to an existing issue"
    }), "\n", _jsxs(_components.p, {
      children: ["Keep in mind that label names must be less than 255 characters in length and cannot contain spaces or special characters (such as ", _jsx(_components.code, {
        children: ":"
      }), ", ", _jsx(_components.code, {
        children: "?"
      }), " and ", _jsx(_components.code, {
        children: "@"
      }), ")."]
    }), "\n", _jsxs(_components.h3, {
      id: "-when-creating-a-new-issue",
      children: [_jsx(EditIcon, {
        size: "small"
      }), " When creating a new issue"]
    }), "\n", _jsx(_components.p, {
      children: "To add a label when creating a new issue, click on the area to the right of the \"Labels\" section of the issue create modal."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-jira/add-label-new-issue.png",
      title: "Adding a new label called project-rocket to a new issue"
    }), "\n", _jsx(_components.h2, {
      id: "label-naming-tips",
      children: "Label naming tips"
    }), "\n", _jsx(_components.p, {
      children: "When using labels to organize issues, here are some tips to keep in mind to ensure that your organization has the best experience:"
    }), "\n", _jsxs(_components.h4, {
      id: "-keep-them-consistent",
      children: [_jsx(CheckCircleOutlineIcon, {
        size: "small"
      }), " Keep them consistent"]
    }), "\n", _jsx(_components.p, {
      children: "Ensure that users in your organization use a consistent naming scheme, which will prevent duplicate labels from being added and ensure that content is easy find."
    }), "\n", _jsxs(_components.p, {
      children: ["For example, a user might add a new ", _jsx(_components.code, {
        children: "dev"
      }), " label when a ", _jsx(_components.code, {
        children: "development"
      }), " label already exists, which results in unnecessary duplication of the label. Since labels cannot be constrained to a list of allowed labels, a tool like ", _jsx(Link, {
        href: "/apps/label-organizer-jira",
        children: "Label Organizer for Jira Cloud"
      }), " can help you merge multiple labels into a single label."]
    }), "\n", _jsx(_components.p, {
      children: "Your organization could agree on a naming scheme that governs how labels will be named. An example of conventions that might appear in the naming scheme could be:"
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsx(_components.li, {
        children: "Use full words instead of abbreviations"
      }), "\n", _jsx(_components.li, {
        children: "Use dashes instead of underscores when multiple words appear in the label"
      }), "\n"]
    }), "\n", _jsxs(_components.p, {
      children: ["Regular auditing of labels to ensure they follow the naming scheme can help to ensure they are always up to date. A tool like ", _jsx(Link, {
        href: "/apps/label-organizer-jira",
        children: "Label Organizer for Jira Cloud"
      }), " can help with this."]
    }), "\n", _jsxs(_components.h3, {
      id: "-use-labels-only-when-needed",
      children: [_jsx(CheckCircleOutlineIcon, {
        size: "small"
      }), " Use labels only when needed"]
    }), "\n", _jsx(_components.p, {
      children: "It's easy to add many different labels to issues, but we recommend limiting the labels added to a concise list of labels that are directly associated with the content."
    }), "\n", _jsxs(_components.h3, {
      id: "-ensure-labels-are-removed-when-no-longer-needed",
      children: [_jsx(CheckCircleOutlineIcon, {
        size: "small"
      }), " Ensure labels are removed when no longer needed"]
    }), "\n", _jsx(_components.p, {
      children: "To ensure that labels remain relevant to their content, ensure that they are removed if they aren't relevant. For example, if your organization has an \"ready-for-testing\" label for issues that are ready to be tested, label ensure that it's then removed from that issue once the test has been completed."
    }), "\n", _jsx(_components.h2, {
      id: "browsing-issues-with-a-given-label",
      children: "Browsing issues with a given label"
    }), "\n", _jsx(_components.p, {
      children: "To view all other content with a label, simply open an issue with that label and then click on the label. This will take you to a search query that lists other issues what that label."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-jira/search.png",
      title: "Search results page for 'status-update' label"
    }), "\n", _jsxs(_components.p, {
      children: ["The page will use either ", _jsx(Link, {
        href: "https://support.atlassian.com/jira-work-management/docs/perform-a-basic-search/",
        children: "basic search"
      }), " or ", _jsx(Link, {
        href: "https://support.atlassian.com/jira-work-management/docs/use-advanced-search-with-jira-query-language-jql/",
        children: "advanced search"
      }), ", depending on the view that you used last."]
    }), "\n", _jsx(_components.p, {
      children: "Alternatively, you can also search for issues that have a specific label by going directly to search and searching for the label there."
    }), "\n", _jsx(_components.h2, {
      id: "viewing-all-labels",
      children: "Viewing all labels"
    }), "\n", _jsxs(_components.p, {
      children: ["To view all labels in a space, you can use the ", _jsx(Link, {
        href: "https://support.atlassian.com/jira-cloud-administration/docs/use-dashboard-gadgets/",
        children: "Labels Gadget"
      }), " in a dashboard."]
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-jira/gadget.png",
      title: "Viewing all labels in a space with the gadget"
    }), "\n", _jsxs(_components.p, {
      children: ["Viewing all labels in all spaces is not currently supported by default in Jira. However, an app like ", _jsx(Link, {
        href: "/apps/label-organizer-jira",
        children: "Label Organizer for Jira Cloud"
      }), " supports this functionality."]
    }), "\n", _jsx(_components.h2, {
      id: "removing-labels",
      children: "Removing Labels"
    }), "\n", _jsxs(_components.p, {
      children: ["To remove a label from an issue, click on the area to the right of the \"Labels\" section of the issue sidebar and then click the ", _jsx(EditorCloseIcon, {
        size: "small"
      }), " button next to the label to be removed."]
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-jira/delete-label.png",
      title: "Deleting a label called project-rocketship"
    }), "\n", _jsx(_components.h2, {
      id: "deleting-a-label",
      children: "Deleting a label"
    }), "\n", _jsx(_components.p, {
      children: "Labels can be deleted by removing the label from all issues that the label appears on."
    }), "\n", _jsxs(_components.p, {
      children: ["This can be done manually in the user interface, or can be done in bulk by using the ", _jsx(Link, {
        href: "https://developer.atlassian.com/cloud/jira/platform/rest",
        children: "Jira API"
      }), " or a third-party app like ", _jsx(Link, {
        href: "/apps/label-organizer-jira",
        children: "Label Organizer for Jira Cloud"
      }), "."]
    }), "\n", _jsx(_components.h2, {
      id: "bulk-adding-removing-and-merging-labels",
      children: "Bulk adding, removing and merging labels"
    }), "\n", _jsxs(_components.p, {
      children: ["Performing bulk changes to labels isn't supported natively in the Jira Cloud user interface, but ", _jsx(Link, {
        href: "/apps/label-organizer-jira",
        children: "Label Organizer for Jira Cloud"
      }), " supports organizing labels directly inside Jira."]
    }), "\n", _jsxs(Gallery, {
      children: [_jsx(Screenshot, {
        imageSource: "/label-organizer-jira/organizer.png",
        title: "Displaying Jira labels in a space"
      }), _jsx(Screenshot, {
        imageSource: "/label-organizer-jira/filtering.png",
        title: "Filtering from a list of labels"
      })]
    }), "\n", _jsx(_components.p, {
      children: "It includes the ability to list all labels in a given Jira space, or entire Jira instance, where labels can then be renamed, merged or deleted:"
    }), "\n", _jsxs(Gallery, {
      children: [_jsx(Screenshot, {
        imageSource: "/label-organizer-jira/bulk-delete.png",
        title: "Delete modal visible"
      }), _jsx(Screenshot, {
        imageSource: "/label-organizer-jira/merge.png",
        title: "Merge modal visible"
      })]
    }), "\n", _jsx(_components.p, {
      children: "Furthermore, labels can be added in bulk to pages and blog posts that match a JQL query:"
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/label-organizer-jira/bulk-add.png",
      imageAlt: "Bulk-add labels to issues"
    }), "\n", _jsxs(_components.p, {
      children: ["More information and pricing details can be found in the ", _jsx(MarketplaceLink, {
        appId: "label-organizer-jira",
        children: "Atlassian Marketplace"
      }), " (free for Jira instances with 10 users or less!)."]
    }), "\n", _jsx(_components.h2, {
      id: "conclusion",
      children: "Conclusion"
    }), "\n", _jsxs(_components.p, {
      children: ["Creating and editing labels in Jira is a simple and straightforward process that can help you organize and categorize your issues. By keeping in mind the best practices mentioned above, you can ensure that your labels are being used effectively, making it easier to find and access the issues you need. Whilst the features included in Jira allow you to create and edit labels, apps such as ", _jsx(Link, {
        href: "/apps/label-organizer-jira",
        children: "Label Organizer for Jira Cloud"
      }), " can help to improve the management of a large number of labels and help your organization have a better experience."]
    }), "\n", _jsx(AppBanner, {
      id: "label-organizer-jira"
    })]
  });
}
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = {
    ..._provideComponents(),
    ...props.components
  };
  return MDXLayout ? _jsx(MDXLayout, {
    ...props,
    children: _jsx(_createMdxContent, {
      ...props
    })
  }) : _createMdxContent(props);
}
return {
  default: MDXContent
};
function _missingMdxReference(id, component) {
  throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it.");
}


Using labels in Jira Cloud

"use strict";
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
const {useMDXComponents: _provideComponents} = arguments[0];
function _createMdxContent(props) {
  const _components = {
    h2: "h2",
    p: "p",
    ..._provideComponents(),
    ...props.components
  }, {BlogScreenshot, Gallery, Link, List, ListItem, Screenshot} = _components;
  if (!BlogScreenshot) _missingMdxReference("BlogScreenshot", true);
  if (!Gallery) _missingMdxReference("Gallery", true);
  if (!Link) _missingMdxReference("Link", true);
  if (!List) _missingMdxReference("List", true);
  if (!ListItem) _missingMdxReference("ListItem", true);
  if (!Screenshot) _missingMdxReference("Screenshot", true);
  return _jsxs(_Fragment, {
    children: [_jsxs(_components.p, {
      children: ["Atlassian has recently made ", _jsx(Link, {
        href: "https://www.atlassian.com/wac/roadmap/cloud/dark-mode-in-jira",
        children: "Dark Mode in Jira Cloud"
      }), " available as a public beta. This update brings a long-awaited feature to Jira, and our apps have been updated to also support this new theme."]
    }), "\n", _jsx(_components.p, {
      children: "In this blog post we'll walk through how to enable Dark Mode in Jira Cloud and walk through some improvements made to our apps to support Dark Mode."
    }), "\n", _jsx(_components.h2, {
      id: "enabling-dark-mode",
      children: "Enabling Dark Mode"
    }), "\n", _jsx(_components.p, {
      children: "To enable dark mode in Jira cloud, follow these steps once you've signed into Jira:"
    }), "\n", _jsxs(List, {
      children: [_jsx(ListItem, {
        children: "Click on your profile in the top-right of the screen"
      }), _jsx(ListItem, {
        children: "Click \"Theme\" in the dropdown"
      }), _jsx(ListItem, {
        children: "Choose \"Dark\" (or \"Match System\" if you prefer Jira to match your system theme)"
      })]
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/dark-mode-jira/theme-dropdown.jpg",
      title: "Setting Jira Cloud theme to Dark from the dropdown"
    }), "\n", _jsx(_components.p, {
      children: "You can also change your theme from Personal Settings in Jira, which can also be accessed from the dropdown in the top-right of the screen."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/dark-mode-jira/theme-personal-settings.jpg",
      title: "Setting Jira Cloud theme to Dark from Jira Personal Settings"
    }), "\n", _jsx(_components.h2, {
      id: "atly-apps",
      children: "Atly Apps"
    }), "\n", _jsx(_components.p, {
      children: "Atly Apps have also recently updated our suite of apps for Jira Cloud to support dark mode."
    }), "\n", _jsxs(_components.p, {
      children: ["For example, here's ", _jsx(Link, {
        href: "/apps/label-organizer-jira",
        children: "Label Organizer"
      }), " and ", _jsx(Link, {
        href: "/apps/export-markdown-jira",
        children: "Export to Markdown for Jira Cloud"
      }), " using Dark Mode:"]
    }), "\n", _jsxs(Gallery, {
      children: [_jsx(Screenshot, {
        imageSource: "/blog/dark-mode-jira/label-organizer.jpg",
        title: "Label Organizer for Jira Cloud in Dark Mode"
      }), _jsx(Screenshot, {
        imageSource: "/blog/dark-mode-jira/export-markdown.jpg",
        title: "Export to Markdown for Jira Cloud in Dark Mode"
      })]
    }), "\n", _jsxs(_components.p, {
      children: ["Atlassian has also announced that Dark Mode will be coming to ", _jsx(Link, {
        href: "https://www.atlassian.com/wac/roadmap/cloud/confluence-dark-mode",
        children: "Confluence Cloud too"
      }), ", and Atly Apps will ensure that our apps are supported there as well."]
    })]
  });
}
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = {
    ..._provideComponents(),
    ...props.components
  };
  return MDXLayout ? _jsx(MDXLayout, {
    ...props,
    children: _jsx(_createMdxContent, {
      ...props
    })
  }) : _createMdxContent(props);
}
return {
  default: MDXContent
};
function _missingMdxReference(id, component) {
  throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it.");
}


Dark mode in Jira Cloud

"use strict";
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
const {useMDXComponents: _provideComponents} = arguments[0];
function _createMdxContent(props) {
  const _components = {
    code: "code",
    h2: "h2",
    h3: "h3",
    h4: "h4",
    li: "li",
    p: "p",
    ul: "ul",
    ..._provideComponents(),
    ...props.components
  }, {AddIcon, AppBanner, BlogScreenshot, CheckCircleOutlineIcon, EditIcon, EditorCloseIcon, Gallery, InfoBox, Link, MarketplaceLink, MoreIcon, Screenshot, SearchIcon, SettingsIcon, WatchIcon} = _components;
  if (!AddIcon) _missingMdxReference("AddIcon", true);
  if (!AppBanner) _missingMdxReference("AppBanner", true);
  if (!BlogScreenshot) _missingMdxReference("BlogScreenshot", true);
  if (!CheckCircleOutlineIcon) _missingMdxReference("CheckCircleOutlineIcon", true);
  if (!EditIcon) _missingMdxReference("EditIcon", true);
  if (!EditorCloseIcon) _missingMdxReference("EditorCloseIcon", true);
  if (!Gallery) _missingMdxReference("Gallery", true);
  if (!InfoBox) _missingMdxReference("InfoBox", true);
  if (!Link) _missingMdxReference("Link", true);
  if (!MarketplaceLink) _missingMdxReference("MarketplaceLink", true);
  if (!MoreIcon) _missingMdxReference("MoreIcon", true);
  if (!Screenshot) _missingMdxReference("Screenshot", true);
  if (!SearchIcon) _missingMdxReference("SearchIcon", true);
  if (!SettingsIcon) _missingMdxReference("SettingsIcon", true);
  if (!WatchIcon) _missingMdxReference("WatchIcon", true);
  return _jsxs(_Fragment, {
    children: [_jsx(_components.p, {
      children: "Labels are a powerful tool to organize pages, blog posts and attachments in Confluence Cloud. They are tags that help to group content which can exist in one or more Confluence spaces. For example, labels can be used to categorize content by topic, project, or priority. This makes it easy for your team find relevant content and see how different of content relates to each other."
    }), "\n", _jsx(_components.h2, {
      id: "adding-labels-to-a-page-or-blog-post",
      children: "Adding labels to a page or blog post"
    }), "\n", _jsxs(_components.p, {
      children: ["Labels can be added to pages or blog posts either when editing the page, or when viewing it. Keep in mind that label names must be less than 255 characters in length and cannot contain spaces or special characters (such as ", _jsx(_components.code, {
        children: ":"
      }), ", ", _jsx(_components.code, {
        children: "?"
      }), " and ", _jsx(_components.code, {
        children: "@"
      }), ")."]
    }), "\n", _jsxs(_components.h4, {
      id: "-when-viewing-a-page",
      children: [_jsx(WatchIcon, {
        size: "small"
      }), " When viewing a page"]
    }), "\n", _jsxs(_components.p, {
      children: ["To add a label when viewing a page, scroll down to the bottom of the page content and click the \"", _jsx(AddIcon, {
        size: "small"
      }), " Add label\" button."]
    }), "\n", _jsx(_components.p, {
      children: "Then, start typing the name of an existing or new label. You can either choose an existing label, or click \"Create new label\" to create a new label with the text that you've entered."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-confluence/add-label-while-viewing.png",
      title: "Adding an existing label called development to a page that's being viewed"
    }), "\n", _jsx(InfoBox, {
      children: _jsxs(_components.p, {
        children: ["You can also add labels to attachments by click the three dots", " ", "\n", _jsx(MoreIcon, {
          size: "small"
        }), " icon in the top-right of the page, then going to\n\"Attachments\" > \"Files\" and adding a label to the \"Labels\" column of the\ntable."]
      })
    }), "\n", _jsxs(_components.h4, {
      id: "-when-editing-a-page",
      children: [_jsx(EditIcon, {
        size: "small"
      }), " When editing a page"]
    }), "\n", _jsxs(_components.p, {
      children: ["To add a label when editing a page, click the three dots ", _jsx(MoreIcon, {
        size: "small"
      }), " icon in the top-right of the editor. Then select either \"Add labels\" or \"Edit labels\" (depending on whether the page already has labels)."]
    }), "\n", _jsx(_components.p, {
      children: "Then, in the popup window start tying the name of a new or existing label. You can either choose an existing label, or click \"Create new label\" to create a new label with the text that you've entered."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-confluence/add-label-while-editing.png",
      title: "Adding an existing label called development to a page that's being edited"
    }), "\n", _jsx(_components.h2, {
      id: "label-naming-tips",
      children: "Label naming tips"
    }), "\n", _jsx(_components.p, {
      children: "When using labels to organize content, here are some tips to keep in mind to ensure that your organization has the best experience:"
    }), "\n", _jsxs(_components.h4, {
      id: "-keep-them-consistent",
      children: [_jsx(CheckCircleOutlineIcon, {
        size: "small"
      }), " Keep them consistent"]
    }), "\n", _jsx(_components.p, {
      children: "Ensure that users in your organization use a consistent naming scheme, which will prevent duplicate labels from being added and ensure that content is easy find."
    }), "\n", _jsxs(_components.p, {
      children: ["For example, a user might add a new ", _jsx(_components.code, {
        children: "dev"
      }), " label when a ", _jsx(_components.code, {
        children: "development"
      }), " label already exists, which results in unnecessary duplication of the label. Since labels cannot be constrained to a list of allowed labels, a tool like ", _jsx(Link, {
        href: "/apps/label-organizer-confluence",
        children: "Label Organizer for Confluence Cloud"
      }), " can help you merge multiple labels into a single label."]
    }), "\n", _jsx(_components.p, {
      children: "Your organization could agree on a naming scheme that governs how labels will be named. An example of conventions that might appear in the naming scheme could be:"
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsx(_components.li, {
        children: "Use full words instead of abbreviations"
      }), "\n", _jsx(_components.li, {
        children: "Use dashes instead of underscores when multiple words appear in the label"
      }), "\n"]
    }), "\n", _jsxs(_components.p, {
      children: ["Regular auditing of labels to ensure they follow the naming scheme can help to ensure they are always up to date. A tool like ", _jsx(Link, {
        href: "/apps/label-organizer-confluence",
        children: "Label Organizer for Confluence Cloud"
      }), " can help with this."]
    }), "\n", _jsxs(_components.h3, {
      id: "-use-labels-only-when-needed",
      children: [_jsx(CheckCircleOutlineIcon, {
        size: "small"
      }), " Use labels only when needed"]
    }), "\n", _jsx(_components.p, {
      children: "It's easy to add many different labels to content, but we recommend limiting the labels added to a concise list of labels that are directly associated with the content."
    }), "\n", _jsxs(_components.h3, {
      id: "-ensure-labels-are-removed-when-no-longer-needed",
      children: [_jsx(CheckCircleOutlineIcon, {
        size: "small"
      }), " Ensure labels are removed when no longer needed"]
    }), "\n", _jsx(_components.p, {
      children: "To ensure that labels remain relevant to their content, ensure that they are removed if they aren't relevant. For example, if your organization has an \"unpaid\" label for unpaid invoices, ensure that it's then removed from that content once the invoice has been paid."
    }), "\n", _jsx(_components.h2, {
      id: "browsing-content-with-a-given-label",
      children: "Browsing content with a given label"
    }), "\n", _jsx(_components.p, {
      children: "To view all other content with a label, simply browse to some content with that label and then click on the label. This will take you to the \"Labelled content\" page which lists all content that has that label."
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-confluence/labelled-content.png",
      title: "Displaying 'Labelled content' page"
    }), "\n", _jsxs(_components.p, {
      children: ["You can also view content in other spaces with the given label by clicking on the ", _jsx(SettingsIcon, {
        size: "small"
      }), " icon then selecting \"See content from all spaces\"."]
    }), "\n", _jsxs(_components.p, {
      children: ["Alternatively, you can also search for content that has a specific label with \"Advanced search\", by clicking ", _jsx(SearchIcon, {
        size: "small"
      }), " Search in the header and then choosing a label in the \"Filter by label\" dropdown on the right-hand side of the page."]
    }), "\n", _jsx(InfoBox, {
      children: _jsxs(_components.p, {
        children: ["Confluence Server supports searching ", _jsxs(Link, {
          href: "https://confluence.atlassian.com/doc/add-remove-and-search-for-labels-136419.html",
          children: ["\nwith the ", _jsx(_components.code, {
            children: "labelText:"
          }), " prefix"]
        }), " in the search box, however that is ", _jsx(Link, {
          href: "https://jira.atlassian.com/browse/CONFCLOUD-70644?focusedCommentId=2503348&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-2503348",
          children: "\nnot supported on Confluence Cloud"
        }), "."]
      })
    }), "\n", _jsxs(_components.p, {
      children: ["There are also ", _jsx(Link, {
        href: "https://support.atlassian.com/confluence-cloud/docs/use-labels-to-organize-your-content/#Use-macros-to-categorize-or-display-labels",
        children: "several macros available"
      }), " which allow labels and labelled content to be shown."]
    }), "\n", _jsx(_components.h2, {
      id: "viewing-all-labels",
      children: "Viewing all labels"
    }), "\n", _jsxs(_components.p, {
      children: ["To view all labels in a space, click on a label and then press the ", _jsx(SettingsIcon, {
        size: "small"
      }), ", then select \"All Labels\""]
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-confluence/all-labels.png",
      title: "Displaying 'All labels' page"
    }), "\n", _jsx(_components.p, {
      children: "To view all labels in all spaces, you can follow the \"labels from all spaces\" link."
    }), "\n", _jsx(_components.h2, {
      id: "removing-labels",
      children: "Removing Labels"
    }), "\n", _jsx(_components.p, {
      children: "After adding labels to content, they can also be removed:"
    }), "\n", _jsxs(_components.h4, {
      id: "-when-viewing-a-page-1",
      children: [_jsx(WatchIcon, {
        size: "small"
      }), " When viewing a page"]
    }), "\n", _jsxs(_components.p, {
      children: ["To remove a label when viewing a page, scroll down to the bottom of the page content and click the ", _jsx(EditorCloseIcon, {
        size: "small"
      }), " button next to the label to be removed."]
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/blog/labels-confluence/delete-label.png",
      title: "Deleting a label called development"
    }), "\n", _jsxs(_components.h4, {
      id: "-when-editing-a-page-1",
      children: [_jsx(EditIcon, {
        size: "small"
      }), " When editing a page"]
    }), "\n", _jsxs(_components.p, {
      children: ["To remove a label when editing a page, click the three dots ", _jsx(MoreIcon, {
        size: "small"
      }), " icon in the top-right of the editor. Then select \"Edit labels\" and click the ", _jsx(EditorCloseIcon, {
        size: "small"
      }), " button next to a label to be removed."]
    }), "\n", _jsx(_components.h2, {
      id: "deleting-a-label",
      children: "Deleting a label"
    }), "\n", _jsx(_components.p, {
      children: "Labels can be deleted by removing the label from all content that the label appears on."
    }), "\n", _jsxs(_components.p, {
      children: ["This can be done manually in the user interface, or can be done in bulk by using the ", _jsx(Link, {
        href: "https://developer.atlassian.com/cloud/confluence/rest",
        children: "Confluence API"
      }), " or a third-party app like ", _jsx(Link, {
        href: "/apps/label-organizer-confluence",
        children: "Label Organizer for Confluence Cloud"
      }), "."]
    }), "\n", _jsx(_components.h2, {
      id: "bulk-adding-removing-and-merging-labels",
      children: "Bulk adding, removing and merging labels"
    }), "\n", _jsxs(_components.p, {
      children: ["Performing bulk changes to labels isn't supported natively in the Confluence Cloud user interface, but ", _jsx(Link, {
        href: "/apps/label-organizer-confluence",
        children: "Label Organizer for Confluence Cloud"
      }), " supports organizing labels directly inside Confluence."]
    }), "\n", _jsxs(Gallery, {
      children: [_jsx(Screenshot, {
        imageSource: "/label-organizer-confluence/organizer.png",
        title: "Displaying Confluence labels in a space"
      }), _jsx(Screenshot, {
        imageSource: "/label-organizer-confluence/filtering.png",
        title: "Filtering from a list of labels"
      })]
    }), "\n", _jsx(_components.p, {
      children: "It includes the ability to list all labels in a given Confluence space, or entire Confluence instance, where labels can then be renamed, merged or deleted:"
    }), "\n", _jsxs(Gallery, {
      children: [_jsx(Screenshot, {
        imageSource: "/label-organizer-confluence/bulk-delete.png",
        title: "Delete modal visible"
      }), _jsx(Screenshot, {
        imageSource: "/label-organizer-confluence/merge.png",
        title: "Merge modal visible"
      })]
    }), "\n", _jsx(_components.p, {
      children: "Furthermore, labels can be added in bulk to pages and blog posts that match a CQL query:"
    }), "\n", _jsx(BlogScreenshot, {
      imageSource: "/label-organizer-confluence/bulk-add.png",
      imageAlt: "Bulk-add labels to content"
    }), "\n", _jsxs(_components.p, {
      children: ["More information and pricing details can be found in the ", _jsx(MarketplaceLink, {
        appId: "label-organizer-confluence",
        children: "Atlassian Marketplace"
      }), " (free for Confluence instances with 10 users or less!)."]
    }), "\n", _jsx(_components.h2, {
      id: "conclusion",
      children: "Conclusion"
    }), "\n", _jsxs(_components.p, {
      children: ["Creating and editing labels in Confluence is a simple and straightforward process that can help you organize and categorize your content. By keeping in mind the best practices mentioned above, you can ensure that your labels are being used effectively, making it easier to find and access the information you need. Whilst the features included in Confluence allow you to create and edit labels, apps such as ", _jsx(Link, {
        href: "/apps/label-organizer-confluence",
        children: "Label Organizer for Confluence Cloud"
      }), " can help to improve the management of a large number of labels and help your organization have a better experience."]
    }), "\n", _jsx(AppBanner, {
      id: "label-organizer-confluence"
    })]
  });
}
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = {
    ..._provideComponents(),
    ...props.components
  };
  return MDXLayout ? _jsx(MDXLayout, {
    ...props,
    children: _jsx(_createMdxContent, {
      ...props
    })
  }) : _createMdxContent(props);
}
return {
  default: MDXContent
};
function _missingMdxReference(id, component) {
  throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it.");
}


The Atly Apps blog

Atly Apps now Runs on Atlassian

More posts

Introducing Markdown Plus for Bitbucket Cloud

Using labels in Jira Cloud

Dark mode in Jira Cloud

Using labels in Confluence Cloud

View our apps for Atlassian Cloud