# Table of Contents - [Huly Documentation | Huly Docs](#huly-documentation-huly-docs) - [What is Huly? | Huly Docs](#what-is-huly-huly-docs) - [What is TraceX? | Huly Docs](#what-is-tracex-huly-docs) - [Setting up your workspace | Huly Docs](#setting-up-your-workspace-huly-docs) - [Learn the basics | Huly Docs](#learn-the-basics-huly-docs) - [Huly API and other tools | Huly Docs](#huly-api-and-other-tools-huly-docs) - [Self-hosting Huly | Huly Docs](#self-hosting-huly-huly-docs) - [Mobile access | Huly Docs](#mobile-access-huly-docs) - [Support | Huly Docs](#support-huly-docs) - [Parent-child Cards | Huly Docs](#parent-child-cards-huly-docs) - [Introduction to Cards | Huly Docs](#introduction-to-cards-huly-docs) - [Creating Cards | Huly Docs](#creating-cards-huly-docs) - [Cards vs. Documents | Huly Docs](#cards-vs-documents-huly-docs) - [What are Types? | Huly Docs](#what-are-types-huly-docs) - [View, sort and filter Cards | Huly Docs](#view-sort-and-filter-cards-huly-docs) - [Use cases for Cards | Huly Docs](#use-cases-for-cards-huly-docs) - [Creating Types | Huly Docs](#creating-types-huly-docs) - [What are Tags? | Huly Docs](#what-are-tags-huly-docs) - [File Types | Huly Docs](#file-types-huly-docs) - [Creating Tags | Huly Docs](#creating-tags-huly-docs) - [What are Relations? | Huly Docs](#what-are-relations-huly-docs) - [Relations vs. References | Huly Docs](#relations-vs-references-huly-docs) - [Defining Relations | Huly Docs](#defining-relations-huly-docs) - [Creating projects | Huly Docs](#creating-projects-huly-docs) - [Relating Cards | Huly Docs](#relating-cards-huly-docs) - [Creating issues | Huly Docs](#creating-issues-huly-docs) - [Components | Huly Docs](#components-huly-docs) - [Milestones | Huly Docs](#milestones-huly-docs) - [Labels | Huly Docs](#labels-huly-docs) - [Issue collaborators | Huly Docs](#issue-collaborators-huly-docs) - [Related and blocking issues | Huly Docs](#related-and-blocking-issues-huly-docs) - [Issue templates | Huly Docs](#issue-templates-huly-docs) - [Team planner | Huly Docs](#team-planner-huly-docs) - [Scheduling action items | Huly Docs](#scheduling-action-items-huly-docs) - [Human resources | Huly Docs](#human-resources-huly-docs) - [Documents | Huly Docs](#documents-huly-docs) - [Action items in documents | Huly Docs](#action-items-in-documents-huly-docs) - [Mermaid diagrams | Huly Docs](#mermaid-diagrams-huly-docs) - [Templates | Huly Docs](#templates-huly-docs) - [Additional document settings | Huly Docs](#additional-document-settings-huly-docs) - [Ownership vs. authorship | Huly Docs](#ownership-vs-authorship-huly-docs) - [Inbox | Huly Docs](#inbox-huly-docs) - [Inline comments | Huly Docs](#inline-comments-huly-docs) - [Drawing board | Huly Docs](#drawing-board-huly-docs) - [Notifications | Huly Docs](#notifications-huly-docs) - [Live transcription | Huly Docs](#live-transcription-huly-docs) - [GitHub | Huly Docs](#github-huly-docs) - [Google Calendar | Huly Docs](#google-calendar-huly-docs) - [Technical documentation | Huly Docs](#technical-documentation-huly-docs) - [Activity tracking in chat | Huly Docs](#activity-tracking-in-chat-huly-docs) - [Employees | Huly Docs](#employees-huly-docs) - [Applying Tags to Cards | Huly Docs](#applying-tags-to-cards-huly-docs) - [Gmail | Huly Docs](#gmail-huly-docs) - [Test management | Huly Docs](#test-management-huly-docs) - [Surveys | Huly Docs](#surveys-huly-docs) - [Leads | Huly Docs](#leads-huly-docs) - [Recruiting | Huly Docs](#recruiting-huly-docs) - [Space types | Huly Docs](#space-types-huly-docs) - [Task types | Huly Docs](#task-types-huly-docs) - [Classes and enums | Huly Docs](#classes-and-enums-huly-docs) - [Text Templates | Huly Docs](#text-templates-huly-docs) - [Connecting tasks | Huly Docs](#connecting-tasks-huly-docs) - [Viewing and sorting issues | Huly Docs](#viewing-and-sorting-issues-huly-docs) - [Creating action items | Huly Docs](#creating-action-items-huly-docs) - [Collaborative editing | Huly Docs](#collaborative-editing-huly-docs) - [Drive | Huly Docs](#drive-huly-docs) - [Editing and formatting | Huly Docs](#editing-and-formatting-huly-docs) - [Quality documents | Huly Docs](#quality-documents-huly-docs) - [Filtering documents | Huly Docs](#filtering-documents-huly-docs) - [Products | Huly Docs](#products-huly-docs) - [Sending messages | Huly Docs](#sending-messages-huly-docs) - [Document versions | Huly Docs](#document-versions-huly-docs) - [Virtual office | Huly Docs](#virtual-office-huly-docs) - [Managing Contacts | Huly Docs](#managing-contacts-huly-docs) - [Review and approval | Huly Docs](#review-and-approval-huly-docs) - [Telegram | Huly Docs](#telegram-huly-docs) - [Roles and permissions | Huly Docs](#roles-and-permissions-huly-docs) - [Trainings | Huly Docs](#trainings-huly-docs) - [404 | Huly Docs](#404-huly-docs) --- # Huly Documentation | Huly Docs [Skip to content](https://docs.huly.io/#_top) ![](https://docs.huly.io/_astro/huly-logo-bw.Dw8a0Ist_ZSPpJP.svg) Huly Documentation ================== Open Source All-in-One Project Management Platform [Get Started](https://docs.huly.io/getting-started/introduction-huly/) [Back to Huly.io](https://huly.io/) Get to know Huly ---------------- Join the Community Join our community on [Slack](https://huly.link/slack) to see how others are using the platform, get support and share your own experiences. Share how your team is using Huly Join the conversation on [Twitter/X](https://twitter.com/huly_io) by sharing how your team is using Huly for better workflow management! Read the docs Learn more about Huly in the [Huly Docs](https://docs.huly.io/getting-started/introduction-huly) . Give Huly a star! Give us a star on [GitHub](https://github.com/hcengineering/platform) — our team appreciates it! --- # What is Huly? | Huly Docs [Skip to content](https://docs.huly.io/getting-started/introduction-huly/#_top) What is Huly? ============= Huly is an open source all-in-one project management platform offering an alternative to tools like Linear, Jira, Slack, Notion, and Motion. By providing a powerful suite of features including workflow management, personal scheduling, collaborative editing and video conferencing, Huly streamlines project management processes in a way that aligns seamlessly with the complexity and dynamic nature of real-world workflows. Huly Docs contains information about all of Huly’s main platform features. You can also read more about Huly on our [blog](https://huly.io/blog) . Getting started --------------- If this is your first time using the Huly Platform, get started by following our guide for setting up your workspace! Then, check out some of our most popular features, including: * [Action items](https://docs.huly.io/task-tracking/creating-action-items) * [GitHub integration](https://docs.huly.io/integrations/github) * [Virtual office](https://docs.huly.io/communication/virtual-office) Where we’re headed ------------------ As we hone in on our goals for the future of the Huly platform, we’re focusing on creating a better system for process management system that actually reflects real, dynamic workflows. We’re re-working the entire framework of the Huly platform not only to support this goal but also to lay the foundation for our vision of a global Huly that will be the only tool anyone will ever need to manage their work. To learn more about the future of Huly, read our blog post — [Beyond the Cloud: How Huly is Building the First Blockchain-Powered Global Collaboration Network](https://huly.io/blog/beyond-the-cloud) , or listen to the podcast format: Our development is largely driven by user feedback, and we’re committed to delivering an exceptional user experience while making room for fresh ideas and a different way of looking at the tools that have failed to fit the bill in the past. Welcome to Huly — We’re excited to grow with you. Feeling stuck? -------------- We’re here to help! If you need help along the way, our [Slack](https://huly.link/slack) community is a welcoming space for you to connect with our team, ask questions and meet other Huly users. We hope to see you there! --- # What is TraceX? | Huly Docs [Skip to content](https://docs.huly.io/getting-started/introduction-tracex/#_top) What is TraceX? =============== TraceX — built on top of the Huly Platform — streamlines compliance for managing your product lifecycle and launching faster. TraceX contains modules specifically designed for regulated industries such as medtech, biotech, automotive and aerospace. These modules include features for documentation management, electronic signature (21 CFR part 11, FDA), PDF export, and product management. All of the project management features available in Huly are also included in TraceX, including task tracking, virtual office, chat, wiki docs and more. Below are the special modules and features enabled by default TraceX, but these can also be enabled in any Huly workspace. If you’re a Huly user interested in using any of the modules or features listed below, see how to configure them in our [workspace setup guide](https://docs.huly.io/getting-started/workspace-setup) . For more information on TraceX, visit [TraceX.co](https://tracex.co/) . TraceX modules and features --------------------------- In addition to the project management features available in Huly, TraceX includes the following: * [Roles & permissions](https://docs.huly.io/advanced-settings/roles) * [Trainings](https://docs.huly.io/additional-modules/trainings) * Controlled Document types * [Templates](https://docs.huly.io/controlled-documents/templates) * [Quality documents](https://docs.huly.io/controlled-documents/quality-documents) * [Technical documentation](https://docs.huly.io/controlled-documents/technical-documentation) * Controlled Document authoring * [Editing & formatting](https://docs.huly.io/controlled-documents/editing-formatting) * [Additional settings](https://docs.huly.io/controlled-documents/document-settings) * [Document versions](https://docs.huly.io/controlled-documents/document-versions) * [Ownership & authorship](https://docs.huly.io/controlled-documents/ownership-authorship) * [Reviewing and approving with electronic signatures](https://docs.huly.io/controlled-documents/review-approval) * [Filtering documents](https://docs.huly.io/controlled-documents/document-filtering) * [Products](https://docs.huly.io/controlled-documents/products) TraceX also includes the following features and modules available in Huly: * [Tracker](https://docs.huly.io/task-tracking/creating-issues) - task management * [Planner](https://docs.huly.io/task-tracking/scheduling-action-items) - personal scheduling * [Chat](https://docs.huly.io/communication/sending-messages) - instant messaging * [Virtual Office](https://docs.huly.io/communication/virtual-office) - video conferencing * [Documents](https://docs.huly.io/knowledge-management/documents) - wiki docs * [File Drive](https://docs.huly.io/knowledge-management/drive) - file storage and sharing * [Cards](https://docs.huly.io/cards/cards-overview) - database-style knowledge management * [Test management (beta)](https://docs.huly.io/additional-modules/test-management) - test case management Getting started --------------- New to TraceX? Check out our [workspace setup guide](https://docs.huly.io/getting-started/workspace-setup) to get started! * * * Feeling stuck? -------------- We’re here to help! If you need help along the way, our [Slack](https://huly.link/slack) community is a welcoming space for you to connect with our team, ask questions and meet other TraceX users. After joining the community, head over to the #tracex channel. We hope to see you there! --- # Setting up your workspace | Huly Docs [Skip to content](https://docs.huly.io/getting-started/workspace-setup/#_top) Setting up your workspace ========================= Creating your first workspace ----------------------------- When you first sign up for an account on Huly or TraceX, you will be prompted to create a workspace. Your workspace represents the virtual office space where your team will be working. Fully customizable to your team’s unique needs, your workspace serves as a central hub for communication, project planning, task tracking and collaboration. Give your workspace a great name and click `Create`. Inviting team members to your workspace --------------------------------------- Once your workspace has been created, you can invite team members to join. Select your profile icon on the bottom left of the sidebar. Then, select `Invite to workspace`. Select `Get invite link` to reveal the invite link. From there, you can copy the link, which you can share with your team members. It’s also possible to invite new members to your workspace by adding them directly as employees in the Contacts module. Navigate to Contacts and select Employee in the left side menu. Click the `+ Employee` button and enter a name and email address for the person you want to invite. An email invitation will be sent to the email address you entered. Only workspace owners and maintainers can invite new members or create employees. > **Note:** Under the current version of Huly, new members are not automatically added to projects and teamspaces unless you select the `auto join` toggle for those spaces. This helps you maintain control over who has access to the data within your workspace when new members join. ##### Configuring invite settings Workspace invite links come with some default settings. To configure these settings, open the settings panel by clicking on the horizontal marks at the top left of the sidebar. Select `Invite settings` in the settings panel. Here, you can configure settings for your workspace invitations, including the duration the link will be valid for, email mask and limit. The email mask can be used by the workspace owner to restrict access to your workspace by only allowing users with specific email domains to join. For example, if you only want users with email addresses from your company domain to join your workspace, you can set the email mask to `@yourcompany.com`. Workspace settings ------------------ To configure workspace settings, open the settings panel by clicking on the horizontal marks at the top left of the sidebar. The following are some basic settings that can be configured: * **General**: Add a custom logo for your workspace, or change the workspace name. Here, you can also disable RBAC for the entire workspace (useful for testing purposes), or delete your workspace entirely. * **Backup**: Download a backup on your workspace data. * **Owners**: Set roles for all team members as User, Maintainer or Owner. To learn more about roles, see [this guide](https://docs.huly.io/advanced-settings/roles) . * **Configure**: Enable or disable modules in your workspace. For more on modules, see the section below. * **Invite settings**: Configure settings for workspace invitations. * **Export**: Export data from your workspace to JSON or CSV. Configuring modules ------------------- A **module** is a set of features that are combined to provide a specific functionality in your workspace. For example, `Tracker`, `Documents` and `Cards` are all modules. Huly and [TraceX](https://docs.huly.io/getting-started/introduction-tracex) come with several modules enabled by default, but you can customize your workspace by enabling or disabling modules based on your team’s needs. To configure which modules are enabled in your workspace, navigate to Settings and select “Configure” in the left side menu. Here, you can see all available modules and click `Enable` or `Disable` to toggle them on or off. ![Settings for configuring modules](https://docs.huly.io/_astro/settings-modules.BwIecUPa_Z1QF0qF.webp) If you’ve created data in an enabled module, disabling it will not delete the data, but it will hide the module from the sidebar. You can re-enable the module at any time to access your data again. Some modules are labeled as “Beta version”. This means that there are still some features that are being developed and tested, and may not be fully stable. Some modules — such as Inventory and Leads — are not actively being developed, and may not be prioritized for feature requests or bug fixes. Video tutorials: How to get started with Huly and TraceX -------------------------------------------------------- The documentation here in Huly Docs will walk you through everything you need to know about setting up your workspace in Huly or TraceX. However, if video tutorials are more your style, checkout our getting started guides on YouTube: --- # Learn the basics | Huly Docs [Skip to content](https://docs.huly.io/getting-started/learn-the-basics/#_top) Learn the basics ================ In many ways, Huly draws inspiration from existing project management tools. There are some tools out there that _just work_, and we’ve built our own unique versions of these familiar tools into an all-in-one platform where users will immediately feel at home. However, part of our work at Huly is imagining a better solution for process management that diverges from the beaten path and opens up possibilities for new ways of working. Setting up a task tracker or creating a knowledge base is simple in Huly, but to truly leverage all the platform has to offer, it’s important to understand the framework of how the platform works, what configurations are available, and how to navigate the interface. How data is organized in your workspace --------------------------------------- ### Workspaces At the highest level is the Huly **workspace**. You can create as many workspaces as you like under the same account, and each workspace is a completely separate entity. > **Note**: In the near future, we will be adding capabilities for interconnectivity _between_ workspaces, allowing you to manage shared tasks, resources and communication with workspaces operated by different individuals or teams. ### Spaces Within your workspace are **spaces**. The name for these spaces depends on the module; for example, spaces in the Tracker are called `projects`, spaces in documents are called `teamspaces`, and spaces in the file drive are called `drives`. A space determines the settings for all of the objects within that space. Every space has a [space type](https://docs.huly.io/advanced-settings/space-types) that defines the properties, roles, and other configurations for that space. Spaces have owners, members, and privacy settings. ### Objects **Objects** are the individual items within a space. For example, in the Tracker, a project contains objects like issues, sub-issues, milestones, and templates. In documents, a teamspace simply contains document objects. Navigating the platform ----------------------- ### Sidebar navigation All of the available modules are present in the left sidebar. You should see the following modules: * Inbox * Planner * Office * Contacts * Chat * Recruiting * Human resources * Tracker * Documents * Team * Drive * Test management * Surveys (in development) > **Note**: You can toggle which of these modules are visible in the sidebar by clicking the settings toggle in the bottom left corner. ### Context sidebar Each module has a left sidebar displays additional options and navigation within that module. If the sidebar is not visible, open it by clicking the hamburger icon below your workspace icon in the top left corner. ### Workbench tabs By default, the page you are currently viewing will appear as a tab at the top of your workspace. Open a new tab by clicking the `+` button to the right of the current tab. New tabs will automatically open to the inbox, but you can navigate anywhere without losing your place in your other open tabs. ### Right sidebar tabs On the right side of your workspace, you’ll see icons for your planner and office. Click these to open them in the right sidebar. Chat conversations can also be pinned to the right sidebar for easy access as you navigate the platform. Live virtual office calls will also be available in the right sidebar during the call. --- # Huly API and other tools | Huly Docs [Skip to content](https://docs.huly.io/getting-started/api-tools/#_top) Huly API and other tools ======================== Huly API -------- Huly has a basic API to get you started with your own integrations and extensions. Check out the [API documentation](https://github.com/hcengineering/huly-examples/tree/main/platform-api#readme) for setup steps and usage examples. Huly Import Tool ---------------- We offer an import tool to help you import data directly into your Huly workspace. Using our Unified Import Format, you can migrate your data into Huly by converting it to an intermediate, human-readable structure. Check out the [Huly Import Tool documentation](https://github.com/hcengineering/platform/tree/develop/dev/import-tool#readme) for setup steps and examples. We also support imports from [Notion](https://github.com/hcengineering/platform/blob/develop/dev/import-tool/docs/notion/README.md) and [ClickUp](https://github.com/hcengineering/platform/blob/develop/dev/import-tool/docs/clickup/README.md) . --- # Self-hosting Huly | Huly Docs [Skip to content](https://docs.huly.io/getting-started/self-host/#_top) Self-hosting Huly ================= We offer the option to self-host the Huly platform on your own server. All of the documentation for setting up and maintaining a self-hosted instance of Huly is available on our [huly-selfhost](https://github.com/hcengineering/huly-selfhost) GitHub repository. The main repository readme includes documentation on the following: * Cloning and configuring the repository * Setting up AWS SES email notifications * Setting up Love Service (Audio & Video calls) * Setting up AI Service * Configuring OpenID Connect * Configuring GitHub OAuth * Disabling Sign-up Everything you see in the cloud version can potentially be self-hosted; however, we may not “prepackage” some services for various reasons. Some integrations (like GitHub) may require you to install a separate app in GitHub or work with Google to enable an API, and we do not have extensive documentation to describe every case. Also, some parts of cloud version rely on proprietary Cloudflare services, which we intentionally do not include into self-hosting packages to avoid any vendor lock-ins. Migrating data between self-hosted and cloud -------------------------------------------- We do not have a way for users to migrate data from a self-hosted Huly instance to our cloud version through the GUI, but there is still a way to manually export/import your self-hosted data to huly.io. Feel free to reach us out when you need to do this and we will provide you guidance and help. In the reverse direction (migrating from could to self-hosted), if you are an owner of the workspace, you can do this in the desktop app. In the menu we have `Backup` option that saves workspace backup to your filesystem. When you have the backup, you can restore it to the self-hosted version. Support for self-hosting ------------------------ Support for self-hosting is community-driven, and the best way to get in touch with others who are self-hosting is through our [Slack](https://huly.link/slack) community in the `#open-source` channel. Here, you can ask questions, share tips, and get help from others who are also self-hosting Huly. Our team is also active in the community and we do our best to respond to as many questions as we can. However, due to the technical complexities of self-hosting and the wide range of factors that vary between individual setups, we may not be able to respond to every request for self-hosting support. For this reason, we encourage community members to support each other whenever possible, and of course we welcome any supplementary documentation provided by the community to add to our repository. --- # Mobile access | Huly Docs [Skip to content](https://docs.huly.io/getting-started/mobile-access/#_top) Mobile access ============= Plans for the Huly mobile app ----------------------------- We are still in the early stages of developing the Huly mobile app and are not able to share a specific ETA for release at this time. We’re working on big infrastructure changes that will profoundly impact the way users interact with Huly — particularly through our implementation of Global Huly, where you can manage your communications and work under your global user account. This, in addition to the development of new designs, are important steps towards introducing our mobile app. Check out this preview of early design ideations for our mobile app (and other exciting concepts): Accessing Huly and receiving notifications from your mobile device ------------------------------------------------------------------ Until we have a mobile app, you can access most of your Huly workspace through the browser on a mobile device, and we’re continuing to make improvements to the UI for mobile access. There are currently two ways to receive Huly notifications on your phone: 1. On iPhone, use Safari to add the Huly web app to your phone desktop, then use webpush to receive notifications. Some views in the interface may not be optimized for mobile yet, but you can still access chat, inbox and several other modules. 2. Use the Telegram app to connect with our bot. By connecting your workspace to Telegram, you can receive notifications, send chat messages and reply to threads without ever needing to open Huly. See our [Telegram integration guide](https://docs.huly.io/integrations/telegram) for more information. * * * To be notified when the mobile app is released (and see updates on ETA and progress along the way), join our [Slack](https://huly.link/slack) community and subscribe to our [changelog](https://v1.huly.io/changelog/) . --- # Support | Huly Docs [Skip to content](https://docs.huly.io/getting-started/support/#_top) Support ======= Our goal is to create documentation that covers all features, concepts and capabilities of the platform. However, Huly Docs is still in development, and some features may not be covered. For further guidance, check out some of our other helpful resources below. Join us on Slack! ----------------- For community support and questions, the best place to reach out is through our [Slack](https://huly.link/slack) community. We have a vibrant and growing community of over 600 members who are excited about our products and and eager to share tips and feedback. Our team is also very active in the community and we do our best to respond to as many questions as we can! > **But wait, isn’t Huly meant to be a _replacement_ for Slack?** > > We want our community to be available not just for current users, but also for those who are just exploring their options or want to ask questions before joining Huly. We don’t want anyone to experience barriers to joining the community and getting in touch with us here. > > Of course, in the near future everything will be able to be done through Huly, without any reliance on external communication tools. We’re steadily working towards our vision for a “global Huly”, which will allow for people to communicate with each other and with our own team using Huly, even if they haven’t already created or joined a Huly workspace. Our Slack community is also an excellent place to share your own feature ideas. We’d love to know what kinds of tools would help improve your experience - your feedback is incredibly valuable and helps shape the future of the platform! Get in touch on social media ---------------------------- [](https://x.com/huly_io) [](https://www.linkedin.com/company/hulylabs) Feature previews and exciting changes are often shared first on our social media channels before they’re even released! This is also a great platform to share your experience with Huly and get inspiration from other Huly users. Our team is active on X and LinkedIn and we respond regularly to questions and feedback. YouTube ------- We’re always adding to our [Huly](https://www.youtube.com/channel/@huly_io) and [TraceX](https://www.youtube.com/@TraceX) YouTube channels to include more feature demos and guided tutorials. This is a great place to start when looking for a quick overview of a key feature of the platform. If you have an idea for a tutorial that hasn’t been created yet, let us know and we’ll add it to the list! ![Huly YouTube channel](https://docs.huly.io/_astro/huly-youtube.D1DZs-ov_Z1tUEEL.webp) ![TraceX YouTube channel](https://docs.huly.io/_astro/tracex-youtube.BE7gqCmC_2748Xj.webp) Get support with TraceX ----------------------- [](https://x.com/TraceXeQMS) [](https://www.linkedin.com/company/tracex-company) [](https://huly.link/slack) Interested in TraceX? We frequently share updates and feature sneak peeks on our TraceX social media channels, so this is a great resource to follow if you’re looking for TraceX-specific content. Our Slack community also includes a special `#tracex-qms` channel where you can get in touch directly with our team and meet other TraceX users. --- # Parent-child Cards | Huly Docs [Skip to content](https://docs.huly.io/cards/parent-child-cards/#_top) Parent-child Cards ================== Cards can be connected through a parent-child relationship, where the child Card is best understood in the context of its parent Card. This is useful for creating a hierarchical structure of knowledge and information. Creating a child Card --------------------- To create a new child Card, click the `+ Create child` button on the parent Card. A new blank Card will be opened, where you can enter any information you want. The child Card will automatically be linked to the parent Card. Connecting existing Cards as parent-child ----------------------------------------- To connect an existing Card to a parent, right-click on the Card in the list or table view, or open the settings menu on the Card’s page. Select `Set parent` from the list, then select a Card for the parent. ![Setting a parent Card](https://docs.huly.io/_astro/set-parent.CAOSodAP_1xBIYg.webp) Disconnecting parent-child Cards -------------------------------- Any child Card can be disconnected from its parent by right-clicking or opening the settings menu and selecting `Unset parent`. Parent-child vs. Relations -------------------------- While both Relations and parent-child connections allow you to link Cards, they serve different purposes and are used in distinct scenarios. Here are some general guidelines: * Use **parent-child** relationships when one entity (the “child”) is dependent on another entity (the “parent”) and logically belongs under it, or when a hierarchical structure is needed. * Use **[Relations](https://docs.huly.io/cards/relations/relations-overview) ** when both entities exist independently but need to be linked to reflect their interaction or connection. Relations don’t imply a hierarchical structure, just that the entities are related in some way. ![Example of parent-child cards](https://docs.huly.io/_astro/parent-child-cards.Cbzqbz6Q_ZIhnHg.webp) --- # Introduction to Cards | Huly Docs [Skip to content](https://docs.huly.io/cards/cards-overview/#_top) Introduction to Cards ===================== Understanding Cards ------------------- Cards are a flexible framework for structuring information efficiently. While our initial implementation of Cards is focused on knowledge management, Cards will also serve as the foundation for many other features on the platform, including process management and threads. With Cards, you’ll be able to build your own custom applications within Huly, such as a CRM, CMS, project management system and more. This guide explains the core components of the Cards system: **Types**, **Tags**, **Relations** and **Cards**, providing an overview of the entire system. We also have more in-depth guides on each element so you can learn how to use them in your own workspace, which are linked in the sections below. Core elements of the Cards system --------------------------------- The following elements make up the Cards system. Click on any guide to learn more: * [**Types**](https://docs.huly.io/cards/types/types-overview) define the structure of information within the system. You can think of a Type like a blueprint with specific instructions for what details you’ll need to store for each piece of information. * [**Tags**](https://docs.huly.io/cards/tags/tags-overview) are used to add additional properties or behaviors to a Type. Tags allow you to define a specific set of properties that can be applied to multiple Types. * [**Cards**](https://docs.huly.io/cards/creating-cards) are “instances” of a Type — the real information that you’re storing in your knowledge management system. Each Card is a unique piece of information that follows the structure defined by its Type. * [**Relations**](https://docs.huly.io/cards/relations/relations-overview) define the connections between different Types and Tags, allowing you to link related information together with Cards. Using Cards for knowledge management ------------------------------------ Cards provide a structured and scalable way to organize knowledge. Unlike traditional document-based systems, where information can become scattered and difficult to navigate, Cards allow for dynamic connections, filtering, and categorization. This approach offers several advantages: * **Structured organization** - Each Card follows a defined Type, ensuring consistency. * **Easy navigation** - Relations between Cards create a web of interconnected knowledge, making it easy to find associated information. * **Scalability** - The modular nature of Cards allows you to expand your system at scale. * **Collaborative editing** - The rich text editor and activity tracking allow teams to work together collaboratively. Continue through the guides to learn how to put these concepts into practice, creating your own knowledge management system with Cards. ##### **Let’s build a game design system with Cards! 🎮** In the following guides, we’ll look at how to design an adventure game system using Cards. Game designers need to store information about **game components**, **documents** and **files**, keeping track of how everything is connected. We’ll use this example to illustrate how Cards can be used to create a comprehensive knowledge management system. ![Cards sneak peek](https://docs.huly.io/_astro/cards.Bnk6pvFt_Z29DPml.webp) --- # Creating Cards | Huly Docs [Skip to content](https://docs.huly.io/cards/creating-cards/#_top) Creating Cards ============== ##### **What is a Card?** A Card is an instance of a Type, representing a specific piece of structured information. It follows the properties defined by its Type and can include rich text, attachments, relations, and tags, making it a flexible building block. To use Cards effectively in Huly, it’s important to first understand their relationship with Types. Think of a **Type** as a blueprint and **Cards** as the structures built from that blueprint. If your blueprint defines a “house” as a structure with four windows and one door, then every house created from that blueprint will always have four windows and one door, regardless of color or furnishings. If you haven’t already, check out our guide on [Creating Types](https://docs.huly.io/cards/types/creating-types) — then return here to learn how to create Cards from the Types you’ve made. Creating a space ---------------- A space is like a container for your Cards. You can set permissions at the space level to determine who can access the Cards within that space. To create a new space, click the `+ Create Space` button in the top left corner of the Cards module. Here, you can enter a name, select they Types that will be used in that space, and set owners, members and privacy settings. Setting the space to “Private” will prevent anyone other than the members listed from accessing the Cards in that space. ![Creating a Cards space](https://docs.huly.io/_astro/cards-spaces.CegOB4LB_Z29prPe.webp) Spaces for Cards act like any other space in Huly, meaning you can leave, join and archive spaces, and global admin roles will apply. For more on managing permissions at the workspace and space level, see our guide on [Roles and Permissions](https://docs.huly.io/advanced-settings/roles) . Creating Cards -------------- Click `+ Create Card` in the top left corner of the Cards module. The following elements make up a Card: 1. **Title** - a name for your Card 2. **Type** - the Type that defines the properties of your Card (see [Creating Types](https://docs.huly.io/cards/types/creating-types) ) 3. **Properties** - the details of your Card, as defined by the Type 4. **Rich text editor** - a collaborative text editing area that supports markdown formatting, images, tables and more 5. **Children** - an area for adding child Cards (see [Parent-child Cards](https://docs.huly.io/cards/parent-child-cards) ) 6. **Attachments** - an area for uploading files 7. **Activity** - a log of all changes made to the Card and area for commenting > **Note:** Cards created from the `File` Type will have an additional area above the rich text editor for uploading files. To learn more about managing files with the `File` Type, see [File Types](https://docs.huly.io/cards/types/file-types) > . Beyond these basic elements, Cards can also include: * **[Relations](https://docs.huly.io/cards/relations/relations-overview) ** - connections to other Cards * **[Tags](https://docs.huly.io/cards/tags/tags-overview) ** - optional properties that can be applied to Cards of different types Relations and Tags are set at the Type level. In other words, when you want to create a new Relation or Tag for a Card, you’ll need to define this on the Type in Settings. To see how, check out these guides on [Defining Relations](https://docs.huly.io/cards/relations/defining-relations) and [Creating Tags](https://docs.huly.io/cards/tags/creating-tags) . ### Example: Creating an NPC Character Card To create a Card, first make sure you’ve selected the correct Type from the left side menu, then click the `+ Create Card` button. From here, you can enter information in all of the attributes you [defined on your Type](https://docs.huly.io/cards/types/creating-types) . Below is an example of a Card for an NPC character in our **game design system**: ![Example of an NPC Card](https://docs.huly.io/_astro/card-example-npc.Cm5scjV2_Z13pC1c.webp) Note that this `NPC` Card has several [Relations](https://docs.huly.io/cards/relations/relations-overview) , defined on the `Character` Type from which it was derived: * **`Item`** - a `Character` possesses `Items` * **`Environment`** - a `Character` exists in an `Environment` * **`Game Narrative`** - a `Character` is included in a `Game Narrative` Adding Card attribbutes ----------------------- To add an attribute to a Card, simply click the `+` icon next to the Type or Tag you want to add to. Adding a attribute on one Card will add the field to all existing Cards with that Type or Tag. Learn more ---------- To further explore working with Cards, check out these guides: * [Relating Cards](https://docs.huly.io/cards/relations/relating-cards) - Define structured relationships between Cards. * [File Types](https://docs.huly.io/cards/types/file-types) - Manage images, videos, PDFs, and other media within Huly’s default `File` Type. * [Tags](https://docs.huly.io/cards/tags/tags-overview) - Apply additional attributes across different Types. By understanding and structuring Cards effectively, you can build a powerful and flexible knowledge management system in Huly. --- # Cards vs. Documents | Huly Docs [Skip to content](https://docs.huly.io/cards/cards-vs-documents/#_top) Cards vs. Documents =================== You can use Cards to completely replace [Documents](https://docs.huly.io/knowledge-management/documents) in your workspace — or use them both simultaneously for different purposes. Let’s take a look at the key similarities and differences between Documents and Cards. #### Similarities * Content is created with the same text editor * Activity section records change history and includes area for commenting * Set roles, permissions and privacy at the space level #### Differences There are a few important differences between Cards and Documents, which are summarized in the table below: | **Feature** | **Documents** | **Cards** | | --- | --- | --- | | **Attributes** | Attributes are defined by the system (title, content, created by, etc.) and cannot be changed | In addition to the default attributes defined by the system, you can also define as many **custom attributes** as you want | | **Sorting and filtering** | Cannot be sorted or filtered by attributes | Can be sorted and filtered by attributes | | **Attachments** | No designated area for file attachments (you can only send attachments with a comment in the Activity section) | Designated area for attachments | | **Organizational structure** | Nested, where documents can be nested within other documents | Organized by Type, where Cards of the same Type are grouped together | | **Relations** | Can be linked together in a 1:1 relation through @ mentions and backlinks | Can be linked through parent-child relations, and using References and Relations defined on their Type | > **Note:** While our initial implementation of Cards is focused on knowledge management, Cards will also serve as the foundation for many other features on the platform, including process management and threads. With Cards, you’ll be able to build your own custom applications within Huly, such as a CRM, CMS, project management system and more. Stay tuned for more updates soon! * * * #### Okay, that was a lot of information … so which should I choose? Let’s keep it simple! ##### Use **Cards** if: * You need to add custom attributes to your docs, like “client”, “document type” or “status” * You need to be able to sort and filter your content by attributes * You need to define specific _relations_ between types of entities; for example: `Contract ←→ Client` * You plan to build processes and workflows around your Cards in the future ##### Use **Documents** if: * Your docs organization is simple, where the nested document structure is sufficient * You need to jot down some quick notes, without needing to store them in a structured format Of course, the best way to find out which system is right for you is to try them both and see what works. Happy exploring! 🚀 --- # What are Types? | Huly Docs [Skip to content](https://docs.huly.io/cards/types/types-overview/#_top) What are Types? =============== ##### **What is a Type?** A Type is a blueprint that defines the structure and properties of a Card. It specifies the attributes each Card will have, ensuring consistency and organization across the system. Types can also be derived to create variations with unique properties. Types define the structure of information within the system. Think of a Type as a blueprint that outlines the specific details you’ll need to store for each piece of information. In our **game design** example, we have three core Types: 2. **`Game Component`** - Physical or digital elements in the game world 3. **`Document`** - Written design, technical and narrative information. This is a default system `Document` Type. 4. **`File`** - Digital files used in the game, such as images, sounds, textures and 3D models. This is a default system `File` Type (see [File Types](https://docs.huly.io/cards/types/file-types) ). Each **Type** has a set of **properties** that define the specific details we want to capture for each piece of information. We can also derive Types to define variations that have their own unique properties. To learn how to create Types and derived Types in practice, check out our next guide on [Creating Types](https://docs.huly.io/cards/types/creating-types) . --- # View, sort and filter Cards | Huly Docs [Skip to content](https://docs.huly.io/cards/view-sort-filter-cards/#_top) View, sort and filter Cards =========================== Viewing, sorting, and filtering Cards in the game design system allows you to manage complex, interrelated pieces of information more efficiently than plain documents in Huly. While documents are static and typically organized in a linear fashion, Cards offer a dynamic, flexible way to organize and access content based on various attributes, relationships, and tags. This approach enables you to quickly locate relevant information, prioritize tasks, and track connections Cards. How Cards are organized ----------------------- In the Cards module, you’ll notice that the left side navigation displays all of your Types. Cards are grouped together by Type, so you can easily view all Cards that share the same structure. Click on any Type in the sidebar to view its Cards. Viewing Cards ------------- Within a Type, there are two ways to view Cards: ##### Table view The table displays Cards in a spreadsheet-like format, with columns for each property defined by the Type. ##### List view The list view displays Cards grouped by their Type. In list view, you can also group Cards by the user who created or modified them. Sorting Cards ------------- In the table view, you can sort most columns by clicking on the column heading. Use the toggle icon to further customize the view by selecting which columns to display in the table. Creating filtered view ---------------------- Click the `Filter` button to create a view with specific criteria. You can filter Cards by as many criteria as you like. ![Filtering a list of Cards](https://docs.huly.io/_astro/filter-list.BZNz7fRl_1v5Waw.webp) To save your filtered view for easy access later, click `Save as` and enter a name for your filtered view. Your view will be saved to the sidebar, where you can then select whether to make it public (visible to others) or private (visible only to you). --- # Use cases for Cards | Huly Docs [Skip to content](https://docs.huly.io/cards/use-cases/#_top) Use cases for Cards =================== This guide provides examples of common ways to use Cards for knowledge management. Each example includes suggested [Type](https://docs.huly.io/cards/types/types-overview) structures and [Relations](https://docs.huly.io/cards/relations/relations-overview) that you can use as inspiration and adapt to your own workspace. * * * 📚 Dive into real-world use cases --------------------------------- Cards are a versatile solution for managing many different kinds of knowledge in your workspace. Click on each section below to see an example of Types and Relations for each use case based on real-world knowledge systems. You’ll find that some of these examples can also be interconnected, allowing you to create a network of knowledge spanning all areas of your organization. **Knowledge Base Articles** — build a structured knowledge base to organize articles like how-to guides, FAQs, and release notes. ##### Types and sub-types > Articles come in many formats, and different kinds of articles can have different properties. Here are some examples of Types you might use in a knowledge base and their unique attributes: * **`Knowledge Base Article`** * Summary (string) * Category (select) * Audience (multi-select) * Last updated (date) * Product area (select) * **`How-To Guide`** (Sub-type) * Prerequisites (multi-select) * Estimated time (number) * **`FAQ Entry`** (Sub-type) * Question (string) * Answer (string) * Related topics (multi-select: reference to `Topic` Cards) * **`Release Note`** (Sub-type) * Release version (string) * Release date (date) ##### Relations * Related articles (`Knowledge Base Article` ↔ `Knowledge Base Article`) * Supports feature (`Knowledge Base Article` → `Product Feature`) * Explains concept (`Knowledge Base Article` → `Glossary Term`) **Meeting Notes** — keep track of discussions from meetings across teams. ##### Types and sub-types > Depending on how many different kinds of meetings your team operates, you may wish to organize your meeting notes into different Types. Here are some examples: * **`Meeting Note`** * Topic (string) * Date (date) * Participants (multi-select: reference to Employees) * Summary (string) * **`Team Meeting`** (Sub-type) * Department (select: reference to `Department` Card) * Recurrence (select: weekly, bi-weekly, monthly) * **`Project Meeting`** (Sub-type) * Related project (reference: `Project` Card) ##### Relations > In some cases, you may want to use Relations instead of References to link your meeting notes. Check out [this guide](https://docs.huly.io/cards/relations/relations-vs-references) > to determine which is best for you! Here are a few example Relations you might use: * Related to project (`Meeting Note` → `Project`) * Related to department (`Meeting Note` → `Department`) **Feature Specs** — document detailed plans for product features. ##### Types and sub-types * **`Feature Spec`** * Feature (string) * Status (select: Draft, Approved, In Development, Released) * Owner (reference: Employee) * **`UI Feature`** (Sub-type) * Screens affected (multi-select) * Design link (url) * **`Backend Feature`** (Sub-type) * API changes required (checkbox) * Data model changes (checkbox) ##### Relations * Depends on (`Feature Spec` → `Feature Spec`) * Implements (`Feature Spec` → `Product Feature`) * Informed by (`Feature Spec` → `Research Summary`) **Research Summaries** — record findings from studies, interviews, and experiments. ##### Types and sub-types * **`Research Summary`** * Research method (select: Survey, Interview, Usability Test, Experiment) * Date conducted (date) * Related product area (select) * **`User Interview Summary`** (Sub-type) * Interviewee (reference: Person) * Interviewer (reference: Employee) ##### Relations * Informs (`Research Summary` → `Feature Spec`) * References (`Research Summary` →`Research Summary`) **Process Documentation** — map out operational workflows, standard procedures, and playbooks. ##### Types and sub-types * **`Process Guide`** * Process name (string) * Trigger event (string) * Owner (reference: Employee) * **`Standard Operating Procedure`** (Sub-type) * Compliance Requirement (select) * Review Cycle (Months) (number) * **`Playbook`** (Sub-Type) * Scenario (string) ##### Relations * Related Processes (Process Guide ↔ Process Guide) * Supports (Process Guide → Department or Team Card) **Marketing Campaign Plans** — organize campaign briefs, timelines, and strategies in one place. ##### Types and sub-types * **`Campaign Plan`** * Campaign name (string) * Objective summary (string) * Launch date (date) * Channels (multi-select: Email, Social, Paid Ads, Web) * Target Audience (multi-select) * **`Product Launch Campaign`** (Sub-type) * Related product (reference: `Product` Card) * **`Seasonal Campaign`** (Sub-type) * Seasonal theme (string) ##### Relations > You can relate a campaign to a product by a reference attribute (in the example above), or by using a Relation. Check out [this guide](https://docs.huly.io/cards/relations/relations-vs-references) > to determine which is best for you! Here are some examples of Relations you might use: * Related product (`Campaign Plan` → `Product`) * Supported by content items (`Campaign Plan` → `Content`) * * * 💡 Tips for designing your own Cards system ------------------------------------------- While it’s helpful to look at example use cases when considering how to use Cards in your own workspace, you are ultimately the architect of your own knowledge management system, and it’s up to you how to prefer to structure your information. Here are some tips to help you design your own Cards system: 1. **Start simple:** Begin with a few core Types that cover your most important information. You can always expand later as your needs grow. It’s also possible to change the Type of a Card after it’s been created — so no worries if you decide to re-organize later! 2. **Keep processes in mind:** If you read the [Introduction to Cards](https://docs.huly.io/cards/cards-overview) doc, you already know that we are currently building a new process management system entirely based on Cards. You’ll be able to build processes like customized leads funnels, agile workflows, customer management systems and more — all from a foundation built with Cards. If you think you’d like to leverage Cards for your processes in the future, we suggest building your information architecture with this in mind. 3. **Connect Cards to the rest of your workspace:** While we expect to deliver processes by the end of Q2 2025, you can already connect Cards to other parts of your workspace. From any Card, you can create a Reference attribute to point to any person or company already in your Contacts. You can also link to Cards from anywhere — including chats and issue descriptions — using @ mention syntax. Try it out! 4. **Reach out for support and inspiration!** Join over 2,700 members in our [Slack community](https://huly.link/slack) to ask questions, share your use cases, and provide feedback and feature requests for our team. We’re happy to help you get started with Cards and would love to work with you to make this system as useful as possible. --- # Creating Types | Huly Docs [Skip to content](https://docs.huly.io/cards/types/creating-types/#_top) Creating Types ============== To create a Type, navigate to Settings, find `TYPES` in the left side menu, and click the `+` button that appears when hovering over the header. Enter a name for your Type and click `Create`. ![Overview of Types settings](https://docs.huly.io/_astro/types-overview.BmHEqWg1_zM4SX.webp) Adding properties ----------------- Next, add some properties for your Type. **Properties** are anything that will be shared by all Cards of this Type. To add a property, click the `+` button in the properties section. Select from the following: * URL * Text * Checkbox * Number * Date * Reference (link to an Object in your workspace) * Multi-select (select multiple Objects or dropdown values) * Select (select one dropdown value) In our example, we know that all Game Components will have a `Name` and `Description`, so we’ll add these on the `Game Component` Type as `Text` properties. > **Note:** Properties can also be added directly to Cards — see [Creating Cards](https://docs.huly.io/cards/creating-cards) > . ##### Creating dropdown menus (enums) If you chose to add a property of type “Multi-select” or “Select”, you can create a dropdown menu with options. Click the `+` button to add a new select menu (called an “**enum**”). Enter a title and options for the menu and click `Save`. Then, select your menu from the “Select” dropdown to use it for this property. In our example, we’ve created a Type `Character` and added a “Multi-select” property `Movement modes` with a dropdown menu of options: `🏃 Ground`, `🦅 Air`, and `🌊 Water`: ![Creating an enum](https://docs.huly.io/_astro/create-enum.C_jwclJm_ZpjdWn.webp) Creating derived Types ---------------------- We mentioned that the `Game Component` Type will have a “Name” and “Description” property. But what if we want to create different kinds of `Game Components`, each with their own unique properties? Types can be derived from other Types to define variations that have their own unique properties. To create a derived Type, find the `TYPES` section on the main Type page and click the `+` button. From here, the steps for creating a derived Type are the same as creating any other Type. Note that the derived Type will automatically inherit all properties of the Type from which it was derived. In our example, we can derive several new Types from the `Game Component` Type, such as `Character`, `Item` and `Environment`, each with their own set of properties. We can create as many levels of derivation as is needed. In the example below, we’ve derived Types `Player`, `Enemy` and `NPC` from Type `Character`. ![Derived Types](https://docs.huly.io/_astro/derived-types.EbHFrhsM_Z1UV5Pl.webp) We can define properties on each Type, like this: * **`Game Component`** * Name * Description * **`😶 Character`** * Speed (m/s) * Jump height (m) * Movement modes (ground, air, water) * Max health * Stamina * **`🤺 Player`** * Abilities (jump, attack, talk, etc.) * XP * **`👿 Enemy`** * Attack patterns (claw swipe, fireball, charge attack) * **`🧑 NPC`** * Affiliation (friendly, neutral, hostile) * Essential? (yes/no) * Respawn? (yes/no) * **`🎒 Item`** * Item type (weapon, consumable, key item) * Effect * Rarity (common, rare, legendary) * **`🌎 Environment`** * Size (small, medium, large) * Interactive? (yes/no) Deleting a Type --------------- To delete a Type, navigate to the Type page in Settings and click the trash icon in the top right corner. Note that deleting a Type will also delete all Cards of that Type, and this action cannot be undone. --- # What are Tags? | Huly Docs [Skip to content](https://docs.huly.io/cards/tags/tags-overview/#_top) What are Tags? ============== ##### **What is a Tag?** A Tag is a set of additional properties that can be applied to a Card, allowing you to define behaviors or attributes that extend a Card’s functionality. Tags provide flexibility by enabling shared properties across different Types without requiring new Types. We’ve seen how we can [create variations of a Type](https://docs.huly.io/cards/types/creating-types/#creating-derived-types) . But what if we want to define some kind of behavior or functionality without altering the core structure of the Type itself? Tags allow you to add multiple additional attributes to a single Card. In our game design example, we can create Tags like `Flying` and `Wizard` added to the `Character` Type, so any `Character` Card we create could have access to these attributes: ![Tags Settings](https://docs.huly.io/_astro/tags-settings.BQKSrDH3_ZAGNz4.webp) In our next guide, we’ll learn how to create the Tags we just described. Check out [Creating Tags](https://docs.huly.io/cards/tags/creating-tags) to get started! Tags vs. Types -------------- > _**But wait**, couldn’t I just create separate Types for Flying Characters and Wizards?_ **Yes, you absolutely can!** Creating separate Types for each variation is a valid approach. However, the benefit of using Tags is flexibility — you don’t need to create a new Type for every possible combination of behaviors or attributes. Instead, Tags allow you to mix and match properties based on the unique needs of each Card. On the other hand, creating new Types might be more appropriate if the differences between variations are fundamental to the design or behavior of the Card. Both methods have their pros and cons. It’s up to you, as the system designer, to experiment and choose the approach that best suits your needs. --- # File Types | Huly Docs [Skip to content](https://docs.huly.io/cards/types/file-types/#_top) File Types ========== The Huly Cards system comes with a special default Type called **`File`**. This basic Type allows you to manage files, such as images, videos, PDFs and other media. The `File` Type behaves the same as any other Type, with a few key differences: 1. The `File` Type **cannot be deleted**. 2. Cards created from the `File` Type (or derivations of the `File` Type) include a **designated area for uploading files**. ![File Card](https://docs.huly.io/_astro/blank-file-card.T0_i5nZd_Z1Akpe2.webp) You can think of the `File` Type as the foundation for an advanced file drive system. Rather than uploading files to a single drive and organizing them into folders, you can create a Type for each category of files you want to manage and define their shared properties. Deriving Types from `File` -------------------------- To create new Types derived from `File`, navigate to Settings, select `File` under `TYPES` in the left sidebar, and click the `+` button in the `Types` area. Creating a Type derived from `File` the same as creating any other derived Type (see steps for [creating derived Types](https://docs.huly.io/cards/types/creating-types/#creating-derived-types) ). In our **game design** example, we’ll create two Types derived from `File` to manage different categories of game assets, each with their own properties: * **`File`** * **`Game Asset`** * Name * Description * Formats * **`🖼️ Image Asset`** * Dimensions (px) * Transparency? (yes/no) * **`🔊 Audio Asset`** * Purpose (soundtrack, sound effect) * Duration (s) * Looping? (yes/no) ![Types derived from Game Asset](https://docs.huly.io/_astro/game-asset-types.Dqz_-u9J_2hedOJ.webp) ![Image asset properties](https://docs.huly.io/_astro/image-asset.qjoCKEYS_Z1FFUTv.webp) ![Audio asset properties](https://docs.huly.io/_astro/audio-asset.DuFJChYI_1kV84Q.webp) Creating Cards from `File` Types -------------------------------- Creating Cards from `File` Types is the same as creating Cards from any other Type (see our guide for [Creating Cards](https://docs.huly.io/cards/creating-cards) ) — when you create a Card from a `File` Type, however, you’ll see a designated area for uploading files. Here, you can click the upload button or drop your files into the upload area. Below is an example of a Card created from the `Audio Asset` Type: ![Sound effect Card](https://docs.huly.io/_astro/sound-effect-card.CyTEqgHK_2B9AG.webp) > **WARNING:** Once uploaded, a file **cannot be deleted** from the Card. Tips for using the `File` Type ------------------------------ The `File` Type is a powerful tool for managing files in your Huly workspace. Here are some tips for getting the most out of it: * **Create your custom file system** - Create different Types for various categories of files to ensure everything is neatly organized in one place. * **Collaborate on media assets** - Use the `File` Type to store media that you may need to discuss with the team or add context to within the editor. * **[Relations](https://docs.huly.io/cards/relations/relations-overview) ** - Link your files to other Cards in your knowledge management system to establish connections between related resources. * **Track metadata** - Define useful properties for each Type, such as dimensions, duration, or format, to make it easier to filter and organize files based on their characteristics. Other ways to connect files to Cards ------------------------------------ In addition to using the `File` Type, there are several other ways to link files and media to Cards. There are advantages to each method, so choose the combination that works best for you! * **Card attachments** - Attach files to any Card, regardless of its Type, by adding them directly to the Card’s interface (see [Creating Cards](https://docs.huly.io/cards/creating-cards) for an example). This is a great way to quickly attach a file that doesn’t need its own dedicated Card. * **Inline embeds** - Use the `/` shortcut in the collaborative editor to embed images directly within the content. This is useful for adding visual elements to text-based Cards. * **Comment attachments** - You can also attach files to specific comments within the activity section, which is handy when you need to send a resource or snapshot with your message. --- # Creating Tags | Huly Docs [Skip to content](https://docs.huly.io/cards/tags/creating-tags/#_top) Creating Tags ============= In the previous guide, we learned about Tags and how they can be used to define behaviors or attributes that extend a Card’s functionality. Now, let’s put that knowledge into practice and create some Tags. Creating a Tag -------------- Navigate to Settings and select the Type you want to add Tags to; then, click the `+` button in the Tags area. Add a name for your Tag and click `Create`. Adding Tag properties --------------------- Click on any Tag to open it. To add a property to a Tag, click the `+` button in the properties section. Adding properties to a Tag is the same as adding properties to a Type (see [this guide](https://docs.huly.io/cards/types/creating-types/#adding-properties) ). These properties will only be available on Cards using that Tag. In our **game design** example, we’ve added a custom property “Flying speed” that exists on the `Flying` Tag: ![Tag properties](https://docs.huly.io/_astro/tag-properties-flying.DA58ae_z_27g91q.webp) To the `Wizard` Tag, we’ve added a property “mana”: ![Tag properties](https://docs.huly.io/_astro/tag-properties-wizard.BTddj6KA_2j1KGm.webp) Check out the next guide on [Applying Tags](https://docs.huly.io/cards/tags/applying-tags) to learn how to use this Tag on a Card. --- # What are Relations? | Huly Docs [Skip to content](https://docs.huly.io/cards/relations/relations-overview/#_top) What are Relations? =================== ##### **What is a Relation?** A Relation defines a connection between Cards, linking information across the system. Relations are created between Types in Settings before any Cards exist, establishing predefined associations. Once Cards are created, they can be connected through these Relations, forming a structured and interconnected knowledge base. Relations allow you to connect Cards and define their interactions in a way that reflects real-world relationships. This allows you to: * **Build networks of interconnected data** - Relations help create a web of linked information, allowing you to easily explore how various entities relate to one another. This interconnectedness makes it possible to visualize complex systems and understand the structure of information. * **Optimize data navigation** - Relations make it easy to navigate between associated Cards, making it easier to find relevant information quickly. In our **game design** example, a `Character` Card may be related to an `Item` Card that the character posesses, or a `Game Asset` Card could be related to a `Game Component` that it’s used for. To learn how these relationships work in practice, check out our guides on [Defining Relations](https://docs.huly.io/cards/relations/defining-relations) and [Relating Cards](https://docs.huly.io/cards/relations/relating-cards) . --- # Relations vs. References | Huly Docs [Skip to content](https://docs.huly.io/cards/relations/relations-vs-references/#_top) Relations vs. References ======================== In some cases, you may want to connect Cards together using References instead of Relations. Relations are bi-directional, meaning that a Relation will appear on both Cards involved the relationship. In our example of a `Character` possessing an `Item`, the Relation will appear on both the `Character` and the `Item` Card. > **Below:** The `Item` is shown on the `Character` Card ![Character Card](https://docs.huly.io/_astro/character-item-relation.B8nLc-jl_Z2tkbHl.webp) > **Below:** The `Character` is shown on the `Item` Card ![Item Card](https://docs.huly.io/_astro/item-character-relation.DMLnmJ73_Z2vOouD.webp) References, on the other hand, are one-directional. A Reference will only appear on the _**Referring**_ Card, and a Reference is a type of attribute. Instead of using a Relation to define the association between `Character` and `Item`, you can add a Reference attribute to the `Character` Type that references the `Item` Type. This can be a single-select or multi-select attribute, depending on your use case. In this case, the `Item` Card will not show which `Character` possesses it. > **Below:** Add a reference attribute to the `Character` Type in Settings ![Setting a reference attribute on a Type](https://docs.huly.io/_astro/character-item-ref-settings.BLf64rT0_1fR4Fl.webp) > **Below:** Select `Item` Cards on the `Character` Card using the Reference attribute ![Using a reference attribute on a Card](https://docs.huly.io/_astro/character-item-ref-card.9R2Hvs0E_1Um4E6.webp) Deciding whether to use a Relation or Reference ----------------------------------------------- The decision to use a Relation or Reference depends on your use case and how you’d like to design your own system. Here are a few things to consider with regard to functionality and presentation of your data. > **Note:** We will diverge here from our game design example to illustrate the difference between Relations and References using a more general example of `Person` and `Meeting`. Soon, Persons in Huly will be replaced with Cards, allowing you to manage your contacts in a more robust and customized database system. The examples in this section demonstrate the differences between Relations and References on a large scale, considering a case of a team managing thousands of contacts and meetings. ##### Visibility and navigation Relations are visible on both Cards, making it easy to navigate between related entities. This bi-directional visibility is useful when you want to maintain a clear and reciprocal connection between two entities. For example, if you have a `Person` that is related to a `Meeting`, both the `Person` Card and the `Meeting` Card will show this relationship, allowing easy navigation in both directions. ##### Scalability As your system grows, consider how each option will scale. For example, let’s say you want to create Cards for **meeting minutes**. You may want to create a Relation: * `Meeting` N:N `Person` * **Attended** (`Meeting`) - **Attendees** (`Person`) * _Meaning: A Meeting has **attendees**; a Person **attended** Meetings._ This may seem convenient at first — you can see all of the attendees in the Relations section of each `Meeting` Card, and you can see which meetings everyone attended on the `Person` Cards. However, as the number of meetings grows, each `Person` may end up with an overwhelming number of meetings on their Card, making it difficult to navigate. In this case, a better solution might be to use a Reference attribute on the `Meeting` Type; for example: * **`Meeting Minutes`** (Type) * Date * Topic * Attendees (Reference to `Person`) In this case, you can add many `Person` Cards to the `Meeting` Card without cluttering the `Person` Cards themselves. ##### Sorting and filtering References are a type of attribute, so you can sort and filter your Cards based on the Reference value. If you might want to sort or filter your Cards by a specific attribute, consider using a Reference instead of a Relation. In our example of `Person` and `Meeting`, if `Person` is a Reference attribute on the `Meeting` Type, you can easily create filtered views for meetings attended by different groups of people. Designing your own knowledge system ----------------------------------- Ultimately, how you design your system is up to you! There are advantages and disadvanteges to every kind of setup, and there’s no “correct” way other than the way that works best for you. --- # Defining Relations | Huly Docs [Skip to content](https://docs.huly.io/cards/relations/defining-relations/#_top) Defining Relations ================== To define Relations between Types, navigate to Settings and open the Type you want to add a Relation to. Click the `+` button in the Relations area. ![Adding a Relation](https://docs.huly.io/_astro/relations-dialog.cj_o5uGM_Z1sYpFj.webp) Naming Relations ---------------- When defining a Relation, you’ll need to give it a clear and descriptive name on both sides. The names should be human-readable and indicate the nature of the relationship between the two entities. Let’s look at some examples of Relations on our `Character` Type: * **Possessed by** (`Character`) - **Possesses** (`Item`) * _Meaning: A Character **possesses** an Item; an Item is **possessed by** a Character._ * **Inhabited by** (`Character`) - **Exists in** (`Environment`) * _Meaning: A Character **exists in** an Environment; an Environment is **inhabited by** a Character._ * **Features** (`Character`) - **Included in** (`Game Narrative`) * _Meaning: A Character is **included in** a Game Narrative; a Game Narrative **features** a Character_ These names describe how two Types are connected, allowing the system to establish their relationships clearly and logically. ![Relations on the Character Type](https://docs.huly.io/_astro/character-relations.BCdCC924_Z1kJ4gh.webp) Selecting the kind of Relation ------------------------------ When creating a Relation, you must specify the kind of relationship between the entities. There are three kinds to choose from: #### 1:1 Relation **Definition**: One entity of the first type is related to exactly one entity of the second type. **Example**: An `Item` has only one `Audio Asset`, and an `Audio Asset` is only used by one Item. **Use case**: This type of relation is ideal for cases where a single instance of one entity is paired with a single instance of another. For instance, each `Item` may have a unique `Audio Asset` associated with it. #### 1:N Relation **Definition**: One entity of the first type is related to multiple entities of the second type. **Example**: A `Quest` can have multiple `Objectives`, but each `Objective` belongs to only one `Quest`. **Use case**: This relation type is commonly used when a single entity (like a `Quest`) can be linked to multiple related entities (like `Objectives`), but each related entity (an `Objective`) is only connected to that one instance of the first entity. #### N:N Relation **Definition**: Multiple entities of the first type are related to multiple entities of the second type. **Example**: A `Character` can have multiple `Items`, and an `Item` can be used by multiple `Characters`. **Use case**: This relation type is useful when many instances of one entity (e.g., `Character`) can be associated with many instances of another entity (e.g., `Items`). It reflects a more dynamic, interconnected system, like a character inventory or shared assets. By defining clear and meaningful Relations between your Types, you can create a system where entities are connected in ways that mirror their real-world interactions. This adds depth to your data structure, making it easier to navigate, manage, and scale as your system grows. Using Relations with Cards -------------------------- Check out our guide on [Relating Cards](https://docs.huly.io/cards/relations/relating-cards) to learn how to connect Cards using the Relations you’ve defined. --- # Creating projects | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/creating-projects/#_top) Creating projects ================= What are projects? ------------------ Projects are all the things your team will be working on, and can be organized however you’d like to suit your needs. For example, a software engineering team may choose to break their work into projects like “Frontend”, “Backend”, “UX/UI” and “Testing”. A small business may choose to create projects like “Inventory”, “Marketing,” and “Design”. However, you’re welcome to set your projects up in any way — they simply represent distinct spaces that will contain your tasks. Creating a project ------------------ > **Note:** Only workspace owners and maintainers can create projects. To learn how to grant a user special permissions, see our guide on [roles](https://docs.huly.io/advanced-settings/roles) > . Select the Tracker view by clicking the checkbox icon on the left sidebar, and ensure the side panel is open by clicking the horizontal lines at the top left. Click the `+` icon that appears when hovering over “Your Projects” in the side panel, or click the dropdown menu next to the `+ New issue` button and select `Create project`. This will open a dialog where you can enter some initial settings for your project. After entering your desired settings, click `Create`. ![Create project](https://docs.huly.io/_astro/tracker-create-project.BAwg2K_3_1wKSMh.webp) Project settings ---------------- When creating or editing a project, you can configure the following settings: **Project type**: The default project type is “Classic project”. You can create your own project types in your workspace settings. **Project title**: A title for your project. **Identifier**: An abbreviation used to identify issues created for this project. This is automatically generated when you enter your project title, but can be customized. **Description**: A description of your project. **Choose icon**: Select an icon to represent your project, choosing from either a default icon with a custom color or an emoji. **Default assignee for issues**: Select a member who you’d like to be assigned issues by default. **Default issue status**: Select the status all new issues should default to when they are created. **Owners**: Select the owner of the project, who will have permissions to edit the project details. **Make private**: Toggle whether you’d like this project to be visible only to members. **Members**: Select all members for this Project. **Auto join**: Toggle whether you’d like new members to be automatically added to this project. --- # Relating Cards | Huly Docs [Skip to content](https://docs.huly.io/cards/relations/relating-cards/#_top) Relating Cards ============== After setting up [Relations](https://docs.huly.io/cards/relations/defining-relations) , you can start relating Cards to each other. Navigate to any Card created from a Type that has Relations. Near the bottom of the Card, you’ll find all of the Relations you defined in Settings. Adding a Relation ----------------- Click the `+` button to add a Card. You’ll see a dropdown menu of all available Cards of the related Type. Select a Card to establish the connection. In our **game design** example, we’ve defined Relations between `Character`, `Item`, `Environment` and `Game Narrative` Types. Here, we can see the name of each Relation and all of its related Cards. ![Relations on a Character Card](https://docs.huly.io/_astro/character-relations-card.DCDxVwDx_1uHOeQ.webp) > **Note:** It is currently possible to create a relation to a Person or Company in your Huly workspace. Soon, Persons will be replaced with Cards, allowing you to seamlessly manage your contacts within the Cards system. Removing a Relation ------------------- To remove a related Card, simply right-click on the Card name and select `Remove relation`. This will break the connection between the two Cards. To delete the Relation entirely, navigate back to Settings, open the Relation and click the trash icon. This will break the relations for all associated Cards. Parent-child Cards ------------------ In some cases you may want to connect parent-child Cards instead of using Relations. For more on this, see [Parent-child Cards](https://docs.huly.io/cards/parent-child-cards) . --- # Creating issues | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/creating-issues/#_top) Creating issues =============== What are issues? ---------------- Issues represent specific tasks that need to be completed. Issues can be broken down into sub-issues for smaller tasks that need to be completed to accomplish the parent issue. Issues are organized into projects, which define distinct spaces that contain your tasks. > **Note:** Whenever an issue is created with a status of “Todo” and is assigned to a team member, the system automatically generates an [action item](https://docs.huly.io/task-tracking/creating-action-items) > in that member’s Planner, allowing them to add it to their own schedule. Creating an issue ----------------- Select the Tracker view by clicking the checkbox icon on the left sidebar, and ensure the side panel is open by clicking the horizontal lines at the top left. Click the blue `+ New issue` button at the top of the side panel. This will open a dialog where you can enter some initial settings for your issue. After entering your desired settings, click `Create issue`. > **Note:** If you navigate away while creating an issue, you’ll notice that the `+ New issue` button becomes `+ Resume draft`. Click this to re-open the issue you were working on. ![Create issue](https://docs.huly.io/_astro/tracker-create-issue.CQmMh7RS_Z2cUqkU.webp) Issue settings -------------- When creating or editing an issue, you can configure the following settings: **Project**: In the top left corner of the dialog, you will see the project that this issue is associated with. Click on the name of the project to see a dropdown where you can choose to select a different project to associate with this issue. **Issue title**: A title for your issue. **Description**: A description of your issue. Descriptions may be formatted with markdown formatting, including headers, codeblocks, links and more. **Issue status**: Setting the issue status to “Todo” (and adding an assignee) will automatically generate an [action item](https://docs.huly.io/task-tracking/creating-action-items) in that member’s Planner **Priority**: Choose from No priority, Low, Medium, High or Urgent. **Assignee**: Select a member to assign this issue to. **Labels**: Add labels for this issue or add new ones. This is optional, but can be helpful for sorting issues later. To learn more about managing labels, take a look at [this guide](https://docs.huly.io/task-tracking/labels) . **Estimation**: Add an estimation for how long this issue will take to complete. This is optional, but is a helpful tool for workflow tracking and scheduling. **Due date**: Select a due date for this issue. This is also optional. **Set parent issue**: Make this issue the sub-issue of an existing issue. If the issue already has a parent, simply click the unset icon next to the parent issue to detach it. **Attach**: Attach a file, image or other media to this issue. Tips for creating effective issues ---------------------------------- There are so many ways to customize issues to suit the needs of your specific projects and workflows! However, there are a few tips to keep in mind as you create issues for your team. * Issues should be small in scope, representing a task assigned to just one person. For larger tasks, use sub-issues to break them down further. * Unless they are in backlog, all new issues should have a status of “Todo” to trigger the system to create an [action item](https://docs.huly.io/task-tracking/creating-action-items) for the assigned team member. * In keeping with best practices, an issue status should not need to be manually changed from “Todo” to “In Progress” or “Done”. The status of an issue can automatically be determined by the assigned team member’s action item status. For more on how this process is automated (and why), read more about action items (previously called “todos”) [here](https://huly.io/blog/capturing-dynamic-team-workflows-with-action-items) . Dive deeper with our video tutorial ----------------------------------- Check out our tutorial on task tracking in Huly for a step-by-step guide on creating issues, assigning action items and getting the most out of task automations. --- # Components | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/components/#_top) Components ========== What are components? -------------------- Components are essentially a way to categorize issues within a project - similar to [labels](https://docs.huly.io/task-tracking/labels) , but with a key difference: an issue can only belong to one component, whereas many labels can be added to a single issue. For example, components could be used to organize issues into categories like “UI”, “Core”, “Backend”, etc. How are components different from milestones? --------------------------------------------- [Milestones](https://docs.huly.io/task-tracking/milestones) are more useful when planning parts of a project related to timing or phases of work. Milestones move through the states Planned > In Progress > Completed, while components are simply used for categorizing issues around a topic or area. Using components ---------------- Just like other objects in Huly, components can have a description and attachments. Every component also has an activity section connected to chat, so team members can have discussions related to the component. ### Creating components Navigate to `Components` in the left side menu of the Tracker, under the project in which you’d like to create the component. Then, click the `+ Component` button in the top right corner. Add a title and optional description, and select a member as the Lead if applicable. Then, click `Create component`. ### Connecting issues to components On the component page, you can create a new issue to attach to that component by clicking the `+` button in the “Issues” section. The issue you create will be automatically connected to that component. You can also connect an existing issue to the component by navigating to the issue’s page and selecting the component in the right side menu. When creating a new issue from anywhere in the tracker, you can also select the component from the dropdown menu in the issue creation dialog. ### Using components to filter issues Components can be used in the same way as milestones and labels for filtering and sorting issues in the Tracker. For more detailed steps, see [Viewing issues](https://docs.huly.io/task-tracking/viewing-issues) . --- # Milestones | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/milestones/#_top) Milestones ========== What are milestones? -------------------- Milestones are a way of organizing issues in Huly. They can be used to group issues together based on a common theme, project, or timeline. For example, you might create a milestone for a specific feature release, a sprint, or a project phase. Milestones can be used to track progress, set deadlines, and ensure that issues are completed in a logical order. > **Note:** Milestones are specific to a project and cannot be moved to a different project in the Tracker. Creating a new milestone ------------------------ Navigate to the Tracker and select Milestones under any project. Then, click the `+ Milestone` button in the top right corner. From here, you can enter a name and optional description for your Milestone, and set a status and deadline. Adding issues to a milestone ---------------------------- ### Creating a new issue within a milestone There are a few ways to add issues to a milestone. If you haven’t created the issue yet, simply click the `+` button on the details page for any milestone. This will allow you to create a new issue that will be automatically linked to that milestone. Alternatively, when creating a new issue from anywhere else in the tracker, simply select the desired milestone from the dropdown menu in the issue creation dialog: ![Add a milestone to a new issue](https://docs.huly.io/_astro/milestones-create-issue.B-UA_Tkt_Z1BcOeC.webp) ### Linking an existing issue to a milestone If you’ve already created an issue and want to link it to an existing milestone, you can open the details page for that issue and select the desired milestone from the right sidebar: ![Add an issue to a milestone from the issue view](https://docs.huly.io/_astro/milestones-issue-view.Bp2QIGBb_Z1LD31S.webp) Alternatively, you could right-click on the issue in your tracker to open the context menu, and select a milestone from there: ![Add an issue to a milestone from the tracker view](https://docs.huly.io/_astro/milestones-tracker-view.EHOe0sZQ_2t6Uta.webp) Using milestones to sort issues ------------------------------- Like any other issue attribute, milestones can be used to filter and sort issues in the Tracker. For example, you can toggle whether or not you want to see the milestone for each issue in your Tracker, or you can customize your entire Tracker view by organizing issues by milestone. Issues can also be filtered by milestone, allowing you to quickly see all of the issues related to a selection of milestones. --- # Labels | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/labels/#_top) Labels ====== Using labels in the Tracker --------------------------- Labels can be used to categorize issues in the Tracker, making it easier to filter issues to find what you need. Labels can be added and removed when creating the issue, or after the fact in the right side panel. When viewing issues in your tracker, you can toggle whether or not to display labels for each issue by clicking `Customize view` and then clicking the toggle for `Labels`. To filter for all issues with a certain label, click `Filter` and select `Labels`, then check off any labels which should be included in your filter. Managing labels --------------- To manage your labels, navigate to `Labels` in the left side panel of the Tracker. From here, you can add, edit, and delete labels. * **Adding a label** - Click `+ Add label` in the top right corner. Enter a title and description, select a color and click `Create`. * **Editing a label** - Click on the label you wish to edit, make your changes, and click `Save`. * **Deleting a label** - Right-click on the label and click `Delete`. From here, you can also see how many issues are associated with each issue. Click on the column to sort by your most frequently used labels. --- # Issue collaborators | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/issue-collaborators/#_top) Issue collaborators =================== Issues can only be assigned to one person, but you can add collaborators to keep other team members informed about issue activity. Collaborators will receive notifications for issue activity according to their own personal notifications settings. Check out our demo video for a quick overview: Adding collaborators to an issue -------------------------------- To add a collaborator to an issue, open the details page for that issue and find the `Collaborators` section in the right sidebar. By default, the issue creator and assignee will be listed as collaborators. Select the person you’d like to add as a collaborator from the dropdown menu. You can also add yourself as a collaborator to issues you’d like to follow. This can be useful if you want to keep track of an issue that’s assigned to someone else. Adding yourself as a collaborator follows the same process as adding any other collaborator. Collaborators will receive a notification in their inbox to let them know that they’ve been added to the issue. New collaborators will also be shown in the activity section for that issue, so anyone viewing the issue can see who has been added. Managing notifications as a collaborator ---------------------------------------- Collaborators will automatically receive notifications in their inbox for issue activity, such as comments, updates to issue status, and other changes. The specific acitivities that will trigger notifications in the inbox will depend on the user’s own notifications settings. To manage your notifications, navigate to Settings and select `Notifications` from the left sidebar menu. Then, select `Issues`. Notifications settings for issues are the same regardless of whether you are the owner, assignee, or collaborator on the issue. From this settings menu, you can select which kinds of issue activity you’d like to receive notifications for. Push, email, and Telegram notifications can also be toggled on or off. ![Notifications settings for issue activity](https://docs.huly.io/_astro/settings-notifications-activity.COp4GKYe_2cPC22.webp) Viewing your subscribed issues ------------------------------ Being a collaborator for an issue makes it easy to see all of the issues you’re following in one place. Navigate to your Tracker and select `My issues` from the left sidebar. Then, select `Subscribed` from the top right menu. This view will show you all of the issues you’re either a collaborator, owner or assignee for. ![Viewing subscribed issues in the Tracker](https://docs.huly.io/_astro/tracker-subscribed.CGC8WUNF_Z1Tan6M.webp) Just like any other view in your Tracker, you can filter and sort issues to find exactly what you need, and save custom views for easy access later. To learn more about customizing your Tracker, see our guide on [viewing and sorting issues](https://docs.huly.io/task-tracking/viewing-issues) . --- # Related and blocking issues | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/related-issues/#_top) Related and blocking issues =========================== What are related issues? ------------------------ While it’s possible to connect multiple issues together by creating sub-issues, sometimes you may want to connect two issues that don’t have a direct parent-child relationship. For example, two issues may deal with a similar component, or one issue might be blocking another. In these cases, you can use issue relations to connect them in your task tracker. There are a few options available for connecting related issues in Huly: * Referencing an issue that already exists in your tracker * Creating a new issue that will be related to an existing issue * Marking issues as “Blocked by” Referencing an existing issue ----------------------------- On the details page for any issue, open the dropdown menu and select `Relations`, then `Reference another issue`. From here, you can select an any issue from the list of suggestions, or search for a specific issue by typing in the search bar. After you’ve selected an issue, you’ll see it appear in the “Related to” field in the issue details, where you can click to navigate directly to the related issue. > **Note:** You can also choose to reference other objects in Huly, like people or documents. These features will be covered separately in a future guide. ![Related issue](https://docs.huly.io/_astro/tracker-related-issue.B-qaTe_v_1HbBHw.webp) Creating a new related issue ---------------------------- If you’ve created an issue and you already know you’d like to create a new issue that’s related to the first one, you can create a new issue directly from the dropdown menu by selecting `New related issue`. This will open a dialog where you can fill out the details for the new issue. Once you’ve created the new issue, it will be automatically linked as a related issue. Blocking issues --------------- There may be cases where one issue is dependent on another, and you want to indicate that one issue should be resolved before the other one is completed. In these cases, you can mark one issue as “blocking” the other. Open the dropdown menu on any issue detail page and select `Relations`, then choose `Mark as blocked by`. Then, select the blocking issue from the menu. This will add the issue to the “Blocked by” field in the issue details. > **Note:** The current implementation does not actually prevent a blocked issue from being marked as complete before the blocking issue, but future versions of Huly will include a more complete development of this feature. In the meantime, you can use this feature as a visual indicator of dependencies between issues. Just like any other issue property, blocking can also be used when sorting issues in your tracker (see below). Viewing related and blocked issues ---------------------------------- In your tracker, you can filter issues by their related or blocking status by opening the `Filter` menu and selecting either “Related to” or “Blocked by”. This will display only the issues that are related to or blocked by the selected issue. For example, below I’ve filtered all issues in the tracker by those related to an issue for checking color contrast: ![Issues filtered by related status](https://docs.huly.io/_astro/tracker-filter-issues.upHKgBJr_2cSbP2.webp) --- # Issue templates | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/issue-templates/#_top) Issue templates =============== Issue templates can be used to create similar issues that follow the same format. These templates are particularly useful for things like bug reports and feature requests, where the same information is needed each time a new issue is created. Templates are specific to each project in your Tracker — so, for example, you could create a “Feature Request” template for each project, using different labels and assignees for each. Creating a new template ----------------------- To create a new template, navigate to any project in your Tracker and select `Templates` from the left sidebar menu. Then, click the `+ New template` button in the top right corner. Creating a template looks similar to creating any other issue. Enter a title and content for your template, as well as any default settings, such as priority level, assignee, and labels. The settings you select here will automatically apply to any issue created using the template. When you’re finished, click `Create`. > Below shows an example of a Bug Report template. This template has a default priority level “Urgent” and has a default assignee and labels. ![Template for bug reports](https://docs.huly.io/_astro/tracker-template.Dls4antU_ElENf.webp) Using a template ---------------- When creating a new issue, select the desired template from the dropdown menu at the top of the dialog. ![Dropdown menu for selecting a template](https://docs.huly.io/_astro/tracker-template-dropdown.71-vdbMX_1E6bES.webp) The template will automatically populate the issue title, description, and any other default settings you’ve specified. From there, you can make any necessary changes and click `Create issue`. Editing a template ------------------ Templates can be changed at any time by opening the template page and editing any of the details. Just like any other issue in Huly, templates can be edited collaboratively, and any changes to the template will be recorded in the activity section of the template page. Users can also add comments to templates, utilizing @mentions, reactions and chat threads to discuss with other team members. Activity related to templates is linked to the Huly chat and inbox modules, so you can easily keep track of any changes or updates to your templates. --- # Team planner | Huly Docs [Skip to content](https://docs.huly.io/team-resources/team-planner/#_top) Team planner ============ Navigating the team planner --------------------------- The team planner in Huly provides a way to visualize your team’s agenda at a glance. To navigate to the team planner, click the sun icon in the left side navigation bar. The team planner breaks the agenda down by project, and you can find each of your project listed on the left side panel. This design allows teams with multiple projects to easily see all of the work planned for each project. This also ensures project privacy, as team members will only be able to view the planner for projects they are a member of, while the workspace owner will be able to view all projects. For this reason, it is not currently possible to view the work for all projects at the same time. ### Agenda & calendar views By default, the team planner shows the agenda view of the previous and current day. You can scroll through the days using the arrow buttons in the top right corner, viewing 2 days at a time as you scroll. The calendar view displays either a daily or weekly calendar of each team member’s tasks. In the daily calendar, tasks are displayed as blocks, and can be viewed in 1-hour or 30-minute increments. The weekly calendar displays each team member’s tasks on each day of the week. ![Team planner](https://docs.huly.io/_astro/team-planner.B2aw-LJM_ZtYngR.webp) Visibility settings for action items ------------------------------------ By default, when a team member schedules an action item in the their personal planner (see [Scheduling action items](https://docs.huly.io/task-tracking/scheduling-action-items) ), it will automatically become visible on the team planner for all other team members. The title of the action item, associated issue, and number of hours scheduled are all visible. Clicking the dropdown arrow by that task will also reveal the specific time block the action item is scheduled for. If the team member has set the visibility of their action item to “Only visible to you”, it will not appear in the team planner. Action icon items that are not associated with a space (for example, those that are created manually in an individual’s personal planner) will not appear in the team planner. Once an action item has been added to their personal planner, the user can then select a visibility setting for that action item, depending on whether they want it to be visible to everyone, appear as “Busy”, or be only visible to them. Visibility settings for events ------------------------------ Events on a team member’s personal planner will also appear in the team planner, depending on the visibility settings. If the visibility is set to “Visible to everyone”, everyone on the team will be able to see the title, time and duration of the event. If the visibility is set to “FreeBusy”, team members will be able to see that person is busy during that time, but they won’t be able to see the name of the event. Just like action items, if the visibility is set to “Only visible to you”, the event will not appear in the team planner. Visualizing workload and capacity --------------------------------- Huly does not currently offer a Gantt Chart feature or other visualization of workload and capacity. The team planner does provide a way to see how many hours each team member has scheduled for the day, which can be used in combination with time tracking and due dates to understand project allocations and capacity planning. If you’re interested in finding out more about how you can work with Huly’s current implementation to manage your specific workflows, you can chat with other users in our [Slack Community](https://huly.link/slack) to ask questions and exchange ideas. --- # Scheduling action items | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/scheduling-action-items/#_top) Scheduling action items ======================= Scheduling an action item ------------------------- Action items are not particularly useful until they are scheduled. Scheduling an action item indicates to your team that you’ve acknowledged the task you’ve been assigned, and you’ve committed to beginning the work at a specific time in your Planner. To schedule an action item, simply drag and drop it from the “Unplanned” section of your Planner to a specific time slot. You can also click on the action item to open a dialog where you can set the time slot manually. A few important things happen when an action item is scheduled: * The team member responsible for that action item can view the time slot on their own Planner, allowing them to schedule their workday around their tasks. * The scheduled action item will become visible to the rest of the team on the Team Planner, allowing for better coordination and planning. * The issue status will automatically change from “Todo” to “In Progress” when the action item is scheduled. Visibility ---------- By default, the title and time slot of scheduled action items are visible to everyone on the team and can be viewed on the Team Planner. However, it is possible to override this default in the settings for your action item. The following visibility settings can be applied: * Visible to everyone (default) - displays title and time slot on the Team Planner * FreeBusy - displays only the time slot on the Team Planner with the title “Busy” * Only visible to you - does not display on the Team Planner It is recommended to keep action items visible to everyone by default, as this allows for better coordination and planning among team members. Any notes added to action items in the description, however, will _always_ be private to the assignee and will not be visible to the rest of the team. --- # Human resources | Huly Docs [Skip to content](https://docs.huly.io/team-resources/human-resources/#_top) Human resources =============== The human resources module in Huly allows you to manage scheduling and basic time tracking across your departments. This module is still in development, so some features are not yet complete. We welcome any feedback you have as we continue to improve our offerings in this area. For now, continue reading to learn how to get the most out of the human resources module in its current implementation! Setting up departments ---------------------- Departments can be added within your organization by hovering over `DEPARTMENTS` in the left side menu and clicking `Create department`. Enter a name for the department, select a team lead (if applicable), and click `Create`. Hover over any department, open the settings menu and click `Open` to view that department’s details. From here, you can add information to the department, such as external links, file attachments, and description. You can add members, subscribers and managers and change the team lead from this view. > **Note:** A member can also be added to a department from their contact page. You can create as many departments as you like to reflect your organizational structure, including departments nested within other departments. Viewing the HR schedule ----------------------- ![Human resources schedule](https://docs.huly.io/_astro/human-resources._pldoR0j_Zj7Qqm.webp) You can view the HR schedule for the entire organization or for a specific department. The following items can be tracked on the schedule: * Vacation days * Sick days * PTO * PTO/2 * Overtime * Overtime/2 * Remote days By default, the schedule shows all tracked items for the current month next for each team member. Hovering over any block will reveal more details. It is also possible to view the schedule for the entire year by clicking `Year` in the top right corner. This view displays the total items tracked for each team member for each month. Hovering over any block reveals a list of that team member’s tracked items for that month. > **Note:** Huly does not currently offer pre-defined workflows for manual approval of time off requests. This feature allows team members to record their time off and remote work for visibility, rather than being integrated into a formal tracking system. Adding an item to the schedule ------------------------------ To add any of the items listed above, click anywhere in the row next to your name in the month view of the schedule. From here, you can select the kind of item you’d like to add. Enter a description and upload any attachments needed. Select the start and end date as applicable. Click `Create` and notice a block added to the schedule. Viewing the HR table -------------------- Selecting the table view in the top left corner allows you to see reporting for each team member. This view shows totals for vacation days, sick days, PTO, overtime and remote days, as well as calculations based on the number of tasks completed. > **Note:** This early implementation of time tracking in Huly is still in development, so we suggest using this feature as a general guide rather than a precise tracking tool until the functionality is complete. --- # Documents | Huly Docs [Skip to content](https://docs.huly.io/knowledge-management/documents/#_top) Documents ========= There are many uses for documents on the Huly platform, including sharing reference materials among team members, collaborating on plans and roadmaps, saving meeting notes and assigning action items. This guide will walk you through the basics of creating and formatting documents, as well as some of the options available for managing your documents. For more advanced document features, see the following guides: * [Collaborative editing](https://docs.huly.io/knowledge-management/collaborative-editing) * [Action items in documents](https://docs.huly.io/knowledge-management/documents-action-items) > **Note:** In many cases, you may find that using [Cards](https://docs.huly.io/cards/cards-overview) > is a better fit for your needs than using Documents. Cards are designed to be more structured and flexible, allowing you to create custom attributes, relations and tags. If you’re not sure which system is right for you, check out our guide on [Cards vs. Documents](https://docs.huly.io/cards/cards-vs-documents) > . Creating a teamspace -------------------- Documents are organized into teamspaces, which can be used to model your team’s specific needs. For example, you may choose to organize your documents into teamspaces called “Features”, “Marketing”, “Style Guides” etc. To create a teamspace, click the `+` that appears when hovering over the word “Teamspaces” in the sidebar, or by clicking the dropdown arrow next to the `+ Create a document` button and selecting `Create teamspace`. From here, you can enter the following details: * **Space type** - Currently defaults to settings optimal for the Huly platform * **Teamspace title** - A title for your teamspace * **Description** - A description of your teamspace * **Icon** - Choose an icon to represent your teamspace, either from a default icon with a custom color, or an emoji * **Owner** - Select the owner of the teamspace * **Make private** - Toggles whether the teamspace is visible to people outside of the selected members * **Members** - Select which members are a part of this teamspace * **Auto join** - Toggles whether new workspace members will be automatically added as members of this teamspace Click `Create`. Creating a document ------------------- There are two ways to create a document: * Click the `+ Create a document` button at the top of the documents sidebar. This opens a dialog with the option to select a teamspace for your document; the default parent will be the most recently selected teamspace or document. Enter a title for your document and click `Create`. * Hover over a teamspace name or any other document and click the `+` button that appears. The new document will automatically be nested within the teamspace or document you selected. Formatting document content --------------------------- Documents support markdown formatting. There are a few ways to access formatting options for your text: * Type markdown syntax directly into your document. * Use the floating toolbar that appears when text is selected on the page. Formatting options include headers, text emphasis, links, blockquotes, numbered and bulleted lists, and code blocks. Images, tables and separator lines are also available by hovering over text and clicking the `+` icon that appears on the left side. @mentions --------- Mention a team member by using @mention syntax. The member will receive a notification that they have been mentioned in the document. Use `@` to tag any issue or document in Huly. Soon, all objects in Huly will be available to tag anywhere, including Drive files, teamspaces and more - keep an eye out for updates on this feature! ![Document mention](https://docs.huly.io/_astro/documents-mention.Do5EZQkh_jHtT2.webp) Adding notes ------------ To add a note to a document, highlight the text you would like to add the note for and click the `Note` icon in the floating toolbar. Enter the content of your note and choose a color, then click `Set`. Notes will appear as a small icon next to the text you’ve added them to, and can be viewed by anyone with access to the document. ![Adding a note to a document](https://docs.huly.io/_astro/documents-note.Co6tk3Au_189nK8.webp) To edit or delete a note, simply highlight the same text and click the note icon to open the dialog. From there, you can update the content and color of the note, or click `Remove` to delete it. Adding comments --------------- Inline comments are attached to highlighted text in a document, and can be used to discuss specific parts of the document content with your team. To learn more about inline comments, check out [this guide](https://docs.huly.io/communication/inline-comments) . Assigning action items ---------------------- When working on projects together, it may be helpful to assign small action items that aren’t necessarily connected to any particular issue in the Tracker. Check out our guide on [assigning action items in documents](https://docs.huly.io/knowledge-management/documents-action-items) to learn more about this feature! Working with tables ------------------- A table can be insterted into a document (or anywhere tables are supported) by typing `/` and selecting `Table`. This will open a dialog where you can specify the number of rows and columns for your table. To view options for table formatting, click on the ‘Customize table’ icon in the floating toolbar at the top right corner of the table. Here, you’ll find options to add and delete rows and columns, merge and split cells, and delete the entire table. Also in the floating toolbar is the ‘Set cell color’ icon. Here, you can set a background color for specific table cells. The colors dynamically adapt to dark and light mode interfaces. You can also resize columns by clicking and dragging the lines between them. ![Options for formatting tables](https://docs.huly.io/_astro/table-formatting.8QSDlQCc_ZNVtyB.webp) Viewing backlinks ----------------- To view everywhere a document has been mentioned, click the paper clip icon in the top right corner. This will open a side panel showing everywhere an @mention has been used to link to that document. Backlinks will also appear in the Activity section at the bottom of the document. Download and print as PDF ------------------------- Documents can be downloaded and printed as PDFs. This feature is useful for creating files to share with clients and other external contacts outside your workspace. To generate a PDF of a document, click the `...` settings menu and select `Print to PDF`. It may take a few seconds to load the PDF preview. From the preview window, you can choose to download or print the document. > **Note:** Your document title and icon will be visible on the PDF version. --- # Action items in documents | Huly Docs [Skip to content](https://docs.huly.io/knowledge-management/documents-action-items/#_top) Action items in documents ========================= Sometimes, you may wish to create action items for team members directly within a document, without attaching it to any particular issue in the Tracker. This can be helpful for small tasks that don’t require a full issue, reminders, or other matters that need to be taken care of that aren’t specificially related to a project or issue. Creating action items --------------------- There are a few ways to create action items directly in documents: * **Keyboard shortcut** - Type `[]` then `space` on a new line. An empty checkbox will appear. * **Floating toolbar** - Hover over text and click the `+` icon that appears on the left side. Select the checkbox icon to create a new action item. * **Slash command** - Type `/` to open a dropdown menu of options. Select the checkbox icon to create a new action item. Assigning action items ---------------------- After an action item has been created using any of the methods above, you can assign it to a team member. Notice a gray profile icon that appears to the left of the checkbox. Click this icon to select a team member to assign the task to. ![Assigning an action item in a document](https://docs.huly.io/_astro/documents-assignee.BL2CdTup_ZDrzOb.webp) When an action item is assigned to a team member within a document, that person will receive a notification that they have been assigned an action item, and they’ll be able to schedule the task in their Planner. --- # Mermaid diagrams | Huly Docs [Skip to content](https://docs.huly.io/knowledge-management/mermaid-diagrams/#_top) Mermaid diagrams ================ Huly supports the creation of diagrams using MermaidJS, a simple markdown-like language for generating diagrams and flowcharts. For specific syntax and examples of different kinds of diagrams you can create, see the [MermaidJS documentation](https://mermaid.js.org/intro/) . ![Diagram created with MermaidJS](https://docs.huly.io/_astro/documents-mermaid.bFadNr3M_Z1P4yXa.webp) Creating a diagram ------------------ To create a diagram in a document, type `/` and select `Diagram`. This will open a dialog where you can enter your MermaidJS code. When valid MermaidJS code is entered, the diagram will automatically render in the space below. Collapsing the code editor will leave only the diagram visible on the page. Editing a diagram ----------------- To edit a diagram after it’s been created, click the diagram to open the editor. This will allow you to make changes to the MermaidJS code, and you’ll see the results in real time. > **Note:** Clicking on a diagram and pressing the delete key will remove the diagram from the document. --- # Templates | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/templates/#_top) Templates ========= Templates are reusable document structures that can be used to create new documents quickly and consistently. You can create templates for Controlled Documents to ensure that your team follows the same format for each document type. Creating a template ------------------- Templates can be created either by opening the dropdown menu beside the `New document` button and selecting `New template`, or by clicking the `+ Template` button in the Templates section of the Controlled Documents module. Alternatively, a template can be created in a specific document space by opening the settings menu and selecting `Create new template`. It’s also possible to create templates as children of existing documents; to do this, open the settings menu for any document and select `Create child template`. In the template creation dialog, you’ll be guided through the following steps to create your template: **Step 1:** Select a space and parent for your template. The space defines the roles and permissions that will apply; the parent simply determines where the template will be stored. A template can be the direct child of the space itself (at the top level of the space), or it can be a child of a document within that space. ![Step 1 for creating a new template](https://docs.huly.io/_astro/new-template-1.Bnd4hdRJ_Z1xOrN.webp) **Step 2:** Provide details for your template, including a title, description and prefix, a category, and reason. Customizing the template code is also possible, but it’s recommended to use the default settings to maintain consistent incremental numbering of templates. ![Step 2 for creating a new template](https://docs.huly.io/_astro/new-template-2.DMznHFz0_Z1S62l4.webp) **Step 3:** Select team members that will be working on documents using this template, including Co-Authors, Reviewers and Approvers. ![Step 3 for creating a new template](https://docs.huly.io/_astro/new-template-3.DaRVi-GT_Z2rWC3y.webp) After proceeding through the above steps, click `Create Draft`. Adding notes ------------ With the text editor, you can select the note symbol to add guidance that will help users understand what information to include in a defined section. ![Viewing a note for a template section](https://docs.huly.io/_astro/templates-note.CWgYBD4O_Z1PNPaR.webp) Document categories ------------------- To create a new document category, select the dropdown menu next to the `+ New document` button and click `New category`. ![Create a new document category](https://docs.huly.io/_astro/new-document-category.0vrU7HtH_1QXOUm.webp) Categories can be used to group related documents together. Categories are fully configurable and can represent departments in your company or key topics. In this example, the category `Quality Manual` is being used when creating a new template: ![Using a document category when creating a template](https://docs.huly.io/_astro/use-document-category.pljsQ2NI_Z1fCXwt.webp) --- # Additional document settings | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/document-settings/#_top) Additional document settings ============================ Settings within documents ------------------------- There are several settings available for Controlled Documents, found in the navigational tabs at the top of the document as well as in the right side panel. These settings are the same for all types of Controlled Documents, including templates, quality documents and technical documentation. * **Reason & Impact:** Under the `Reason & Impact` tab, you can provide information on changes. This section is used to explain why the document was created or changed, and what impact it will have. The `Description` and `Reason` fields will be automatically populated in the `History` section of the document. * **Team:** Under the `Team` tab, you can add or remove team members as Co-Authors, Reviewers, and Approvers. * **Release details:** Under the `Release` tab, you can provide information on the release of the document, including the severity of the release (decimal change for minor updates; whole number change for major updates), and the effective date. * **Trainings:** Also under the `Release` tab is the option to add a training. * **History:** Under the `History` tab, you can view a log of changes made to the document, including the date and description of each change. Creating subfolders ------------------- Documents are organized into spaces by default, but you can further organize documents into subfolders within each space. To create a subfolder, hover over the space in the left side menu and click the `...` icon, then select `Create new folder`. Enter a name for your folder and click `Create`. To move a document into a folder, simply drag and drop it onto the folder. Folders can also contain their own subfolders, allowing you to create your own hierarchy of documents. Relocating and reordering documents and folders ----------------------------------------------- Controlled Documents and folders can be relocated and reordered within their current space, or transferred to a different space with some additional configurations. To move a Controlled Document within the same space, simply drag and drop them in the left side panel. To nest a document within another, drag and drop it over the new parent document. To transfer a document to a different space, click on the settings menu next to the document in the left side panel and select `Transfer`. ![Transferring a Controlled Document](https://docs.huly.io/_astro/controlled-doc-transfer.Dm4OtgEd_1lCq4D.webp) Next, select a space to transfer to, as well as the parent object for your document (if applicable). Click `Transfer` again to transfer the document. > **Note:** Some team members may lose the ability to view or edit the document after transferring it, depending on the permissions settings for the destination space. Documents can only be moved if they’re created in the current product version. Additionally, the user making the transfer must have archive rights in the source space and document creation rights in the destination space. --- # Ownership vs. authorship | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/ownership-authorship/#_top) Ownership vs. authorship ======================== A Controlled Document `Author` is the one who creates and signs the document, who will be listed on the PDF at export. The `Owner`, on the other hand, is the person who is responsible for drafting and managing the document throughout its lifecycle. In most cases, the same user will act as both the `Author` and the `Owner` of a document, but there may be times at which you need to transfer ownership to someone else. The `Owner` can be changed from the `...` menu in the top right corner, or by selecting the current owner’s name in the right side panel and clicking `Select new owner`. --- # Inbox | Huly Docs [Skip to content](https://docs.huly.io/communication/inbox/#_top) Inbox ===== Access your inbox by clicking on the bell icon in the left sidebar. A red dot at the corner of the bell icon indicates unread notifications. Several kinds of notifications can be found in your inbox, and you can sort these notificiations by selecting from the following categories in the top menu: * **All** - all messages and notifications * **Issues** - notifications for tasks related to you * **Documents** - notifications for changes related to your documents and documents you’ve been mentioned in * **Direct messages** - messages sent directly (not in channels) * **Messages** - all messages, including comments on issues, files and other workspace objects Hover over any message in your inbox for the following options: * **Reactions** - reply to a message with an emoji * **Save for later** - save a message (adds the message to your saved messages in the chat view) * **Pin** - pins the message to the top of the chat * **Reply to thread** - reply to the message in a thread Hovering over a chat message will allow you to peek at the message without marking it as “Read” in your inbox. ![Create issue](https://docs.huly.io/_astro/inbox-peek.CHZmk8-j_ZU9O9Q.webp) Organizing your inbox --------------------- Selecting the settings icon on the top right of the inbox sidebar opens a dialog for toggling `Unreads` and `Archived`, allowing you to filter messages in your inbox by only unread or archived messages. The next icon with the three dots opens a dialog for bulk actions, allowing you to mark all messages as read or unread, or archive all of your messages. You can also click the circular checkbox next to any message to archive it. Additionally, you can click the three vertical dots to open a dialog with options to mark it as unread, archive it or unsubscribe from notifications about that thread, document or issue. --- # Inline comments | Huly Docs [Skip to content](https://docs.huly.io/communication/inline-comments/#_top) Inline comments =============== Inline comments offer a way to add notes, feedback or questions to specific parts of documents, issue descriptions, or anywhere else the comment icon is available in the toolbar. Inline comments are different from comments found in the Activity section at the bottom of a document, issue or other Huly object. These are the key differences: * **Purpose:** Comments in the Activity section are more useful when adding notes or feedback to the document or object as a whole. Inline comments are more useful when you need to point to a specific word, phrase or section of content. * **Chat integration:** Comments in the Activity section are also linked to Chat, Inbox and other parts of the platform. Inline comments are not linked to any other part of the workspace. * **Permanence:** Comments in the Activity section are better suited for discussions that you’ll want to hang on to, because they’re usually part of the activity surrounding the object they’re attached to. Inline comments are better for quick notes, feedback or questions, which can be deleted completely once they’re resolved. Adding inline comments ---------------------- To add an inline comment, highlight any text and click the comment icon in the floating toolbar (it looks like a speech bubble). Enter your comment and submit. To reply to a comment, simply enter your reply and submit. Your comment will be added to the thread. > **Note:** At this time, inline comments are not linked to system notifications. Check back for updates as this feature continues to be developed. Viewing inline comments ----------------------- Text that has an associated comment will appear highlighted on the page. #### Documents ![Inline comments alongside document content](https://docs.huly.io/_astro/inline-comments-document.B9yvXRGn_1onDEi.webp) The appearance of inline comments depends on the window size. When the window is wide enough, you’ll see all of the comments on a document on the right side of the page. When the window is narrower, you’ll need to click on the highlighted text to see the associated comments. #### Issue descriptions ![Inline comment on issue description](https://docs.huly.io/_astro/inline-comments-issue.CDhEnDI__pMHoV.webp) To view inline comments on issue descriptions, click on the highlighted text. Resolving inline comments ------------------------- To resolve a comment thread, hover over the parent comment (at the top of the thread) and click the checkmark icon. > **Note:** Resolving a comment will permanently delete all comments in the thread. Editing and deleting inline comments ------------------------------------ To edit or delete your own comment, hover over the comment and click on the breadcrumb menu. Then, select `Edit` or `Delete`. --- # Drawing board | Huly Docs [Skip to content](https://docs.huly.io/knowledge-management/drawing-board/#_top) Drawing board ============= When collaborating on an idea, we often find ourselves reaching for a pen and paper to sketch out our thoughts. With drawing boards in Huly, you can sketch together live with teammates, making it easy to brainstorm, plan, and visualize ideas while saving everything to your workspace. Creating a drawing board ------------------------ To create a new drawing board in a document or issue description, simply type `/` or click the `+` to the left of the document and select “Drawing board” from the list of options. At the top of the drawing board, you’ll see a toolbar with the following options (from left to right): * **Trash can** - Clear the contents of the drawing board (this action cannot be undone). * **Pen** - Select the pen tool to draw on the board. * **Eraser** - Select the eraser tool to erase parts of the drawing. * **Move** - Click and drag to move around the drawing board. * **Letter** - Add a text box. * **Size slider** - Adjust the size of the pen or eraser. * **Color picker** - Select a color for the pen or eraser. * **Settings menu** - Add or remove colors from your palette, or reset colors to default settings. At the top right corner, you’ll see a button to open your drawing board in full-screen mode, giving you even more space to sketch. ![Example of the drawing board embedded in a document](https://docs.huly.io/_astro/drawing-board.CdJmKkiG_2mufm0.webp) > **Note:** Anyone viewing the document can collaborate on the drawing board in real time. To build other kinds of flow charts, diagrams and graphs, check out our guide on [diagrams](https://docs.huly.io/knowledge-management/mermaid-diagrams) , which leverage MermaidJS syntax to build a variety of visualizations. Scribble on images ------------------ With Huly’s drawing tool, you can create any shared image into a drawing board using the scribbles feature. Open any image that’s been shared in a message and click the scribble icon (labeled `Scribble over`). The image will become a drawing board, allowing anyone viewing the image to draw on it. All of the same tools are available for images as they are for drawing boards. Scribbling on images is an excellent way to provide feedback, add notes, or brainstorm ideas on shared resources. After some scribbles have been added to the image, you’ll see a clock icon appear next to the scribble icon (labeled `Scribble history`). Click this to see a history of all the scribbles that have been added to the image, including who added which scribbles. ![Scribbles and scribble history on an image](https://docs.huly.io/_astro/scribble.REpYPXkf_Z1G8XtR.webp) --- # Notifications | Huly Docs [Skip to content](https://docs.huly.io/communication/notifications/#_top) Notifications ============= Access your notification settings by clicking your profile icon in the bottom left corner and selecting `Settings`. From the settings menu, select `Notifications`. Sound and appearance -------------------- At the top of the settings menu, select `Sound and appearance` to set some global settings for notifications. Here, you can toggle notification sound, icon bounce and badge, or turn off all notifications entirely. ![Create issue](https://docs.huly.io/_astro/settings-notifications.C8s04_1m_Z1DxW8a.webp) Notification settings --------------------- For more granular control over the kinds of notifications you’ll receive, select a space or object from the list in the left sidebar. There, you can select which kinds of updates you’d like to receive notifications for, as well as how you’d like to receive them — in your Huly inbox, by email, and/or push. --- # Live transcription | Huly Docs [Skip to content](https://docs.huly.io/communication/live-transcription/#_top) Live transcription ================== Meet Hulia, Huly’s first AI assistant! Hulia transcribes meetings in real-time, saved as a chat correspondence in which you can react, reply, and bookmark messages as you would in any other chat. ![Preview of Hulia live transcription](https://docs.huly.io/_astro/hulia-live-transcription.JIcSiCwQ_ZCnQsF.webp) Live transcription is the starting point for an exciting future for Hulia, who will be able to perform many tasks throughout your workspace to help you work more efficiently. Live transcription ------------------ When a meeting begins, you’ll notice that meeting participants appear in the right side panel while the live transcription appears on the main screen in the `Activity` section. You’ll be able to see your transcription appear in real time during the meeting. Select the language for transcription in the bottom left corner of the meeting menu. If you navigate away during the meeting to another part of your workspace, you can still access your live transcription by clicking on the video icon in the right side menu and selecting the `Transcription` tab. ![Labeled image indicating settings for live transcription](https://docs.huly.io/_astro/hulia-live-transcription-guide.CrMELgXp_ZSo0iQ.webp) Disabling live transcription ---------------------------- Live transcription can either be disabled by default for the entire meeting room, or can be disabled for a specific meeting during the call. To disable the default live transcription for a meeting room, open the room and navigate to `Settings`. Here, you can toggle the default transcription setting on or off. When transcription is enabled during a meeting, you’ll see the quill icon in the bottom menu of your meeting appears red. To disable transcription for a meeting, click the quill icon at the bottom menu (labeled `Stop transcription`). > **Note**: Meetings are also recorded by default, and this can be disabled in the same way as transcription — either in the meeting room settings, or for a specific meeting. To disable recording during a meeting, click the recording icon in the bottom menu (labeled `Stop recording`). The icon will appear red if the meeting is being recorded. Viewing past transcriptions --------------------------- You can see any previously saved transcriptions by navigating to your virtual office and selecting the `Meeting minutes` icon in the top left corner. Here, you’ll see a list of all of the transcriptions from your previous meetings. You can also delete transcriptions that you don’t want saved in your workspace. ![List of past transcriptions](https://docs.huly.io/_astro/hulia-live-transcription-view-all.L6QuYfR9_CCjSs.webp) You can also view the transcriptions for a specific room. Click on any meeting room in the office and find the transcription in the `Meeting minutes` secton. Privacy ------- During this early stage of development of this feature, live transcriptions are visible to everyone in the workspace. The best way to keep meetings private is to disable transcription (and recording) at the beginning of your meeting, or for the entire meeting room. We are planning to introduce chat security settings, which will most likely begin with settings to control access to virtual office rooms, making transcriptions private to only those with permission to view them. In the near future, we plan to implement end-to-end encryption, which will also enhance security. In the meantime, you can understand how Huly uses your data in our [Privacy Policy](https://huly.io/legal/privacy) . Please feel free to reach out to our team if further clarification is needed. What’s next for Hulia? ---------------------- Live transcriptions are just the beginning for Hulia. At this point, live transcription may not be useful for everyone on Huly; however, soon Hulia will be able to not only transcribe meetings but also summarize main points, create action items and documents based on your meetings, help schedule follow-ups and more. Ultimately, Hulia will be aware of all workspace activity that she’s given permission to see, and thus she will be able to assist in any number of ways that eliminate redundancies, reduce human error and automate tedious tasks to help you work more productively. Stay tuned for more updates as Hulia continues to evolve! --- # GitHub | Huly Docs [Skip to content](https://docs.huly.io/integrations/github/#_top) GitHub ====== Huly integrates with GitHub, allowing for two-way synchronization between the two platforms. This is a great option for teams working with one or more GitHub repositories, allowing them to sync issues and changes while utilizing Huly’s other features for scheduling, planning and collaboration. Integrating a GitHub account ---------------------------- Click on your user profile icon at the bottom of the left sidebar and select `Integrations`. Below “GitHub integration”, click `Add`. Click `Authorize Huly GitHub App`. When prompted, click `Authorize Huly GitHub App` again and if needed, enter your login information for your GitHub account. You will be brought back to Huly, where you can see your GitHub information in the GitHub integration window. Mapping GitHub repositories --------------------------- To connect a GitHub repository to Huly, select `Mapped GitHub Repositories` on the Github integration window. Click `Install GitHub App`. On the next screen, select a location to install Huly GitHub. You may be prompted to enter your GitHub login information. Select which repositories you would like Huly GitHub to have access to. Your selected repository will now display in the `Mapped GitHub Repositories` tab. Use the dropdown `Connect to Huly` to select which Project you’d like to add your repository to. Alternatively, you can create a new Project to sync with your repository. Your repository can be disconnected at any time by clicking the `Disconnect` button. How Huly interacts with GitHub ------------------------------ You can use the Huly platform to interact with your GitHub repository in a number of ways, including: * **Creating and syncing issues** - Issues created within the project linked to your GitHub will by default create a matching issue in your repository (this can be overridden by selecting `Create issue without GitHub`). When multiple repositories are connected, you can select which one to create the issue in using the `Create issue in` dropdown menu. Similarly, when you create a new issue on GitHub, it will appear on the Huly platform as well. Once an issue has been created in your GitHub repository, you can find the direct link to it in the Activity section for that issue on Huly. * **Pull requests** - Pull requests from GitHub automatically appear in the pull requests tab, available within your Project in the Tracker Sidebar. * **Comments** - Commenting on an issue connected with a GitHub repository using the Huly interface will also automatically create a comment on the corresponding issue in GitHub. Likewise, any comment added to an issue on GitHub will appear on that Issue in the Huly platform. Dive deeper with our video tutorial ----------------------------------- Check out our tutorial on GitHub integration for a step-by-step guide on connecting your repository to a Huly project and syncing issues and pull requests. --- # Google Calendar | Huly Docs [Skip to content](https://docs.huly.io/integrations/google-calendar/#_top) Google Calendar =============== Huly integrates with Google Calendar for two-way synchronization of event and task scheduling, helping you keep track of all of your tasks and events in one place. Syncing your Google Calendar with Huly -------------------------------------- To sync your Google Calendar with Huly: * Click on your user profile icon at the bottom of the left sidebar. * Select `Integrations`. * Below “Calendar”, click `Add`. * Click `Connect`. * Select the account you would like to connect and click `Continue`. * On the next screen, check the box that says `Select all` to provide Huly with the necessary permissions to connect with Google Calendar. * Click `Continue`. Configuring your calendars -------------------------- On the Integrations view, click `Configure` under Calendar. Here, you can toggle which calendars you’d like to sync with Huly. Viewing and creating events --------------------------- After syncing Huly with your Google Calendar, all events from your Google Calendar will be visible on your Huly Planner. Events that were created in your Huly Planner before syncing will not automatically appear in your Google Calendar. In order to add an event from Huly to your Google Calendar (whether creating a new event or editing an existing one), select which calendar you’d like to add it to on the event details dialog and click `Save` to save your settings. When you create a new event in your Google Calendar, it will appear automatically in your Huly Planner. See below for more on event visibility. Privacy and visibility ---------------------- Privacy settings for events are also synchronized between your Huly Planner. This means that events on your Google Calendar with visibility set to “Public” will also appear in your Huly Planner as “Visible to everyone”. The following visibility settings are available for events: * **Visible to everyone** - displays title and time slot on the Team Planner; appears as “Public” in Google Calendar * **FreeBusy** - displays only the time slot on the Team Planner with the title “Busy” * **Only visible to you** - does not display on the Team Planner; appears as “Private” in Google Calendar Disconnecting a calendar ------------------------ You can disconnect a Google Calendar at any time. Currently, Google Calendar events that have been synced with Huly will not be removed from your Huly Planner when you disconnect the calendar. If you would like to remove these events, you can connect the integration, switch off the calendar in the integration settings (which disables the sync), and then disconnect the integration again. --- # Technical documentation | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/technical-documentation/#_top) Technical documentation ======================= Technical documentation is part of the Controlled Documents module and is used for managing product development records, such as test reports and requirement documents. Creating a technical document ----------------------------- To create a new technical document, open the settings menu next to any product space within the `TECHNICAL DOCUMENTATION` submenu in the left sidebar and select `Create new document`. You can also click the `+ New document` button in the Controlled Documents module. > **Note:** A new technical document can also be created as a child of any existing document. Proceed through the following steps to create the document: **Step 1:** Select a space and parent for your document. The space defines the roles and permissions that will apply; the parent simply determines where the document will be stored. A document can be the direct child of the space itself (at the top level of the space), or it can be a child of a document within that space. ![Step 1 for creating a new technical document](https://docs.huly.io/_astro/new-technical-doc-1.D8VUtOlc_Z2sC8lu.webp) **Step 2:** Select a template for your document. See our guide on [templates](https://docs.huly.io/controlled-documents/templates) for more information about how to create reusable templates for Controlled Documents. ![Step 2 for creating a new technical document](https://docs.huly.io/_astro/new-technical-doc-2.Czwel9TB_n0YlX.webp) **Step 3:** Provide details for your document, including a title, description, and reason for creation. ![Step 3 for creating a new technical document](https://docs.huly.io/_astro/new-technical-doc-3.BM9VWzIF_Z1f5Jmy.webp) **Step 4:** Select team members that will be working on the document, including Co-Authors, Reviewers, and Approvers. ![Step 4 for creating a new technical document](https://docs.huly.io/_astro/new-technical-doc-4.BImdQ-Cw_Z2jHC5W.webp) After proceeding through the above steps, click `Create Draft`. --- # Activity tracking in chat | Huly Docs [Skip to content](https://docs.huly.io/communication/chat-activity/#_top) Activity tracking in chat ========================= In Huly Chat, your team can communicate through direct messaging and group chat channels and collaborate on projects and resources. This guide covers how to view and track workspace activity within chat, including documents, issues, pull requests and other workspace objects. For more on sending chat messages through channels and DMs, see our guide on [sending messages](https://docs.huly.io/communication/sending-messages) . Viewing workspace activity in chat ---------------------------------- Documents, issues and other workspace objects appear in Chat for all associated team members, so members can see updates, discuss details and make decisions alongside the rest of their chat conversations. In the left sidebar of your chat, you’ll find sections labeled `Documents`, `Issues`, and any other task types you’ve created. These sections will display all of the associated objects that you’ve either created, been assigned, or been mentioned in. Outside of Chat, you’ll notice that many objects in Huly (like issues and documents) have an Activity section where you can have discussions through comments. Comments that are added here in the Activity section will also appear in the chat associated with that object. ### Filtering activity After opening a workspace object in Chat, use the filter button in the top right corner to filter for the specific activity you want to see. For example, you can filter to only see comments to create a chat-like view of all of the discussion related to that object. Or, filter by attributes to only see changes to the object details without comments. ### Viewing object details Open the right sidebar to view the details of the object you’re viewing. This provides a quick overview of the object’s status, assignee, due date and other relevant details without leaving the chat view. From here, you can click the expand icon to open a full view of the object. ### Syncing with GitHub If you’ve connected a project to GitHub, you’ll see a special `Pull Requests` section in your chat sidebar. This section will display all of the pull requests associated with your project, and you can open any pull request to see the activity history and comments. Just like comments and activity on the task itself, anything added here in the chat will sync with GitHub. Mentioning Huly objects in Chat ------------------------------- When you use the `@` symbol to mention an object in a Huly chat channel or DM, your message will automatically appear in the Activity section of that object. These mentioned issues will only be visible to the members of the chat channel or DM, and will not be visible to other members of the workspace. For example, if you and a colleague have a private chat about an issue in your DMs, you’ll see the messages that include the `@` tag in the Activity section of that issue, but other members of the workspace will won’t be able to see it. --- # Employees | Huly Docs [Skip to content](https://docs.huly.io/people-contacts/employees/#_top) Employees ========= The term “employees” in Huly does not necessarily imply a formal employment relationship — it is simply used to refer to members of your workspace. In your Contacts list, an “employee” is different from a “person”, which refers to an external contact. Adding employees ---------------- When someone is invited to your workspace using an invite link, they will automatically be added as an employee in your Contacts when they join. You can also add an employee by clicking the `+ Employee` button in the top right corner of the Contacts page. Enter the employee’s name and email address and click `Create`. This not only creates a contact for them as an employee, but also generates an invite link which will be sent to their email. They will only be able to sign up for your workspace with the email address you entered when you created their contact. Merging contacts ---------------- In some cases, you may have a contact in your workspace who becomes an employee when they join your workspace. In this case, you can merge their “person” and “employee” contacts to avoid duplication. Open the settings menu and select `Merge contacts`, then select the contacts you would like to merge. GitHub collaborators -------------------- If you’ve linked a GitHub repository to your Huly workspace (see our guide on [GitHub integration](https://docs.huly.io/integrations/github) ), you’ll find that your GitHub collaborators have automatically been added to your Contacts as “persons”. Even though these contacts have been added to your Contacts, they will not be able to access your workspace unless they’ve been invited as employees. Kicking employees ----------------- To kick an employee out of your workspace, right-click on their employee contact and select `Kick employee`. This cannot be undone. Kicking an employee will revoke their access to your workspace and mark them as inactive in your Contacts. > **Note:** Kicked employees will remain visible in your workspace, even after their access has been revoked. This is by design, as their employee account may still be linked to objects in the workspace, and you may need to re-invite an employee who was kicked by mistake. If you have no intention of restoring a kicked employee’s access, you may choose to remove their contact information from their profile and replace the account name with “Inactive User”. Re-inviting kicked employees ---------------------------- To re-invite an employee that has been kicked from the workspace, navigate to Contacts and right-click on the empoloyee’s contact. Select `Resend Invite` from the dropdown menu. --- # Applying Tags to Cards | Huly Docs [Skip to content](https://docs.huly.io/cards/tags/applying-tags/#_top) Applying Tags to Cards ====================== Now that we’ve learned about [Tags](https://docs.huly.io/cards/tags/tags-overview) and how to [create](https://docs.huly.io/cards/tags/creating-tags) them, let’s explore how to apply them to our Cards. First, you’ll need to create a Card from a Type that has Tags. If you haven’t already, check out our guides on [creating Cards](https://docs.huly.io/cards/creating-cards) . Adding a Tag to a Card ---------------------- To add a Tag to a Card, click the `+` icon beside the Type. You’ll be able to select from any Tags that have been created for that Type. ![Adding a Tag to a Card](https://docs.huly.io/_astro/tags.BN3SOe25_15J4M3.webp) For our **game design** example, we’re applying the `Flying` and `Wizard` Tags to an `Enemy` Card (derived from `Game Component` / `Character` / `Enemy` Types). These Tags provide additional properties that define how the character interacts with the game. Removing a Tag from a Card -------------------------- To remove a Tag from a Card, simply click the `x` icon beside the Tag name. This will remove the Tag and all its associated properties from the Card. --- # Gmail | Huly Docs [Skip to content](https://docs.huly.io/integrations/gmail/#_top) Gmail ===== Huly provides an optional integration with Gmail, allowing you to connect to a Gmail account to send and receive emails without ever leaving the platform. The current version of Gmail integration offers the following features: * Send emails to contacts from Huly * Receive and reply to emails from contacts in Huly Currently, emails are accessible through the contact page, but a future version will include a centralized email inbox where you can manage emails from multiple accounts in one place. You’ll also be able to easily convert email threads into shared notes, tasks and more. This guide covers the features included in the current version, but keep an eye out for more updates soon! Connect to Gmail ---------------- To connect with Gmail, navigate to Settings > Integrations. Under `Gmail`, click `Add` and select the Gmail account you want to connect. Follow the prompts to authorize Huly to access your Gmail account. Sending emails -------------- Navigate to the contact page of the recipient and find the mail icon below their name. If you haven’t entered an email for the contact yet, you can do this by clicking `Add social links`. Hover over the mail icon, then click the arrow icon to open the email window. If you’ve just connected to Gmail for the first time, you may see the window begin to populate with your email history with that contact, as the Gmail integration imports your past emails. This process should only take a few seconds, but may take longer depending on the number of emails that are imported. To send a new email, click `Create message`. Enter a subject, optional CC email address, and message. Note that you can also add attachments if needed. Then, click `Send`. Receiving and replying to emails -------------------------------- When you’ve received an email from a contact, it will appear in the same email window that you opened for sending emails. We are working on improving the notifications for emails and will soon move emails to a centralized inbox, but for now you’ll be able to find them only through the contact page. To reply to an email, click the `Reply` button in the top right corner. You can edit the subject and message as needed, and then click `Send` to send your reply. --- # Test management | Huly Docs [Skip to content](https://docs.huly.io/additional-modules/test-management/#_top) Test management =============== Huly’s test management module enables you to efficiently create, organize, and run tests within your workspace. With this module, you can track test statuses, view results, link tests to issues in the Tracker, and generate work tickets for assignees. Setting up tests ---------------- Click the `+` button in the left sidebar to start a new test project. For now, test projects are isolated within the test management module; however, there are plans to connect test management with other workspace projects in the near future. ### Creating a test suite Open the dropdown menu in the top left corner and select `Create test suite`. Provide a name and an optional description for your test suite. ### Creating a test case Within your test suite, add test cases by clicking `+ New test case`. Enter a name and optional description for your test case. Select a status (e.g., Ready, In Progress), and attach any relevant files or images. Then, click `Create`. ### Running tests Use the checkboxes next to each test case to choose which ones to include in the test run. Then, click `Run`. Provide a title and description for your test run. Your test run can include details such as environment setup, execution instructions, and expected results. ![Dialog to enter details for new test run](https://docs.huly.io/_astro/test-management-new-test-run.DTftIiua_Z13SpIk.webp) Once the test has been run, you can change the status from `Untested` to `Passed`, `Failed` or `Blocked`, and add an assignee to review. ![Example test run result](https://docs.huly.io/_astro/test-management-test-run-result.D_WDXPJA_ZX3KEf.webp) You’ll also see an Activity section where you can have discussions, link to isses and documents, and add attachments. --- # Surveys | Huly Docs [Skip to content](https://docs.huly.io/additional-modules/surveys/#_top) Surveys ======= Surveys are new to Huly and still in experimental development. In the future, you’ll be able to use surveys for many purposes, such as gathering feedback from team members and creating trainings and onboarding processes. There may be many more use cases for surveys in Huly, and we welcome any ideas or input you have at this early stage. For now, surveys can be used for: * Brainstorming ideas for surveys you might use in the future * Drafting survey questions to share with your team for feedback * Discussing drafts of surveys using the Activity section below the survey Below is an example of a survey in preview mode: ![Surveys module](https://docs.huly.io/_astro/surveys.p_eFbT00_Z2g0A0X.webp) Creating a survey ----------------- Select `Survey Forms` in the left side menu of the Survey module, then click the `+ Survey` button in the top right corner. Enter a title for your survey an click `Create`. After opening your survey, you can optionally add a description below the title. Adding questions ---------------- Begin by typing a question in the Questions area and press Enter. From here, you can select the type of question you want to add: * Simple answer (text field) * Select an option (single-select radio buttons) * Select several options (multi-select checkboxes) You can also set whether the field will be mandatory, and if you want to allow for a write-in custom option (only available for single-select and multi-select questions). In the current implementation, it is not yet possible to indicate correct and incorrect answers, but this will be added in a future version. Previewing the survey --------------------- Click the `Preview` button in the top right corner to see how your survey would look. For now, there is no option to share surveys directly; however, you may choose to send a link to team members and have discussions in the Activity section below the survey. * * * As you explore, feel free to share your feedback with us to help shape the direction of this feature for future development! The best way to get in touch with us is through our [Slack community](https://huly.link/slack) . --- # Leads | Huly Docs [Skip to content](https://docs.huly.io/additional-modules/leads/#_top) Leads ===== The Leads module in Huly is nearly deprecated and is disabled by default for new workspaces. We’re planning to introduce a more powerful, fully featured CRM module soon, and in the meantime, we strongly recommend waiting for the new module to take advantage of its enhanced capabilities. We do not have a specific timeframe for the release of the new module, but welcome any input at this early stage from users who would be interested in using these features in the future. If you’re curious and would like to explore the existing Leads module, we can enable it manually for your workspace — just reach out to our support team via [Slack](https://huly.link/slack) . **Note:** While you’re welcome to explore the Leads module as-is, please be aware that because the module will be deprecated, issues or bug reports related to it won’t be prioritized over other areas of Huly, and fixes and improvements are not guaranteed. With that in mind, please feel free to share any feedback you have for us to consider in planning our new CRM module. Setting up funnels ------------------ Funnels can be used to track the progress of leads through a series of stages. To set up a basic funnel with preset stages, navigate to the Leads module in the left sidebar and click `Funnels` in the left sidebar. Click `+ Funnel` to create a new funnel. Here, you can enter a name for the funnel, toggle privacy settings, and select owners and members who should have access to the space. Then, click `Create`. By default, funnels will have the following stages: `Backlog`, `Incoming`, `Negotiation`, `Offer preparing`, `Make a decisison` and `Contract conclusion`. You can edit these stages or create new ones in Settings. Customizing funnel stages ------------------------- Navigate to Settings and find `Default funnel` in the `SPACE TYPES` menu in the left sidebar. At the bottom, you’ll see an area labeled `TASK TYPES`. Click on `Lead`. From here, you can edit, add or remove stages. ![Settings for funnels](https://docs.huly.io/_astro/leads-funnel-settings.ByonERNP_Z1JH1FU.webp) To create an entirely new set of stages (useful when managing different kinds of funnels), click the `+` button next to `SPACE TYPES` and select `Leads` from the dropdown menu. Enter a name for your funnel space type and click `Create`. You can then edit the stages in the same way as above. > **Note:** To learn more about creating and managing spaces, check out our guide on [space types](https://docs.huly.io/advanced-settings/space-types) > . To use your custom funnel stages, select your funnel space type from the `Project type` dropdown menu when creating your funnel. ![Creating a new funnel](https://docs.huly.io/_astro/leads-new-funnel.bJDeaU2p_1148Ek.webp) Creating and managing leads --------------------------- To create a lead, navigate to the Leads module in the left sidebar and click `+ Lead` in the upper right corner. Enter a name for the lead and select a customer. “Customers” are anyone in your workspace contacts — this could be a company, person, or even an internal workspace member. If you do not already have a contact for your lead, you can create one by clicking the `+` button on the dropdown menu. Optionally enter a title (short description or label) and assignee, and select a stage for the lead. Then, click `Create`. On the page for your lead, you’ll see several additional options, including due date, labels, attachments, related issues, and activity. This is where you can keep all information and discussions related to that lead. Adding a related issue is a great way to keep track of tasks related to your lead, such as follow-up calls, drafting proposals, and negotiations. As a lead progresses through the funnel, simply update the status (stage) of the lead from the lead page itself, or by clicking the lead status in the list view. Just like issues in your tracker, leads can be filtered, grouped and sorted by stage and assignee, and can be viewed in list, kanban, or dashboard views. ![Leads list view](https://docs.huly.io/_astro/leads.Cf1GtVIv_9qYt.webp) Creating and managing customers ------------------------------- As mentioned above, “Customers” are anyone in your workspace contacts — this could be a company, person, or even an internal workspace member. You can access these contacts easily right from the Leads module by clicking `Customers` in the left sidebar. In this view, you can preview the leads associated with each customer, as well as their other details and comments. To create a new customer, click `+ Customer` in the upper left corner. Select the type (Person or Company) from the dropdown menu, enter a name and any other details, and click `Create`. From here, you can open the contact page and add additional information, including a longer description, attachments, related issues, and comments. You can also add leads to the customer from this page by clicking the `+` button in the `Leads` section. --- # Recruiting | Huly Docs [Skip to content](https://docs.huly.io/additional-modules/recruiting/#_top) Recruiting ========== Huly’s recruiting module can be used to manage job vacancies, applications and talents within your workspace. Like other Huly modules, recruiting is interwoven with the rest of your workspace, allowing you to connect your recruiting data to your task tracker and chats. > **Note:** The recruiting module is disabled by default for new workspaces, as this feature set is not relevant for many users. If you’d like to enable the recruiting module, please contact our support team through [Slack](https://huly.link/slack) > . ### Creating vacancies To create a vacancy for a job position, navigate to Vacancies in the left sidebar and click `+ Vacancy` in the upper right corner. Add a title and description for the vacancy. You can also add a due date, location (remote, or the name of a city, for example), and any attachments needed. You may also wish to select members who will be responsible for managing the vacancy. Once you’ve finished, click `Create`. ### Managing vacancies Once you’ve created a vacancy, you’ll be able to see several additional options, including: * **Auto join** - automatically adds new workspace members to the space * **Company** - connect the vacancy to a company * **Collaborators** - collaborators will receive notifications related to any activity on the vacancy (learn more about [collaborators](https://docs.huly.io/task-tracking/issue-collaborators) ) You’ll also find the following sections on the vacancy page: * **Applications** - Add an existing application or create a new one. * **Surveys (in development)** - Attach an existing survey or create a new one. * **Related issues** - See all issues from your Tracker that are related to the vacancy, or create a new related issue (learn more about [related issues](https://docs.huly.io/task-tracking/related-issues) ). * **Activity** - See a record of all activity related to the vacancy. ![Vacancy page](https://docs.huly.io/_astro/recruiting-vacancy.BsKO21oS_eXClJ.webp) ### Creating talents and applications In Huly, **talents** are a type of contact. Talents can be connected to **vacancies** through **applications**. Talents can be created in 3 ways: 1. Converting an existing contact to a talent by creating an application 2. Creating a new talent at the time of creating an application 3. Creating a new talent from the recruitment module without any applications #### 1\. Converting an existing contact to a talent by creating an application To convert an existing contact to a talent, you’ll need to create an application for that contact. In the **contacts** module, navigate to the contact’s page, open the settings menu and click `New Application`. ![Creating a new application](https://docs.huly.io/_astro/recruiting-new-application.HzyrA-Wk_LA9nU.webp) From here, you can select a vacancy to submit the application to. You can choose an assigned recruiter, set a status for the application, and indicate a start date if applicable. If you choose to add a description, this will appear as a comment on the application page. ![Converting a contact to a talent](https://docs.huly.io/_astro/recruiting-convert-talent.Du22dUU__Z1kD4vM.webp) After creating the application, you’ll notice that the `Talent` label is applied to the contact. You’ll see their contact page has expanded to include several additional profile sections. #### 2\. Creating a new talent when creating an application If you do not already have a contact for a talent, you can create a contact for them at the same time that you create their application. In the **recruiting** module, navigate to any vacancy page and click the `+` button in the `Applications` section. Click the block for talent on the left side, then click the `+` to create a new talent. Fill out talent details, such as name, title, location, social links, onsite vs. remote availability, and resume. You’ll also be able to select skills from the dropdown menu (more on skills below). Click `Create`. ![Creating a new talent](https://docs.huly.io/_astro/recruiting-new-talent.TAE9MCP5_ZoyCL3.webp) Now, if you navigate back to your **contacts** module, you’ll see a contact has been added with the `Talent` label. #### 3\. Creating a new talent from the recruiting module It’s possible to create a new talent without attaching any application at all. In the **recruiting** module, select `Talents` in the left sidebar and click `+ Talent` in the upper right corner. Here, you’ll see all the same fields for creating a talent. Click `Create` and notice that your talent appears both in the **recruiting** module _and_ the **contacts** module. Managing talents ---------------- The talent details page is different from a typical contact page because it includes additional sections for `Applications`, `Skills`, `Reviews`, and `Surveys`, in addition to contact page sections `Attachments`, `Related issues` and `Activity`. In combination, all of these sections allow you to track everything you need related to talents within the recruiting module. Let’s take a look at each of these sections: ### Applications Here are listed all of the applications submitted for a talent. Here, you can see the application number, vacancy name, company, state and comments. You can also add a new application using the `+` button. ### Skills Skills can be used for filtering, sorting and searching through talents, in addition to providing a quick overview of the talent’s skills when browsing their contact page. You can add skills by clicking the `+` button. If you’ve already created skills, you can search for them or select from the dropdown menu. To create a new skill, click `+`. Provide a title and optional description and color for the skill and select the category from the dropdown menu. Then, click `Create`. ![Creating a skill](https://docs.huly.io/_astro/recruiting-skills.DEq1OlnA_Z17151H.webp) Skills can be managed by selecting `Skills` in the left sidebar. Here, you can filter, edit and delete skills. ### Reviews Reviews are used to schedule review of a candidate’s application. To create a review, click `+` and enter a title and optional location and description for the review. You can also enter the company, application and participants, and select a date for review. Then, click `Create`. After creating a review, you can find additional fields to add notes to the review. Most importantly, you can enter a `Verdict` on the review to indicate an overall impression. ### Surveys Surveys are still in development. Check back soon for more information! ### Managing applications Applications can be managed in a similar way to tracking tasks. Select list or kanban views, filter by status, and sort by any column. ![List view of applications](https://docs.huly.io/_astro/recruiting-applications.BjPifeuy_2uIV5R.webp) Each application also has several useful sections on its details page. You can find sections for `All talent reviews`, `Attachments`, `Surveys`, `Related issues` and `Activity`, which can all be used to add information and connect to other parts of the workspace. ### Customizing properties for vacancies, applications and talents You can add any additional properties you need to your vacancies, applications and talents. For example, you may wish to include a salary range or target start date for a vacancy, or a preferred contact method for a talent. To add your own custom properties, navigate to your workspace settings and select `Classes` from the left sidebar. Then, select the class that you’d like to customize. From here you can add any properties you’d like. For more on how to add properties to classes, see [Classes and enums](https://docs.huly.io/advanced-settings/classes-enums) . --- # Space types | Huly Docs [Skip to content](https://docs.huly.io/advanced-settings/space-types/#_top) Space types =========== What are space types? --------------------- Space types are the highest level of customization in Huly. They define the structure of your workspace by applying a shared set of roles and task types to all spaces created with that type. The tracker in Huly is based on the `Classic project` space type. This space type comes with no preset roles, and one task type (`Issue`) with process states of `Backlog`, `Todo`, `In Progress`, `Done` and `Canceled`. By default, new projects created in the tracker will use this space type. However, you may wish to create your own space types to model different types of processes that you’ll be tracking in your workspace. For example, you could create space types for “Client projects”, “Internal projects” and “Bug tracking”, each of which could have its own [roles](https://docs.huly.io/advanced-settings/roles) and [task types](https://docs.huly.io/advanced-settings/task-types) . Customizing default space types ------------------------------- You can find all of the settings for your space types under `Settings` in the left sidebar menu. Click on `SPACE TYPES` to see a list of all space types available in your workspace. Click on any space type to view and edit its settings. Some properties and attributes for spaces are not currently customizable. Settings in the first block cannot be changed, but you can customize each space type’s [roles](https://docs.huly.io/advanced-settings/roles) and task types [here](https://docs.huly.io/advanced-settings/task-types) . Creating custom space types --------------------------- To create a new space type, click the `+` button next to `SPACE TYPES` in the left sidebar menu of your settings. In the top left corner, select what kind of space you’d like to create a space type for. If you choose `Tracker`, you’ll also have the option to base your space type on the `Classic project`. Once your custom space type has been created, you can add [roles](https://docs.huly.io/advanced-settings/roles) and task types [here](https://docs.huly.io/advanced-settings/task-types) . Using your custom space type ---------------------------- Custom space types cannot be used for existing projects. To use your custom space type, you’ll need to create a new project and select your custom space type from the `Space type` dropdown menu. ![Using a custom project type](https://docs.huly.io/_astro/settings-custom-project-type.DaT5J5aj_lbQyP.webp) If you’ve added roles, you’ll be able to add members to each role when you create your project. --- # Task types | Huly Docs [Skip to content](https://docs.huly.io/advanced-settings/task-types/#_top) Task types ========== Huly is designed to be highly configurable to any kind of workflow. While some customization features are still being developed, there are several options already available for you to configure your workspace to your specific needs. What are task types? -------------------- Task types define the kinds of tasks inside your projects. A task type can have its own special properties and process states. To take a look at the default task type used in your Tracker, navigate to Settings and select `Classic project` from the `SPACE TYPES` area in the left sidebar menu. `Classic project` is the default [space type](https://docs.huly.io/advanced-settings/space-types) used in Huly. Notice in the `TASK TYPES` section that one task types are listed: `Issue`. Opening this task type will reveal its properties and process states. The `Issue` task type has process states of `Backlog`, `Todo`, `In Progress`, `Done` and `Canceled`. ![Settings for process states](https://docs.huly.io/_astro/settings-process-states.DbMI0ubW_Z1JcktQ.webp) > **Note:** If you’ve already connected your workspace to GitHub, you’ll also see a `Pull request` task type. These tasks are synced with GitHub, so they have their own unique properties and process states. Process states -------------- Process states are the stages that a task goes through in its lifecycle. Each task type can have its own set of process states. The Huly system will automatically move tasks between these states based on user actions. The following actions will trigger automatic state changes: 1. **Scheduling an action item** - When the issue assignee schedules an [action item](https://docs.huly.io/task-tracking/creating-action-items) connected to that issue, the issue status will change from “Todo” to “In Progress”. 2. **Completing a scheduled action item** - When the issue assignee checks off an [action item](https://docs.huly.io/task-tracking/creating-action-items) as complete (after scheduling it in their Planner), the issue status will change to “Done”. Even if you customize your process states to use different names (see below), the system will still recognize these actions based on the `Status category` of the process state. For example, you could change the name of the process state from “In Progress” to “Actively Working” and as long as the `Status category` is set to “Active”, the system will still recognize this state as the one that triggers the automatic state change. Creating custom task types -------------------------- In order to use your own customized task types and process states, you can either modify the default task types on the Classic Project, or create a new [space type](https://docs.huly.io/advanced-settings/space-types) . Either way, this can only be done by the workspace owner or maintainer. To create a new space type, navigate to settings and click the `+` button next to `SPACE TYPES` in the left sidebar menu. Select the space type you’ll be basing your new space type on; in this case, you’ll select `Tracker`. From here, you can enter a name for your space type (for example, “Custom Tracker”), and choose whether or not to base your space type on the `Classic project` (recommended). Then, click `Create`. Find your new space type in the left sidebar menu. From here, you can add members to the space type and toggle whether new workspace members will be automatically added to this space type. Click the `+` button in the `TASK TYPES` section. Enter a name for your new task type (for example, “Issue” or “Task”), choose whether this type can be used for sub-tasks, and click `Create`. The steps for creating and modifying task types in the Classic Project are the same. Creating custom process states ------------------------------ Open your new task types to create your custom process states. You’ll see placeholders for each category, each of which can be edited to your specific needs. Click on any process state to edit it. You can change the name of the state, the color associated with it, and the status category. The status category is used to trigger automatic state changes based on user actions. You can also create new process states. For example, within the “Active” status category, you may wish to add more states, such as “Started” “In progress”, “Submitted for review” and “Under review”. You might also want to add more specific states to the “Done status/lost” category, such as “Cancelled”, “On hold” or “Blocked”. ![Settings for custom process states](https://docs.huly.io/_astro/settings-custom-process-states.DRUlDwqG_tshtc.webp) Using your custom task types ---------------------------- In order to use your custom task types, you’ll need to create a new project based on your new space type. At this time, it is not possible to change the space type used for an existing project. When creating a new project, select your custom task types from the `Project type` dropdown menu. ![Using a custom project type](https://docs.huly.io/_astro/settings-custom-project-type.DaT5J5aj_lbQyP.webp) Now, when creating new issues within your project, you’ll find all of your custom task types and process states available to use. --- # Classes and enums | Huly Docs [Skip to content](https://docs.huly.io/advanced-settings/classes-enums/#_top) Classes and enums ================= Huly offers a high degree of configurability through Classes. A class is a set or category of things having some property in common. In other words, classes are a way to group objects together based on shared properties. To access class settings, navigate to settings and click `Classes` in the `WORKSPACE SETTINGS` menu. You’ll see a list of all the classes in your workspace. Clicking on any class will display its properties. Customizing class properties ---------------------------- Currently, only the `Contact` and `Task` classes can be customized. To add a property, click the `+` button. Choose from the following property types: * URL * String - for single-line text * Boolean - select Yes, No, or N/A * Number * Date * Ref - (not yet implemented) * Array - (not yet implemented) * Enum - select from a list of options (see below) You’ll see that your new property will now appear on any object belonging to that class. To remove a property, open the settings menu to the left of the property and click `Remove`. You can also hide a property here as well by clicking `Hide attribute`. Enums ----- Enums are a type of property that allows you to select from a list of options. For example, you could add a property called “How we met” to your contacts and use options like “Conference”, “Mutual friend”, “Cold call” etc. To create an enum, navigate to Settings > Enums and click the `+ Create enum` button. Add options and click `Save`. You can also create enums directly from the Classes settings. After creating a new property with the type `enum`, use the `+` button to create a new enum for that class. Example use-case ---------------- Check out this video to see an example of how classes and enums are used for managing contacts: --- # Text Templates | Huly Docs [Skip to content](https://docs.huly.io/advanced-settings/text-templates/#_top) Text Templates ============== What are text templates? ------------------------ Text templates can help you save time and maintain consistency across your workspace. With text templates, you can create predefined text structures that can be used for task descriptions, chats, comments and more. Text templates allow you to define reusable content structures that can be used across various features in your workspace. These templates can help ensure consistency, reduce repetitive typing, and improve collaboration by providing clear, standardized formats. > **Note:** The `Field` option is still in development, so it is recommended to instead create your own “blanks” in your template to fill in when you use them. Creating and managing text templates ------------------------------------ To create and manage text templates, navigate to Settings and select `Text Templates` from the `WORKSPACE SETTINGS` area in the left sidebar menu. Here, you can create new templates or edit existing ones. To create a new text template, click the `Create template` button. Enter a title for the template, define the structure, formatting and placeholders, and save the template to a folder. By default, new templates are saved to the `Public templates` folder, where they can be accessed by anyone in the workspace. To make your templates private, create a new template group and toggle the privacy setting. Using text templates -------------------- Once created, text templates can be accessed from chat messages, comments, issue descriptions, and anywhere else the text template icon is available. Simply click the text template icon and select the template you’d like to use. There are many areas of your workspace where text templates are useful. Here are a few examples of use cases: * **Recurring task descriptions:** Define specific formatting for recurring tasks, or just create basic reusable styling for your content. * **Quick chat replies**: Use predefined responses for common questions or updates. * **Meeting invites**: Standardize recurring meeting announcements: **_Example:_** Reminder: Our [Meeting Name] is scheduled for [Date and Time]. Please review the agenda here: [Link]. * **Code Reviews**: Use templates to standardize feedback on code: **_Example:_** Code: [File/Line reference] Observation: [Issue/Feedback] Suggested change: [Proposed solution] --- # Connecting tasks | Huly Docs [Skip to content](https://docs.huly.io/people-contacts/connecting-tasks/#_top) Connecting tasks ================ Tasks in your workspace can be directly connected to people in your Contacts list. There are several cases where this can be useful, for example: * **Working with clients** - Freelancers, agencies and businesses using Huly to manage client projects may choose to connect tasks in their Tracker to client contacts. This allows tasks to be linked to the client’s contact information, making it easy to keep track of who to contact for updates, feedback or approvals. * **Scheduling follow ups** - Keep track of follow up conversations by creating tasks in your Tracker that are connected to your external contacts. Keep notes on your interactions and set reminders for when to follow up. * **Tracking support requests** - If you’re using Huly to manage support requests, you can connect tasks to the contact who submitted the request. This makes it easy to see all tasks related to a specific contact, and keep track of the status of their requests. Creating a new issue -------------------- To create an issue directly from a contact, open the dropdown settings menu on their contact page and select `New related issue`. This will open a dialog to create a new issue. When the issue is created, a `Related` field will appear in the details sidebar. Here, you can see the contact connected to this issue. Connecting an existing issue ---------------------------- To connect an existing issue to a contact, open the issue and open the dropdown settings menu. Select `Relations` and then `Reference another issue`. From here, you can choose a contact to connect to the issue. > **Note:** You can also connect other issues, documents and tasks here! Viewing connected issues ------------------------ To view all of the issues related to a contact, navigate to the Tracker and select `All issues`. Use the `Filter` button to select `Related to` and then choose the name of the contact whose issues you’d like to see. --- # Viewing and sorting issues | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/viewing-issues/#_top) Viewing and sorting issues ========================== List and kanban views --------------------- The default view for issues is the list view, where issues are listed in order of their status. Huly also offers the option for a kanban view, which displays issues in a column format. To toggle between the two views, click either the list or kanban icon in the top right corner of the window. When viewing issues for a specific project, you’ll only be able to view one [task type](https://docs.huly.io/advanced-settings/task-types) at a time. This is because task types can have different process states. To view all of your tasks in one place (including all task types), navigate to `All issues` in the sidebar. Issue peek ---------- Press the `space` bar while hovering over any issue to “peek” at that Issue’s details. From this view, you can use the up and down arrows on your keyboard to scroll through your issues. Hovering over comments or due dates will also open a preview of these details. ![Issue Peek](https://docs.huly.io/_astro/tracker-issuepeek.DlCFGkPo_ZAbL2r.webp) Keyboard shortcut ----------------- Press `C` on your keyboard to create a new issue from any view. Sorting, filtering and searching -------------------------------- Options for sorting and filtering issues can also be found in the top right corner. The `View` button allows for configuration of some viewing settings as well as options for sorting how issues are grouped and ordered on the page. The `Show` button displays toggles for showing and hiding issue details. The `Filter` button, next to the search bar, offers options for filtering issues. The search bar can be used to search for a specific issue by keyword. For quick sorting, select `Active`, `Backlog` or `All` from the menu above the search bar. Download as PDF --------------- Issues can also be downloaded in PDF format: --- # Creating action items | Huly Docs [Skip to content](https://docs.huly.io/task-tracking/creating-action-items/#_top) Creating action items ===================== What are action items? ---------------------- Action items are tasks that are assigned to a specific team member. They are created automatically when an issue is created with a status of “Todo” and assigned to a team member. Action items are added to the member’s Planner, where they can be scheduled and tracked. Action items are a unique feature of the Huly platform. You can learn more about the concept behind action items (previously called “todos”) on our [blog](https://huly.io/blog/capturing-dynamic-team-workflows-with-action-items) . Action items are also covered more in depth in our tutorial video: Creating action items --------------------- Action items can be created automatically, manually in your own Planner, or directly from within documents. ### Action items automatically created for an issue An action item is automatically generated by the system when an issue is created with an assignee and the status set to “Todo”. This action item will appear in the Planner of the assignee, and a notification will appear in their inbox. This is the recommended way to create an action item because it directly links to the issue and allows for tracking of the issue’s status, while ensuring an individual team member is responsible for the action item’s completion. ### Creating an action item in your Planner Action items can be created in your own personal Planner without being attached to any particular project or issue. Creating an action item in this way may be helpful for a team member to manage small personal tasks that don’t directly relate to an issue and don’t necessarily need to be visible to the rest of the team. To create an action item in your Planner: * Navigate to the Planner view by clicking on the calendar icon in the left sidebar. * Click on the text field and enter a title for your action item; press enter to save. Your new action item should now appear in your Planner in the “Unplanned” section. ### Assigning action items directly from a document For more on creating and assigning action items directly within documents, check out this [guide](https://docs.huly.io/knowledge-management/documents-action-items) . Completing an action item ------------------------- When the task associated with an action item is complete, the action item can be marked as complete by clicking the round checkbox that appears when hovering over the action item on the Planner. This will change the status of the associated issue to “Done” and will move the action item to the “Done” section of the Planner. Reminders for action items - coming soon! ----------------------------------------- As of February 2025, this feature is still in development and is not currently available in Huly. Please check back for updates on this feature when it becomes available! --- # Collaborative editing | Huly Docs [Skip to content](https://docs.huly.io/knowledge-management/collaborative-editing/#_top) Collaborative editing ===================== One of the most powerful features of Huly documents is the ability for team members to collaborate in real time. Users can see each others’ cursors and edits as they happen, making it easy to work together on planning materials, meeting notes, and other share project resources. When collaborating on a document, click on any member’s icon to jump to their live cursor on the page: Editing during a meeting ------------------------ Video calls in Huly can be easily pinned to the right side of the window, allowing team members to continue to view the call while navigating the platform. This makes it easy to reference documents, take notes, and make changes to documents during a meeting. Assigning action items ---------------------- When working on projects together, it may be helpful to assign small action items that aren’t necessarily connected to any particular issue in the Tracker. Check out our guide on [assigning action items in documents](https://docs.huly.io/knowledge-management/documents-action-items) to learn more about this feature! --- # Drive | Huly Docs [Skip to content](https://docs.huly.io/knowledge-management/drive/#_top) Drive ===== Drive is a robust and versatile file storage system fully customizable to your team’s needs. Store any type of file directly within your workspace and keep everything organized with customizable folders and privacy settings. Files stored in Drive are easily accessible for viewing, printing and downloading, allowing teams to efficiently share resources and promote collaboration. Teams can add members to specific Drive spaces, ensuring everyone has access to the files they need without compromising security. Creating your Drive ------------------- Your Huly workspace comes with one existing Drive called “Records”; however, you can add as many Drives as you’d like and customize them to suit the needs of your team. To create a Drive, click the dropdown arrow next to the `+ Upload File` button and select `Create Drive`, or hover over the word “Drive” in the sidebar and click the `+` icon that appears. Enter a name and optional description for your Drive, select the owners and members, and toggle privacy settings. Then, click `Create`. Adding folders -------------- You can further organize your Drives into folders containing files. To create a new folder, click the breadcrumb icon that appears when hovering over the name of your Drive in the left sidebar. Alternatively, click the dropdown arrow next to the `+ Upload File` button and select `Create Folder`. Enter a name for your folder and click `Create`. Uploading files and folders --------------------------- To upload a file or folder to your Drive, click the `+ Upload File` button at the top of the Drive sidebar. Select the file or multiple files you’d like to upload from your computer, or drag and drop them into the upload area. Once the files have been uploaded, they will appear listed in your Drive. To view a file, click on the file name in your Drive. Several options are available for files in drive: * **Rename your file** - open the right sidebar and click on the file name to rename it. * **Download** - click the download icon to download the file to your computer. * **Move** - open the settings menu and select `Move` to change the parent folder or Drive for your file. Creating file versions ---------------------- Huly automatically creates a record of a file versions when a new version is uploaded. After a file has been modified, it can be added to the original file as a new version using the upload button in the top right corner of any file preview. Each new version is listed under the original file for easy access: Adding comments --------------- ![Preview of a file in Drive](https://docs.huly.io/_astro/drive-preview.DT4tcrB6_ZWLuDg.webp) You can add comments on files in the Activity section below the file preview. Just like anywhere else in the Huly platform, comments support markdown formatting, attachments, mentions, emojis and text templates. Comments can be used to provide feedback, ask questions, or discuss the contents of the file. Just like other objects in the Huly platform, activity related to files can be accessed from Chat as well, allowing you to keep track of discussions and changes all in one place. See our guide on [activity tracking in chat](https://docs.huly.io/communication/chat-activity) to learn more about how comments on your Drive files are connected to the rest of your workspace. --- # Editing and formatting | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/editing-formatting/#_top) Editing and formatting ====================== While each type of Controlled Document is created through slightly different steps, all Controlled Documents have the same options available for editing and formatting. Just like any other document in your workspace, you can use tags, attachments, images, tables, and other markdown formatting to customize your document. The following features are also available: **Comments:** Highlight text and select the speech bubble icon. Comments can be viewed together in the right side panel, where they can be filtered and sorted. ![Comments in sidebar](https://docs.huly.io/_astro/comment-sidebar.Bbyj3LSC_Z2dil0.webp) **Sections:** Open the `...` menu beside the section title and choose to add a new section above or below, or delete or duplicate the current section. ![Adding a new section](https://docs.huly.io/_astro/add-section.BEbSd6tL_Z16eoix.webp) **Export to PDF:** From the settings menu in the top right corner, select `Print to PDF`. PDFs are 21 CFR Part 11 compliant. ![Printing document to PDF](https://docs.huly.io/_astro/print-pdf.CXk3ujB2_Z21QeiH.webp) --- # Quality documents | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/quality-documents/#_top) Quality documents ================= Quality documents are a part of the Controlled Documents module and are used for managing quality-related documents, such as standard operating procedures and work instructions. Creating a quality document --------------------------- To create a quality document, open the settings menu next to `QUALITY DOCUMENTS` in the left sidebar and select `Create new document`. It’s also possible to create a quality document by clicking the blue `+ New document` button in the top left corner of the Controlled Documents module and then selecting `Quality documents` as the space. > **Note:** A new quality document can also be created as a child of any existing document. Proceed through the following steps to create the document: **Step 1:** Select a space and parent for your document. The space defines the roles and permissions that will apply; the parent simply determines where the document will be stored. A document can be the direct child of the space itself (at the top level of the space), or it can be a child of a document within that space. ![Step 1 for creating a new quality document](https://docs.huly.io/_astro/new-quality-doc-1.DAlRyWyY_Z2s166y.webp) **Step 2:** Select a template for your document. See our guide on [templates](https://docs.huly.io/controlled-documents/templates) for more information about how to create reusable templates for Controlled Documents. ![Step 2 for creating a new quality document](https://docs.huly.io/_astro/new-quality-doc-2.C4ADSgTC_1VJgol.webp) **Step 3:** Provide details for your document, including a title, description, and reason for document creation. ![Step 3 for creating a new quality document](https://docs.huly.io/_astro/new-quality-doc-3.ZBo0drar_t5xhE.webp) **Step 4:** Select team members that will be working on the document, including Co-Authors, Reviewers, and Approvers. ![Step 4 for creating a new quality document](https://docs.huly.io/_astro/new-quality-doc-4.CRNRhPGX_Z1dM8wn.webp) After proceeding through the above steps, click `Create Draft`. --- # Filtering documents | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/document-filtering/#_top) Filtering documents =================== To create a filtered view of your documents, navigate to the `Library` sub-menu of the Controlled Documents module. From here, click the `Filter` button at the top toolbar and select the criteria you’d like to filter by. For example, you may wish to create a view of documents created by a specific person, or documents created within a certain date range. After setting your filters, click the `Save as` button in the top right corner. Give your filtered view a name, decide if you’d like your view to be private or public, and click `Save`. Saved filtered views are accessible from the left sidebar. --- # Products | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/products/#_top) Products ======== The Products module, enabled by default in [TraceX](https://docs.huly.io/getting-started/introduction-tracex) workspaces, is used for managing product versioning and documentation. Products can represent physical or digital products that your organization produces, and can be linked to other objects in the workspace. Creating a product ------------------ To create a product, click the `+ Product` button in the Products module. Provide a title and description, and select members and roles as needed. Then, click `Create`. Creating a product version -------------------------- > **Note:** In order to create a new version of a product, you’ll need to have an effective Change Control document that uses a Change Control template. To learn more about this step, see this guide on creating [templates](https://docs.huly.io/controlled-documents/templates) > . To create a new version of a product from within the Products module, open the details page for the product you’ll be adding a version to. Then, click the `+` button beside the `Product Versions` section. From here, you’ll be able to provide a name and description for the new version, and select if the change is substantial or not (minor or major). You’ll also be able to select your Change Control document from the dropdown menu. After providing the necessary details, click `Create`. The new version will be added to the product’s version history. Technical product documentation ------------------------------- To learn more about how to create documentation for a product, see our guide on [technical documentation](https://docs.huly.io/controlled-documents/technical-documentation) . --- # Sending messages | Huly Docs [Skip to content](https://docs.huly.io/communication/sending-messages/#_top) Sending messages ================ Huly offers many options for team members to communicate directly within the Huly platform without the need for an external app. Huly’s chat functionality allows team members to exchange messages in real time through direct messaging and shared channels. This guide covers how to exchange messages with your team using Chat. Chat is also integrated with the rest of your workspace, so documents, issues, pull requests and other workspace objects can be accessed alongside your other conversations. For more on how Chat integrates other workspace activity, see our guide on [activity tracking in chat](https://docs.huly.io/communication/chat-activity) . Ways to chat ------------ There are a few different ways to chat with team members on Huly: * **Channels** - Public or private chatrooms based on topics or themes * **Direct messages** - Instant messaging between individuals or groups * **Other workspace objects** - From Chat, you can access all activity on documents, issues, files and more. Read more in our guide on [activity tracking in chat](https://docs.huly.io/communication/chat-activity) . **Icons and indicators:** * A red dot beside the chat indicates an unread message. * A green dot next to a user’s avatar indicates that they are online and have their Huly workspace open. Managing chat channels ---------------------- Create a new channel by clicking the `+` button at the top of the Chat sidebar and selecting `New channel`. Enter a name and topic for your channel and select either `Public` or `Private` for visibility. Click `Create`. > **Note:** Channels set to `Private` are still visible in the channels list, but users will need to request access to join. To create chats that are not visible to the rest of the team, create a group direct message with the included members (see below). After you’ve created your channel, there will be a few additional settings available in the right sidebar: * **Name** - Set the name for the channel. * **Private** - Private channels are visible to members only. * **Auto join** - Toggle this setting to automatically add all new workspace members to this channel. This will not add existing workspace members; only members who join _after_ this setting is enabled will be added to the channel. * **Members** - Add or remove members from the channel. * **Topic** - Edit the topic (description) for the channel. To leave a channel, hover over the channel name in the sidebar and click the settings menu, then click `Leave channel`, or navigate to “Channels”, right-click on the channel name and select `Leave`. To archive a channel, you must be owner or creator of the workspace. Archive a channel either by selecting `Archive channel` from the settings menu, or right-clicking the channel name in “Channels” and selecting `Archive channel`. > **Note:** Two channels are created by the system when you create the workspace: `#general` and `#random`. In order to archive these system-generated channels, you must be a Spaces Admin. For more on permissions, including how to set Spaces Admins, see our guide on [roles](https://docs.huly.io/advanced-settings/roles) > . Star a channel by selecting `Star` in the settings menu. Starred channels will appear at the top of the list in the left sidebar. Creating direct and group messages ---------------------------------- Create a new direct message by clicking the `+` button at the top of the Chat sidebar and selecting `New direct chat`. Select the user you’d like to chat with and click `Create`. Selecting more than one user will create a group chat. To close a direct or group message and remove it from your sidebar, hover over the chat in the sidebar and open the settings menu, then click `Close conversation`. Closing the conversation does not remove the message history, so your existing messages will still be available when you reopen the chat. Chat options ------------ Like everywhere else in your Huly workspace, chat messages support markdown formatting, attachments, mentions, emojis and text templates. Hover over any message to add a reaction, pin it to the top of the chat, or reply in a chat thread: Bookmark any message to save it for later. See all saved messages in the `Saved` tab in the Chat sidebar: Translating messages -------------------- To translate a message, simply hover over the message and click the translate icon. This will translate the message into the language you have selected for your workspace. To restore the original message, hover again and click ‘Show original’. Chatting in the sidebar ----------------------- Any chat can be moved to the right sidebar by clicking the “Open in sidebar” button in the top right corner of the chat. You can open multiple threads, channels and DMs here for easy access as you navigate the platform. The chat panel can be hidden by clicking the chat icon in the far right menu. Your calendar and virtual office can also be accessed through the right sidebar. Check it out! --- # Document versions | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/document-versions/#_top) Document versions ================= Creating a new document version ------------------------------- As a Controlled Document owner, you can create a new version of your document by selecting `Draft new version`. With the draft open, you can make any necessary changes to the content, provide information about the new version in under the `Reason & Impact` tab, and update team members and release info. Selecting `Comparing` from the top right corner allows you to compare changes across document versions, displaying additions highlighted in green and deletions in red. Once the approval process for a document is completed, you’ll have a version 0.2 Effective document, with the `History` section auto-populated with the information you entered in `Reason & Impact`. > **Note:** Document metadata is now editable during the initial document version draft phase, allowing users to modify the document ID, template prefix, and category before finalization. This ensures flexibility in case of errors during the creation process. Marking a document as obsolete ------------------------------ To mark a document as obsolete, open the settings menu and select `Mark as obsolete`. Obsolete documents are marked with a red label, removed from active document lists, and cannot be used to create new versions (the `Draft a new version` button is disabled). --- # Virtual office | Huly Docs [Skip to content](https://docs.huly.io/communication/virtual-office/#_top) Virtual office ============== The Huly platform offers the ability for team members to meet through built-in voice and video conferencing. To access the Live Office Virtual Environment, click the building icon in the left sidebar. Navigating your virtual office ------------------------------ The virtual office contains three kinds of rooms: * **Individual offices** - Each team member has their own office space. Other users are required to knock before entering. Audio and screen sharing are available. * **Team rooms** - These rooms are for voice calls only, support screen sharing, and do not require knocking to enter, although this setting can be overridden. Team rooms are ideal for quick meetings with more than 2 team members. * **Meeting rooms** - These rooms are for video conferencing. Audio-only is also possible, and screen sharing is supported. Meeting rooms do not require knocking to enter, although this setting can be overridden. Meeting rooms are perfect for larger meetings or presentations. Individual offices ------------------ At the bottom of the screen, you can choose the privacy setting for your own personal office: * **Knock required** - Others must request access by knocking before entering. * **Do not disturb** - Others are unable to request access to your office. To enter someone else’s office, click on any team member’s office to request to enter. You’ll see a dialog indicating that you are knocking on their virtual office door, and you’ll need to wait to be allowed to enter. When someone is requesting to enter your office, you’ll see a popup with their image and name. Select `Accept` to begin a voice call, or `Decline`. You can end the meeting at any time by selecting the meeting in the top status bar and clicking `End meeting`. This will effectively kick the visiting participant out of your office. Team and meeting rooms ---------------------- Team and meeting rooms are available for meetings with more than 2 participants. Team rooms allow for audio only, while meeting rooms support video conferencing. Both room types allow for screen sharing and various access settings. Click on any meeting room to enter. If you’re the first one in the meeting room, you’ll see a `Start meeting` button. If the meeting room is already in use, you’ll see a `Join meeting` button instead. During the meeting, a few options are available at the bottom of the screen: * **Change access** - Select either open, knock required or do not disturb. * **Audio** - Mute or unmute, and change settings for speaker, microphone and noise cancellation. * **Video** - Turn camera on or off, and change settings for which camera to use and how much to blur the background. * **Share** - Share all or part of your screen with everyone in the room. To include system audio when sharing your screen, open the settings menu next to the screen share icon and and toggle “include system audio”. Restart the screen share to apply the changes. * **Record** - Toggle meeting recording on or off. Recordings are automatically saved to your Drive and are visible to anyone with access to the Drive space. * **Transcription** - Toggle transcription on or off. For more on how Huly’s AI assistant Hulia transcribes meetings in real-time, see [Transcription](https://docs.huly.io/communication/transcription) . * **Full-screen mode** - Open the call in full screen. * **More options** - Copy guest link (in development), and Settings (for setting the room language, as well as recording and transcription defaults). * **Leave room** - Exit the meeting room. Navigating the platform during a call ------------------------------------- You’ll notice that meetings are automatically opened in the right sidebar. You can navigate the platform while in a call, and the call will remain open in the sidebar. From the sidebar, you can switch between the video, chat, and transcription tabs. Editing your office space ------------------------- While Huly’s virtual office comes with default offices and meeting rooms, teams may wish to customize the number of rooms and office layout to best suit their needs. Only the creator of the Workspace is able to edit the office space. Click the `Edit office` button in the top right corner. A few options are available for editing: * Rename offices and rooms by clicking on their names. * Delete offices and rooms by clicking the trash bin icon. * Arrange offices and rooms by clicking and dragging their edges or dragging them to a new place in the layout. * Add a new office or room by clicking the `+` button in the top right corner. When you have finished editing your office space, click `Finalize editing` in the top right corner to save your changes. ### Adding floors Large teams may find that the default layout may not have sufficient space for their offices and rooms. Additional floors can be added to the virtual office by clicking the `+` button on the Floors sidebar. If the Floors sidebar is not visible, either collapse the Main view by clicking the icon in the top left corner, or click on the two horizontal lines below your Workspace icon at the top of the left sidebar. To add a new Floor, click the `+` icon in the top right corner of the Floors sidebar. Enter a name for the new Floor and click `Add a floor`. Office preview -------------- At any time, from any view in the Huly platform, you can glance at your virtual office space by selecting the `Office` icon in the far right sidebar. This opens a preview of your virtual office in the sidebar, where you can see which team members are in which areas. You can join a meeting room or visit someone’s office from here as well. --- # Managing Contacts | Huly Docs [Skip to content](https://docs.huly.io/people-contacts/managing-contacts/#_top) Managing Contacts ================= There are three types of contacts in Huly: * **Employee** - a member of your workspace * **Person** - an external contact * **Company** - a company or organization These Contact types are used to help you organize members of your workspace alongside external contacts, like clients, leads, GitHub collaborators and more. You can manage your Contacts from the Contacts page in your workspace. Adding contacts --------------- Contacts can be added using the `+` button in the top right corner of the Contacts page. For more on adding employees to your workspace, see this guide on managing [employees](https://docs.huly.io/people-contacts/employees) . To add an external contact, click the `+ Person` button and enter their name and email address. This will create a new contact in your Contacts list. From here, you can add notes, attachments, social links and additional information related to the contact. Customizing your Contacts list ------------------------------ You can customize the kind of information you wish to store for people in your Contacts list. For example, you may wish to add information like how you met, their pronouns, their preferred method of contact, or other specific details. To add custom fields to your contacts, click the cog icon in the top right corner of the details sidebar. You can also access this page by navigating to `Settings` and selecting `Classes` and then `Person`. Here, you can add any fields you like to your contacts. Just like any other fields for contacts, your custom fields can also be used to filter and sort contacts on your list. Filtered lists can be saved for easy access later: Deleting contacts ----------------- Contacts can be deleted by right-clicking on the contact and selecting `Delete`. This option is also available from the dropdown settings on the contact’s individual page. --- # Review and approval | Huly Docs [Skip to content](https://docs.huly.io/controlled-documents/review-approval/#_top) Review and approval =================== TraceX includes electronic signatures (21 CFR part 11, FDA), which are used for reviewing and approving Controlled Documents. **Note:** As of January 2025, authors are now required to sign documents before sending them for review or approval, with corresponding timestamps included in the document. documents that have already been reviewed cannot skip the review step when sent for approval, maintaining the proper order of signatures (Author → Reviewer → Approver). This ensures consistency and helps avoid issues during audits. The exported PDF will reflect the correct signature order based on the review sequence, ensuring proper documentation for regulatory purposes. Reviewing a document -------------------- To send a document for review, click `Send for review` and select the members that will be reviewing the document. This menu will automatically populate with the reviewers selected when creating or editing the document, but you can add additional reviewers here as well. Confirm submission for review by entering your own electronic signature. Then, click `Send`. ![Sending a document for review](https://docs.huly.io/_astro/send-for-review.CS5aS4jr_ZCyDC0.webp) ![Confirming send for review](https://docs.huly.io/_astro/review-confirmation.C8KWNJ5U_1EeAnL.webp) Document reviewers will be able to add their electronic signature when submitting their review. After the document has been reviewed, any further edits will be recorded for comparison. Selecting the `Comparing` option will allow you to view the edits to the document, using red and green highlights to show deletions and additions. Approving a document -------------------- To send a document for approval, click `Send for approval` and select the members that will approve the document. Any documents that have had changes after previously being reviewed must still be reviewed again before approval. > **Note:** All comments need to be resolved before sending a document for approval. If unresolved comments remain, the `Send for approval` button will be disabled. Once sent, the approvers can approve or reject the document and add their electronic signature. Editing reviewers and approvers ------------------------------- As an author of a Controlled Document, you can now edit the reviewers and approvers list while the documents are still in ‘In review’ or ‘In approval’ status. This means you no longer need to start from scratch if you need to make changes before finalizing the document. --- # Telegram | Huly Docs [Skip to content](https://docs.huly.io/integrations/telegram/#_top) Telegram ======== Huly’s Telegram integration provides the following functionality: 1. Receive Huly inbox notifications in Telegram, including chat messages, mentions and other workspace activity. 2. Send messages to Huly chat channels and DMs from Telegram. 3. (coming soon) Communicate with any external Telegram user directly from Huly, even if they are not a Huly user themselves. Telegram provides a way for Huly users to stay connected with their workspace while on the go, ensuring that they never miss important updates or messages. In the near future, our Telegram client will also provide a means for managing external conversations within the Huly workspace, right alongside internal communications. Connect to the Telegram bot --------------------------- To connect with our Telegram bot, navigate to Settings > Notifications. Under “General”, toggle on Telegram notifications. Then, click `Configure` to connect your Telegram account. Open the link to `hulyio_bot` and follow the prompts on the screen to enter the code and click `Ok`. Receiving Huly notifications in Telegram ---------------------------------------- From the notifications settings menu, you can select which kinds of Huly notifications you’d like to receive in Telegram. For example, you could toggle notifications for Chat, allowing you to receive internal Huly messages in your Telegram account. You can also toggle notifications for Issues, Applications, GitHub and more. After enabling Telegram notifications, you will begin to receive messages from Huly in your Telegram account. Responding to Huly notifications in Telegram -------------------------------------------- You can respond to notifications by replying directly to the notification message (shown in the video below). In Huly, this will appear as a reply in the thread on that message or notification. To reply to a chat channel or DM without creating a new thread, you’ll need to sync your channels (see below). Sending messages to Huly channels and DMs from Telegram ------------------------------------------------------- Any time you add, update or remove channels and DMs in Huly (or if this is your first time connecting with the Telegram bot), you’ll need to sync with Telegram. In Telegram, select `Menu` and then `Sync all channels`. This will sync all channels and DMs with your Huly account. ![Telegram bot menu options](https://docs.huly.io/_astro/telegram-sync.54huDra7_1DBs2c.webp) After syncing, when you send a message in Telegram, you’ll see a list of your channels to choose from. Select a channel or chat to send your message there. ![Select channel in Telegram](https://docs.huly.io/_astro/telegram-select-channel.D7f8Rnuc_Z2dtqD2.webp) Using Telegram with multiple workspaces --------------------------------------- You can configure Telegram to receive and respond to notifications from multiple Huly workspaces. To do this, follow these steps: 1. In Settings > Notifications, follow the steps above to connect your first workspace to Telegram. 2. In Settings > Notifications, connect your second workspace to Telegram. Click `Test connection` and ensure you see “Connected”. 3. In Telegram, enter the command `/sync_all_channels` and/or `/sync_starred_channels` to sync channels from both workspaces. You should now receive notifications from both workspaces in Telegram. When sending a message, you’ll be prompted to select a workspace before choosing a channel or DM to send your message in. Coming soon: Use Telegram to connect with external contacts ----------------------------------------------------------- To enable Telegram integration, follow these steps: 1. Navigate to Settings and select Integrations from the left sidebar menu. In the Telegram integration card, click `Add`. 2. Enter your phone number and click `Next`. 3. Enter the 5-digit code you receive on your Telegram account and click `Connect`. In the near future, Huly’s Telegram client will allow you to add a Telegram account for any contact and communicate with them directly from Huly. This will be useful for managing external conversations within the Huly workspace. In some cases, you may wish to share a conversation you have with a Telegram contact with other members of your workspace. In an upcoming version of Huly, you’ll be able to easily publish selected messages to a contact’s activity record, making them visible to your team. Stay tuned for more updates to our Telegram integration in the near future! --- # Roles and permissions | Huly Docs [Skip to content](https://docs.huly.io/advanced-settings/roles/#_top) Roles and permissions ===================== Roles and permissions can be used to restrict access to spaces and allow additional permissions to select members. Permissions can be controlled at various levels: 1. **Workspace owners and maintainers** - high-level control over who can make major changes like deleting the workspace and adding/removing team members. 2. **Global admins** - extended permissions for members to archive and delete projects in the workspace. 3. **Space type roles** - specific roles that can be used to toggle update, archive and delete permissions for users, customized by space type. 4. **Space members** - permissions for each individual space — simply add members and toggle privacy settings to determine exactly who can access which spaces in your workspace. Workspace owners and maintainers -------------------------------- Navigate to Settings and select `Owners` from the `WORKSPACE SETTINGS` menu. From here, you can select a role for each team member: * **Owner** - The workspace owner has full control over the workspace. They can remove team members and manage workspace settings. A workspace can have multiple owners. * **Maintainer** - Maintainers have the same permissions as owners, except they cannot delete the workspace, remove owners, or remove team members. Maintainers cannot change their own role in the system. Maintainers can manage workspace settings. * **User** - Users cannot manage workspace settings, change their own role, or remove team members. > **Note:** [TraceX](https://docs.huly.io/getting-started/introduction-tracex) > workspaces come with additional roles: `Qualified User`, `Manager`, and `QARA`. These roles are used to manage permissions for controlled documents, products, product documents and trainings. Spaces admins ------------- You can also set admins globally for all spaces within the workspace. Global admins have full permissions when it comes to spaces themselves, such as archiving and deleting projects, but they cannot delete the workspace, remove the workspace owner, or manage workspace settings (unless granted Owner or Maintainer permissions at the workspace level - see above). To set a global admin, navigate to `WORKSPACE SETTINGS` in Settings and select `Spaces`. From here, you can add or remove admins. Space type roles ---------------- Roles can also be set for a space type. In Settings under the `SPACE TYPES` menu, navigate to the space type you’d like to manage and find the `Roles` section. Then, click the `+` button. Enter a name for your role and click `Create`. Then, click on your role to select specific permissions. Once your roles have been created, you’ll be able to assign roles to team members for spaces using that space type. [TraceX](https://docs.huly.io/getting-started/introduction-tracex) workspaces come with some special permission built in. The default roles of `Qualified User`, `Manager`, and `QARA` can be customized for your specific needs. Navigate to your workspace settings and open the space that you want to customize — Default Documents, Default Trainings or Default Products. From here, you can add or delete roles and edit their names, and add or remove permissions. Space members ------------- Permissions can also be set for individual spaces, such as projects, teamspaces, drives, and more. All spaces with a `Make private` toggle can be restricted to allow only members to view the space. This toggle can be set at the time of creating the space, or when editing the settings later. In order to restrict access to only members, ensure `Make private` is toggled on, and select the members you’d like to have access to the space. In the example below, you can see that this project space is set to private, and 7 members have been selected to have access to the space. ![Privacy settings for a space](https://docs.huly.io/_astro/spaces-make-private.VZZAUY1M_SzAJx.webp) If a space is not set to private, any member of your workspace will be able to join the space. This means that you don’t need to manually add members to the space when creating it. However, if members are not added to the space, they will not see it in their left side menu by default — they will have to find the space on the list of spaces and join it themselves. For this reason, you may want to consider adding members to the space when creating it to ensure it automatically appears in each member’s left side menu. > **Note:** If `Auto join` is toggled on, new workspace members will be automatically added to your private space, even if you haven’t specifically added them to the list of members. If you’d like to restrict access to only the members you’ve selected, ensure `Auto join` is toggled off. Assigning roles --------------- How you choose to assign roles to your users will depend on the kind of module you’re working with, and the steps are slightly different for each. Continue reading to see how roles can be assigned for Controlled Documents, Products, and Trainings. **Controlled Documents:** Open the settings menu for any document space and select `Edit documents space`. From here, you can first add members to the space and then assign members to each of the available roles. **Products:** Roles can be assigned when creating a product by selecting members from each role dropdown menu. ![Adding roles for a product](https://docs.huly.io/_astro/roles-product.BOMXn9m4_JFEmL.webp) To assign roles from a product that’s already been created, use the right side panel to add members to each role. **Trainings:** Open your workspace settings and select `Trainings`. From there, you can assign roles to team members using the dropdown menus. ![Adding roles for a training](https://docs.huly.io/_astro/roles-trainings.BxX1oTul_1oFHKk.webp) --- # Trainings | Huly Docs [Skip to content](https://docs.huly.io/additional-modules/trainings/#_top) Trainings ========= The Trainings module is enabled by default in [TraceX](https://docs.huly.io/getting-started/introduction-tracex) workspaces. Trainings consist of custom questions and answers that can be used to assess the knowledge of employees on a specific topic, and can be assigned to individuals or groups. To learn how to create and assign trainings, watch Trainings Part 1: To learn how to take a training that’s been assigned to you, and how to monitor the results of the trainings you’ve assigned, watch Trainings Part 2: Creating a training ------------------- To create a training, open the `My trainings` sub-menu in the Trainings module and click the `+ Training` button in the top right corner. Enter a name for your training and click `Create`. Once your training is created, you’ll have access to additional settings and customizations. You can add a description of your training and add any supporting attachments needed, such as videos or presentations. ### Adding questions Navigate to the `Questions` tab of your training and click the `+` button to begin adding questions. You can add single-choice, multiple-choice and ordering questions. Select the correct answers for each question. ### Setting a passing score Click on the green score bar at the top of your questions to set a passing score for your training, indicating the number of questions the trainee must answer correctly to pass. ### Releasing a training Once you’ve finished creating questions, setting the passing score, and adding any description or supporting attachments needed, click `Release` in the top right corner to finalize your training. Trainings cannot be assigned until they are released. Assigning a training -------------------- Trainings can be assigned on their own from the Trainings module, or attached to a controlled document. ### From the Trainings module Click `Assign request`. From here, you’ll be able to select which roles and members to assign the training to, as well as a due date and maximum number of attempts allowed. ### From a controlled document Navigate to the document you’d like to attach the training to and open the `Release` tab. Toggle the Training setting and select the training you’d like to attach. From here, you can select the roles and members to assign the training to, and set the due date and maximum number of attempts allowed. Once the document approval process has been completed and the document status is `Effective`, the training requests will be sent to the trainees. For more on this process, see our guide on [review and approval](https://docs.huly.io/controlled-documents/review-approval) . Taking a training ----------------- Assignees will receive training requests in their email and inbox. Assigned training requests can also be found in the Trainings module under the `My requests` sub-menu. Begin taking a training by clicking on it to open. > **Note:** If a trainee fails the max attempts allowed, a new training request will need to be sent. --- # 404 | Huly Docs [Skip to content](https://docs.huly.io/communication/transcription#_top) 404 === Page not found. Check the URL or try using the search bar. ---