🚩 Getting Started
Essential information for new users, covering login details and basic instructions to kickstart app usage.
How do I get started with the Puzzle app?
How do I get started with the Puzzle app?
To get started, sign in with your provided credentials. Once logged in, you'll land in your company workspace, where you can begin building your workflows and teams.
What should I do if I'm new to workflow management?
What should I do if I'm new to workflow management?
If you're new to workflow management, we recommend exploring our built-in tutorials and guides within the app. These resources will help you get acquainted with the features and functionalities.
How can I create my first Section and Step?
How can I create my first Section and Step?
To create your first Section and Step, navigate to the relevant section of your workspace and use the "Add Section" or "Add Step" buttons. You can then customize and structure them as needed.
How do I assign roles to team members in the Team Builder section?
How do I assign roles to team members in the Team Builder section?
In the Team Builder section, you can assign roles to team members by selecting the role and team member's name. This helps clarify responsibilities within your organization. Please take a look at this guide for more information.
What is the Templates feature in the Puzzle app?
What is the Templates feature in the Puzzle app?
The Templates feature in the Puzzle app allows you to save, reuse, and share pre-designed process flows or sections, streamlining your workflow creation.
How do I create a template in the Puzzle app?
How do I create a template in the Puzzle app?
To create a template, select the section you wish to save as a template, provide details like name and description, and decide whether to make it public.
What's the best way to organize my workspace effectively?
What's the best way to organize my workspace effectively?
Start by creating Sections that represent your departments or processes. Then, add Steps within each Section to outline specific tasks. Use Teams to assign roles and responsibilities within your organization.
How can I delete a workspace that I accidentally created?
How can I delete a workspace that I accidentally created?
If you accidentally created a workspace and need to delete it, you can make it inactive first. Once inactive, the delete button will be enabled, and you can delete the workspace. You can delete the workspace if you have permission to view it.
Note: Always exercise caution when deleting workspaces, as this action is irreversible and will permanently remove all data associated with the workspace.
🤝 Team Collaboration
Insights into team-related queries, focusing on questions about teams, collaborations, and user roles.
How do I invite team members to my Company Workspace?
How do I invite team members to my Company Workspace?
To invite team members, go to your Company Workspace > click on the People's tab > click on "Add Users" located at the bottom left part of the canvas > send an invitation to your team member's email address. To learn more about managing your team members' accounts, go to this Step.
How do I assign roles to team members in the Team Builder section?
How do I assign roles to team members in the Team Builder section?
In the Team Builder section, you can assign roles to team members by selecting the role and team member's name. This helps clarify responsibilities within your organization.
What's the purpose of the Comments and Tasks features?
What's the purpose of the Comments and Tasks features?
Comments allow you to discuss and collaborate on specific Steps, while Tasks help you break down work into actionable items. These features enhance communication and task management.
Can I customize the Roles in the Team Builder section?
Can I customize the Roles in the Team Builder section?
Yes, you can customize roles to match your organization's specific job titles and responsibilities. This flexibility allows you to tailor roles to your unique needs.
How can I create a View to share my work with others?
How can I create a View to share my work with others?
To create a View, click the "[◉] Public/Shareable Views: button, add a view, and select the section/workflow you want to share. A link will be generated to share with team members or external collaborators. To learn more about creating or managing your Views, check out our help article here.
Can I share templates with my team or workspace?
Can I share templates with my team or workspace?
Yes, you can choose to make templates public, allowing all members of your workspace to access and use them, fostering collaboration and uniformity.
How do I share my workflows or content with external collaborators or clients?
How do I share my workflows or content with external collaborators or clients?
You can share content with external collaborators or clients by creating a View and selecting the sections/workflows you want to share. You can then share the View's link with external parties.
⚙️ Managing Your Account, Access & Support
Assistance in managing your account, accessing accounts, troubleshooting, and seeking support for users' challenges.
What should I do if I forget my login credentials?
What should I do if I forget my login credentials?
Click Forgot your Password on the login page and enter your email address, and we'll send a password reset link to your inbox.
Is there a mobile app available for the Puzzle app?
Is there a mobile app available for the Puzzle app?
No, we are currently only operating on a desktop.
How can I provide feedback or request assistance with the app?
How can I provide feedback or request assistance with the app?
If you encounter issues or errors, refer to the app's Get Support Center at the bottom right corner of your workspace. You can also fill out this form to report any product issues, feature requests, and quality issues that you’ve detected.
How do I troubleshoot common issues or errors in the app?
How do I troubleshoot common issues or errors in the app?
If you encounter issues or errors, refer to the app's Get Support Center at the bottom right corner of your workspace. You can also fill out this form to report any product issues, feature requests, and quality issues that you’ve detected.
How can I update my plan/subscription?
How can I update my plan/subscription?
For plan updates, use the support widget to navigate to the billing portal, enter your subscription email, and follow the confirmation link in the email. Once in the billing portal, easily explore options to modify your Puzzle App plan, be it transitioning between tiers, adjusting agency numbers, or changing billing frequencies.
For a comprehensive step-by-step guide, follow the link to access the full article on managing your Puzzle App account.
How do I cancel my plan/subscription?
How do I cancel my plan/subscription?
To cancel your Puzzle App subscription, access the support widget, click on "Billing Portal (For Admins Only)," enter your subscription email, and follow the confirmation link in the received email to access the billing portal. There, you'll find straightforward options to cancel your subscription.
For a comprehensive step-by-step guide, follow the link to access the full article on managing your Puzzle App account.
💡 Functionality & Advanced Features
In-depth exploration of the app's advanced features, providing users with a deeper understanding of its capabilities.
How can I add a tool that's not in the Puzzle App list?
How can I add a tool that's not in the Puzzle App list?
Adding a new tool is simple. Just navigate to the desired step, click on "Add a Tool," choose "New Tool," input its name and website, and the system auto-finds the favicon. Hit save to finish. If the favicon isn't found, email [email protected] with tool details for manual addition.
Is there a limit to the number of Sections or Steps I can create?
Is there a limit to the number of Sections or Steps I can create?
No limit, as the Puzzle app is designed to scale with your organization. You can add new Sections, Steps, and Roles as your business expands.
How can Templates benefit my workflow processes?
How can Templates benefit my workflow processes?
Templates help you save time by providing pre-designed, customizable structures that can be applied to various workflows, ensuring consistency and efficiency.
How do I track changes or revisions made to a workflow over time?
How do I track changes or revisions made to a workflow over time?
Great question! We are excited to announce that an activity log will be launching soon.
Does your system automate tasks like Zapier?
Does your system automate tasks like Zapier?
No, Puzzle is primarily a documentation, training, and observability tool that sits on top of all of your tools ("tool of tools," so you're able to see how they work together). You’d use it to plan what you’re going to build & automate.
Can we integrate the Puzzle app with other software or tools we use in our organization?
Can we integrate the Puzzle app with other software or tools we use in our organization?
Yes, Puzzle integrates with various software and tools. Currently, we offer integration with HubSpot. For more details on how to integrate HubSpot with Puzzle, please click here. Stay tuned for updates on additional integrations!
Can I create advanced workflows that involve conditional logic and branching?
Can I create advanced workflows that involve conditional logic and branching?
Yes! Use labels on connectors to indicate branching and IF / THEN statements using Conditional step type.
How does the Puzzle app support scalability as my organization grows?
How does the Puzzle app support scalability as my organization grows?
The Puzzle app is designed to scale with your organization. You can add new Sections, Steps, and Roles as your business expands. This scalability ensures the app remains a valuable tool as your needs evolve.
What happens if a team member leaves the organization?
What happens if a team member leaves the organization?
If a team member leaves, you can reassign their roles and responsibilities within the Team Builder section.
Can I export or print my workflow for offline use or documentation?
Can I export or print my workflow for offline use or documentation?
Not at the moment, but you can take a screenshot instead! Our product team is currently working on adding a "PDF" feature. While we don't have a specific release date yet, it is a feature we plan to implement soon.
Is there a way to archive or hide old Sections or Steps?
Is there a way to archive or hide old Sections or Steps?
There isn't a way to "hide," but you can technically "archive" a step as a status. This will place an archive block on the step, but it will not be permanently deleted from your workspace until you choose to delete it.
💡 Step Cost Calculator
Learn how to input necessary data, understand the benefits, and discover how this tool can help you demonstrate the financial impact and return on investment of your process improvements.
What is the Step Cost Calculator feature in Puzzle?
What is the Step Cost Calculator feature in Puzzle?
The Step Cost Calculator automatically calculates the cost of each process step based on the time required, the frequency of occurrence, and the hourly rate of the responsible role.
How do I input the necessary data for the Step Cost Calculator?
How do I input the necessary data for the Step Cost Calculator?
Follow these steps:
Ensure that you've assigned the estimated hourly rate for the role responsible for the step for automatic calculation.
Enter the time required for each process step.
Specify how often the step occurs monthly
If the step occurs quarterly, input .334 to represent that it occurs once every 3 months; if the step occurs semi-annual, enter .167, etc.
How does the Step Cost Calculator benefit my business?
How does the Step Cost Calculator benefit my business?
It provides clear, quantifiable proof of cost savings, enhances transparency, aids in better decision-making, increases efficiency by reducing manual calculations, and gives you a competitive edge by showcasing the financial impact of your processes.
Can I use the Step Cost Calculator to demonstrate ROI to stakeholders?
Can I use the Step Cost Calculator to demonstrate ROI to stakeholders?
Yes, by comparing the cost of manual processes with automated ones, you can clearly show the financial benefits and return on investment to stakeholders.
How does the Team Designer enhance the Step Cost Calculator feature?
How does the Team Designer enhance the Step Cost Calculator feature?
The Team Designer allows you to create roles, assign them to process steps, and ensure each role has an associated hourly rate, facilitating accurate cost calculations.
How do I create a role in the Team Designer for accurate cost calculations?
How do I create a role in the Team Designer for accurate cost calculations?
Go to the Team Designer section in Puzzle, create the necessary roles, assign them to relevant process steps, and ensure each role has an associated hourly rate. If the associated role is salaried, you can divide their annual salary by the total working hours in a year (2080 working hours) to calculate the equivalent salary).
What makes Puzzle’s Step Cost Calculator different from other diagramming tools?
What makes Puzzle’s Step Cost Calculator different from other diagramming tools?
Unlike traditional diagramming tools like Miro and Lucidchart, Puzzle not only creates process diagrams but also calculates the financial impact of your processes, helping you demonstrate the value of your work.
What types of costs does the Step Cost Calculator estimate?
What types of costs does the Step Cost Calculator estimate?
The calculator estimates the cost per run, monthly step cost, and annual step cost for each process step.
What information do I need to gather before using the Step Cost Calculator?
What information do I need to gather before using the Step Cost Calculator?
You need to know the time each process step takes, how often it occurs, and the estimated hourly rate for the role responsible for that step.
🔗 Integrations
Explore seamless integration processes for external software and tools with Puzzle, starting with our latest addition - HubSpot, Make, and Zapier Import Action.
Hubspot Integration
What is Puzzle's HubSpot integration, and what does it offer?
What is Puzzle's HubSpot integration, and what does it offer?
Puzzle's HubSpot integration allows seamless synchronization of HubSpot workflows and forms directly into the Puzzle platform. It provides users with easy-to-understand synced flowcharts, real-time insights, and effortless mapping of workflows, saving time and effort in workflow management.
Which features are currently available with Puzzle's HubSpot integration?
Which features are currently available with Puzzle's HubSpot integration?
Currently, the integration syncs All Workflows types and All Forms within your HubSpot instance.
When can we expect additional features such as Company, Deal, and Ticket workflows to be integrated?
When can we expect additional features such as Company, Deal, and Ticket workflows to be integrated?
It's live as of August 22nd, 2024. Users are able to fetch all workflow types — Contact, Company, Deal, Ticket and Custom Workflows into their diagrams.
How do I integrate Puzzle with my HubSpot account?
How do I integrate Puzzle with my HubSpot account?
You can follow the below steps.
Connect your HubSpot Account
Sync HubSpot Workflows
Add Workflows to Your Map
Connect Existing Steps to HubSpot Items
For a comprehensive step-by-step guide, follow the link to access the full article on HubSpot Integration Guide.
Make Integration
What is Puzzle's Make integration and its benefits?
What is Puzzle's Make integration and its benefits?
Puzzle's Make integration synchronizes Make Scenarios with Puzzle's workflow canvas, providing automatic, visually rich documentation. Benefits include real-time updates, enhanced collaboration, and saving time through automated, accurate documentation.
How do I add Make to my Puzzle workspace and integrate it?
How do I add Make to my Puzzle workspace and integrate it?
Add Make to Workspace:
Go to the Tools section in your Workspace.
Find Make in the left sidebar and add it to your canvas using the "➕" button.
Click the Make box to see details on the tool's sidebar on the right.
Generate API Key:
Log in to your Make account.
Access your profile settings and generate a new API key.
Label the key and copy the code.
Paste the code into the API token input field within the Make sidebar in Puzzle.
Find Team ID:
In Make, click on "Team" in the left menu.
Check the URL for the Team ID, located between "make.com" and "/team".
Copy the Team ID number and paste it into the Team ID input field in Puzzle.
Select Region:
Check the URL when logging into Make to find your account's hosting region (e.g., US1, EU1).
Select the correct region in the dropdown menu in Puzzle's Workspace.
Complete Integration:
Click "Integrate" and verify your newly connected account appears in black text.
How do I identify the region where my Make account is hosted?
How do I identify the region where my Make account is hosted?
When logging into Make, check the URL to find your account's hosting region (e.g., US1, US2, EU1, EU2). Select the correct region in the dropdown menu in your Puzzle Workspace during integration.
How do I synchronize and add Make scenarios to Puzzle?
How do I synchronize and add Make scenarios to Puzzle?
In the Workflows tab, toggle the integration sidebar, click the sync icon to fetch scenarios, and select scenarios to add by clicking the ➕ button next to each workflow. This will show up to 50 historical runs and links to specific workflows and runs in the connected steps.
How do I connect existing steps in Puzzle to Make scenarios?
How do I connect existing steps in Puzzle to Make scenarios?
If you have existing steps in your Puzzle map that correspond to Make scenarios, click into those steps, click the "Sync" icon, find the related scenario in the list, and click + to associate the step with the workflow seamlessly.
What should I do if my integration is not working?
What should I do if my integration is not working?
Ensure that you have correctly entered the API token, Team ID, and selected the correct region. Double-check your settings and check Puzzle's support documentation or contact [email protected] for further assistance if issues persist.
Can I view historical data of my Make workflows in Puzzle?
Can I view historical data of my Make workflows in Puzzle?
Yes, you can view up to 50 historical runs and access specific workflow links from the connected steps in Puzzle.
How do I handle changes in my Make scenarios within Puzzle?
How do I handle changes in my Make scenarios within Puzzle?
Any changes in your Make scenarios are reflected in real time within Puzzle, keeping your documentation and workflows up-to-date without requiring manual updates.
What future enhancements can I expect from Puzzle's Make integration?
What future enhancements can I expect from Puzzle's Make integration?
Puzzle continuously develops and enhances its integration capabilities, offering greater efficiency, flexibility, and innovation in process automation. Stay tuned for new features and improvements.
Can I provide feedback or suggest new features for Puzzle's integration with HubSpot and Make?
Can I provide feedback or suggest new features for Puzzle's integration with HubSpot and Make?
Yes! Your feedback is valuable in shaping our roadmap. Please fill out this form to report any product issues, feature requests, or quality issues that you’ve detected.
What upcoming integrations can we expect from Puzzle?
What upcoming integrations can we expect from Puzzle?
Stay tuned for upcoming integrations with Zapier and more. Puzzle is committed to empowering users with tools that streamline processes and drive efficiency.
Zapier Import Action
What is the purpose of the Zapier integration with Puzzle?
What is the purpose of the Zapier integration with Puzzle?
The Zapier integration allows you to automate the creation of steps in Puzzle workflows triggered by events in over 5,000 apps. This enhances efficiency by reducing manual data entry and streamlining project management processes.
How do I set up the Zapier integration with Puzzle?
How do I set up the Zapier integration with Puzzle?
Follow these steps:
Create a new Zap in Zapier and select a trigger app and event.
Add Puzzle as the action app and choose the “Create a Step” event.
Generate an API key in your Puzzle workspace and connect it to Zapier.
Configure the step details in Zapier, test, and publish the Zap.
For a comprehensive step-by-step guide, follow the link to access the full article on Using Zapier Import Action!
How do I generate an API key in Puzzle for Zapier integration?
How do I generate an API key in Puzzle for Zapier integration?
Log in to your Puzzle account.
Navigate to the desired workspace.
Go to the Tools section and click “Generate API Key.”
Copy the generated API key and paste it into Zapier when connecting your account.
Can I connect multiple Puzzle workspaces to Zapier?
Can I connect multiple Puzzle workspaces to Zapier?
Yes, you can connect multiple Puzzle workspaces to Zapier. For each workspace, generate a unique API key, create a new connection in Zapier, and rename each connection to reflect the specific workspace.
How do I rename my Puzzle connection in Zapier?
How do I rename my Puzzle connection in Zapier?
After connecting your Puzzle account to Zapier, go to the connected accounts section.
Click on the name of the connection (e.g., Puzzle #1, Puzzle #2).
Rename it to reflect the specific workspace (e.g., Puzzle - Demo Workspace).
What types of events can trigger the Zapier integration with Puzzle?
What types of events can trigger the Zapier integration with Puzzle?
Any event from over 5,000 apps that Zapier integrates with can trigger the Puzzle integration. This includes events from Gmail, HubSpot, Monday.com, Asana, ClickUp, and many more.
How do I configure the step details in Zapier for Puzzle?
How do I configure the step details in Zapier for Puzzle?
Select the step name, which can be dynamically based on trigger inputs.
Choose the step type from the available options.
Set the step status (e.g., pending, completed).
Add any relevant step notes.
Test the action and publish the Zap.
What are some common use cases for the Zapier integration with Puzzle?
What are some common use cases for the Zapier integration with Puzzle?
Common use cases include:
Automatically creating checklist items from tools like Excel, Google Sheets, Monday.com, and Asana.
Bulk-creating steps in Puzzle workflows, saving time on manual entry.
Seamlessly integrating Puzzle with existing project management and communication tools.
What should I do if I encounter issues with the Zapier integration?
What should I do if I encounter issues with the Zapier integration?
If you encounter any issues, double-check the API key and workspace connections. Ensure that you have selected the correct trigger events and configured the step details properly. If problems persist, contact Puzzle support for assistance.
Can I automate workflows for different teams using the Zapier integration with Puzzle?
Can I automate workflows for different teams using the Zapier integration with Puzzle?
Yes, you can set up separate Zaps for different teams, each connected to their respective Puzzle workspaces. This allows for tailored automation of workflows across various teams and projects.
Zapier Integration
How do I set up the Zapier integration in Puzzle?
How do I set up the Zapier integration in Puzzle?
To set up the Zapier integration, make sure you're logged in to your Zapier account, then go to your Puzzle workspace, navigate to the Tools section, and find Zapier in the sidebar or tool library. If it’s not added, click the “➕” button to add it to your canvas. From there, click the Zapier box to open the sidebar, and select the purple sync icon to connect your Zapier account.
For a comprehensive step-by-step guide, follow the link to access the full article on Integrating Zapier with Puzzle!
Can I connect multiple Zapier accounts to Puzzle?
Can I connect multiple Zapier accounts to Puzzle?
Yes, Puzzle allows you to connect and manage multiple Zapier accounts. Once you’ve integrated an account, you can sync multiple automations from different accounts into your workflows.
How can I add my Zapier automations to a Puzzle workflow?
How can I add my Zapier automations to a Puzzle workflow?
After integrating your Zapier account, navigate to the Workflows tab in your Puzzle workspace > Toggle Integration Sidebar > Click the "🔄" icon to fetch all your existing Zapier automations. From the list, simply click the “+” icon next to the Zap you want to add to your canvas.
What should I do if I want to connect an existing step to a Zapier automation?
What should I do if I want to connect an existing step to a Zapier automation?
To connect an existing step in your Puzzle diagram to a Zapier automation, click into the step, select the "🔄" icon, and find the corresponding Zapier automation from the list. Click the “+” icon to sync it with that step, and a link to the Zapier workflow will automatically appear.
How do I disconnect a step from a Zapier automation?
How do I disconnect a step from a Zapier automation?
If you want to disconnect a step from a Zapier automation, click on the step in your canvas to open the sidebar. Then, click the purple sync icon and select the “Disconnect Step” button at the bottom of the sidebar.
Will my Zapier automations automatically update in Puzzle?
Will my Zapier automations automatically update in Puzzle?
Yes, when you sync your Zapier automations with Puzzle, they will be automatically updated. You can refresh the automation list by clicking the sync icon to ensure your workflows are always current.
How do I troubleshoot errors in my Zapier automation?
How do I troubleshoot errors in my Zapier automation?
If there’s an issue with your Zapier automations, Puzzle helps you visualize where errors occur within the broader workflow. You can click the Zapier step in the canvas to review and adjust the automation. If further troubleshooting is needed, you can open the Zap directly in Zapier via the live link provided in Puzzle.