Welcome to the Puzzle App FAQs. This guide is designed to help users understand key features, troubleshoot common issues, manage accounts, and enhance team collaboration. Whether you need assistance with billing, workflow setup, integrations, or troubleshooting errors, we’ve got you covered. Use this guide to quickly find solutions and ensure you're making the most of your Puzzle experience.
🔥 Top Questions / Trending Now
This section covers the most common and urgent questions from users, including billing, account access, refunds, and troubleshooting issues.
Can I transfer a Workspace to a new owner?
Can I transfer a Workspace to a new owner?
Yes! To transfer a Workspace to a new owner, navigate to the People Canvas, click on the person you want to assign as the new owner, and toggle their permissions on their People Card to 'Owner.' You can then change your role to Admin or Editor if you no longer need full ownership.
Can I move a section into another Workspace and hand off processes to a client for them to own in their Puzzle account?
Can I move a section into another Workspace and hand off processes to a client for them to own in their Puzzle account?
Yes! There are two primary ways to transfer ownership of a client’s processes:
If your client's processes are currently mapped in their own Workspace within your Puzzle Account, you can switch the Workspace’s Owner in the People tab to a client contact. This will automatically update billing, prompting the client to start their plan. This method allows agencies to transfer ownership without manually moving any processes.
If your client's processes are mapped in your Workspace and need to be moved to theirs, you can use the Template feature to save them as a template and deploy them into their own separate Workspace. After transferring the processes, follow Option 1 above to officially transfer ownership if the client wants their Puzzle account.
How do I cancel my Puzzle subscription?
How do I cancel my Puzzle subscription?
To cancel your Puzzle App subscription, access the support widget, click "Billing Portal (For Admins Only)," or follow this link, 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. If you need assistance, follow the step-by-step guide in Managing Your Account or contact our support team at [email protected].
I forgot to cancel my free trial and got charged. Can I get a refund?
I forgot to cancel my free trial and got charged. Can I get a refund?
If you forgot to cancel your subscription before the trial ended, you can request a refund within 30 days of the trial expiring. Visit the Billing Portal, enter your subscription email, and follow the prompts to request a refund. Our team will review your request before approving it.
I didn’t use the app, but I was charged. Can I get a refund?
I didn’t use the app, but I was charged. Can I get a refund?
If your account shows no login activity or usage for a significant period, you may be eligible for a refund. Contact our support team with details, and we will review your case based on our inactivity refund policy
Why am I not receiving the password reset email?
Why am I not receiving the password reset email?
If you're not receiving the reset email:
Ensure you entered the correct email associated with your account.
Check spam/junk folders in case the email was filtered.
If you subscribed via Stripe but didn’t complete your Puzzle account registration, you need to register first. Visit this link to set up your account.
If you still have issues, contact [email protected].
Can I export my workflows to a PDF or another format?
Can I export my workflows to a PDF or another format?
Currently, PDF export is not available, but this feature is planned for future updates. In the meantime, you can take a screenshot of your workflow, use your browser’s print-to-PDF function or use Views to share workflows externally in a structured, interactive format.
Why is my workspace not updating or showing a connection error?
Why is my workspace not updating or showing a connection error?
If you see a network error when accessing a specific tab, check your internet connection and refresh the page.
If updates to notes, tools, or workflow elements aren’t saving, try logging out and back in.
If the issue persists, report it via the Get Support Center or contact [email protected].
How do I send feature requests or report issues?
How do I send feature requests or report issues?
You can report any product issues, feature requests, or quality concerns using our feedback form or by reaching out through our support email. This helps our team track improvements and address any bugs effectively.
How can I make a step jump to another step or workflow?
How can I make a step jump to another step or workflow?
You're looking for the Go-To Step!
In the Step Type dropdown, select Go-To, which allows you to jump from one step to another, even if it's in a different part of the workflow or a separate workflow entirely. This helps streamline processes and improve navigation within complex workflows.
Why am I not receiving the Stripe billing portal link?
Why am I not receiving the Stripe billing portal link?
If you’re not receiving the Stripe billing portal link in your email, it’s likely because the email associated with your Puzzle account is different from the one you used for your Stripe subscription.
✅ What You Can Do:
Do you have another email that your Stripe subscription could be under? Try checking that inbox.
Still can’t find it? Reach out to us at [email protected], and we’ll help locate your subscription or assist with any billing concerns.
💡 Tip: Always use the same email for both Puzzle and Stripe to avoid billing access issues in the future.
Why can’t I assign someone as a Viewer (Read-Only) anymore?
Why can’t I assign someone as a Viewer (Read-Only) anymore?
We've removed the Viewer permission for invited people within a Workspace because the Viewer tag didn’t actually restrict any actions within the Workspace.
We’ll be bringing it back in the future, but until then, if you need "View-Only" permissions, you can use Public Shareable Views as an alternative.
Why can’t I see certain inputs in my step sidebar?
Why can’t I see certain inputs in my step sidebar?
If an input is missing from the sidebar, it’s likely disabled in your workspace settings. Check Step Sidebar Configuration in Workspace Settings and ensure the input is turned ON. Learn more about Step Sidebar Configuration here.
📝 Getting Started
This section provides essential setup instructions for new users, including workspace creation and navigation.
How do I get started with the Puzzle app?
How do I get started with the Puzzle app?
To get started, sign in with the email and password you used when signing up. Once logged in, you'll land in your company workspace, where you can begin building your workflows and teams.
What are Sections and Steps, and how do they help structure my workflows?
What are Sections and Steps, and how do they help structure my workflows?
How do I create my first workspace, section, and step?
How do I create my first workspace, section, and step?
To create a workspace, log into Puzzle and click Create New Workspace from the dashboard.
Once inside, use the Add Section to organize your workflows.
Click Add Step within a section to start building your process. Define the step details, assign roles, and link any necessary tools.
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 just starting with workflow management, we suggest checking out the app's built-in tutorials, video guides, and resources. These materials will assist you in becoming familiar with the app's features and functions. Additionally, feel free to look through our Help Articles.
What are the best practices for organizing my workspace?
What are the best practices for organizing my workspace?
Use Sections to categorize workflows, apply Step Colors for clarity, and assign roles to streamline collaboration. Keeping related workflows together makes navigation easier.
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 want to save as a template, provide details such as a name and description, and decide if you want to make it public. You can also check out our step-by-step guide for more detailed information.
How do I use templates to speed up workflow creation?
How do I use templates to speed up workflow creation?
Templates let you save, reuse, and share workflow structures for faster deployment. You can choose from pre-built templates or create custom ones. Templates help maintain consistency across processes and reduce setup time.
How do I navigate the Puzzle App interface efficiently?
How do I navigate the Puzzle App interface efficiently?
Familiarize yourself with the dashboard, side navigation, and workspace views. Use keyboard shortcuts for quick actions and leverage search functionality to locate workflows faster.
How do I add a new tool to my workspace if it’s not listed in the Puzzle library?
How do I add a new tool to my workspace if it’s not listed in the Puzzle library?
If the tool you need is not available in the Puzzle Tools Library, you can manually add it by following these steps:
Go to the Tools Tab and click the 🔍 icon to open the Puzzle Tools Library.
If the tool does not appear in the search results, click "Create a new tool."
Enter the Tool Name and Tool Link (URL).
Once you enter the URL, Puzzle will attempt to fetch the tool’s favicon (logo) automatically.
Click Save, and the tool will now be added to your workspace and available for integration into workflows.
You can now assign this tool to workflow steps, track its cost, and set renewal reminders within the Tool Canvas.
What do I do if the tool’s favicon (logo) fails to load while I'm adding it?
What do I do if the tool’s favicon (logo) fails to load while I'm adding it?
If the tool’s icon does not appear automatically, email [email protected] with the tool details, and our team will manually add it.
How can I delete a workspace that I accidentally created?
How can I delete a workspace that I accidentally created?
Make the workspace inactive first; once inactive, the delete button will be enabled, allowing you to delete the workspace. Note: This action is irreversible and will permanently remove all associated data.
Can I have multiple workspaces in Puzzle?
Can I have multiple workspaces in Puzzle?
Yes! Puzzle allows users to create and manage multiple workspaces. You can switch between them using the Workspace Selector in the dashboard
🤝 Team Collaboration
Learn how to manage teams, assign roles, and collaborate effectively within Puzzle.
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.
How can I assign roles and permissions to team members?
How can I assign roles and permissions to team members?
In the People Tab, select a team member and choose their role: Admin, Editor, or Viewer.
Admins have full control, Editors can modify workflows, and Viewers have read-only access.
How do I remove a team member from my workspace?
How do I remove a team member from my workspace?
To remove a user from the workspace, Go to the People Tab, Select the User, and click Remove from Workspace. This will take effect immediately, although the user's contributions will still be visible in workflows.
How can I create a View to share my work with others?
How can I create a View to share my work with others?
📑 Workflow Management & Process Optimization
Everything you need to know about building, editing, and optimizing workflows.
What is the best way to optimize a complex workflow?
What is the best way to optimize a complex workflow?
Break large workflows into smaller, manageable sections, use labels and color coding, and periodically review step efficiency to remove bottlenecks.
How do I create and customize Steps in a workflow?
How do I create and customize Steps in a workflow?
To create a step, click Add Step within a Section and define the details, including the title, description, assignees, and linked tools. Steps can be customized to include specific instructions, automation triggers, and assigned team members.
What is Conditional Step Coloring, and how does it work?
What is Conditional Step Coloring, and how does it work?
Conditional Step Coloring visually highlights key steps based on defined conditions. You can apply color-coding to steps to indicate priority levels, approvals, or workflow status, making it easier to track progress at a glance.
Why are my Conditional Step Coloring updates not appearing?
Why are my Conditional Step Coloring updates not appearing?
If changes are not reflected, try refreshing the page. Sometimes, updates take a moment to sync properly.
Can I create conditional logic or branching in a workflow?
Can I create conditional logic or branching in a workflow?
Yes! You can use Connector Labels to define conditional paths in your workflow. Additionally, you can use the Conditional Step Type, which changes the step shape to a diamond following BPMN (Business Process Mapping Notation). This helps visually indicate decision points in your process and ensures clarity when designing complex workflows.
How do I delete a workflow or archive a step?
How do I delete a workflow or archive a step?
Puzzle does not currently support archiving entire workflows. However, you can archive individual steps within a workflow by changing their Step Status to 'Archived' from the step settings.
🔗 Integrations & Automation
Connect Puzzle with other tools to enhance automation and efficiency.
What integrations does Puzzle support?
What integrations does Puzzle support?
Currently, it seamlessly integrates with HubSpot, Zapier, and Make. We're dedicated to continually expanding our integration ecosystem to empower your workflows like never before. Keep an eye out for exciting upcoming features that will further optimize automation and elevate your business efficiency to new heights!
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.
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.
For a comprehensive step-by-step guide, follow the link to access the full article on Make Integration Guide.
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.
What should I do if my Make integration is not working?
What should I do if my Make integration is not working?
Ensure you have correctly entered the API token, Team ID, and selected the correct region. Double-check your settings and check our Make Integration Guide or contact support@puzzleapp.io for further assistance if issues persist.
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.
Can I edit or manage Zaps inside Puzzle?
Can I edit or manage Zaps inside Puzzle?
While you can’t edit a Zap directly in Puzzle, you can use Puzzle to view, enable, or disable linked Zaps and access them quickly for updates.
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.
What is the Zapier Import Action, and how is it different from the Zapier integration?
What is the Zapier Import Action, and how is it different from the Zapier integration?
The Zapier Import Action allows you to automatically create steps in Puzzle based on triggers from Zapier apps. Unlike the general Zapier integration, which helps track and manage automations, the Import Action is a specific function that adds steps to workflows in real-time.
How do I set up the Zapier Import Action?
How do I set up the Zapier Import Action?
In Zapier, create a new Zap, select a trigger app, then choose Puzzle > Create Step as the action. Connect your Puzzle account and configure the step details like name, status, and assigned users.
What should I do if my Zapier Import Action isn’t working?
What should I do if my Zapier Import Action isn’t working?
Check that your API key is valid and that Zapier is properly connected to Puzzle. Ensure that the trigger app is sending data correctly, and test the Zap to troubleshoot errors.
Can I provide feedback or suggest new features for Puzzle's integration?
Can I provide feedback or suggest new features for Puzzle's integration?
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.
⚙️ Account Management, Access & Billing
A guide to managing your Puzzle App account, handling subscriptions, troubleshooting access issues, and updating billing details.
What should I do if I forget my password?
What should I do if I forget my password?
If you forgot your password, click Forgot Password on the login page, enter your registered email, and follow the link sent to your inbox to reset it. If you’re not receiving the email, check your spam folder or contact [email protected].
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 update my billing details or payment method?
How do I update my billing details or payment method?
To update your billing information:
Access the Billing Portal through the Support Widget.
Enter your email and follow the link sent to your inbox.
Update your credit card or payment details. Changes will apply to the next billing cycle.
How do I download invoices or receipts for my subscription?
How do I download invoices or receipts for my subscription?
Invoices and receipts can be accessed through the Billing Portal.
How do I add or remove users from my company’s subscription?
How do I add or remove users from my company’s subscription?
Admins can manage team members in the Company Workspace > People Tab. New users can be invited, and inactive users can be removed, adjusting seat counts accordingly.
What happens if my payment fails?
What happens if my payment fails?
If your payment fails, you will receive an email notification, and a retry attempt will be made. Ensure your payment method is updated in the Billing Portal to avoid service interruptions.
How do I contact support for account or billing issues?
How do I contact support for account or billing issues?
For account or billing assistance, reach out via:
Support Widget in the app.
Email [email protected].
Visit our Help Center for troubleshooting guides.
💡 Advanced Features & Customization
Exploring high-level functionalities to maximize Puzzle’s potential.
How can I calculate the cost of each step in my workflow?
How can I calculate the cost of each step in my workflow?
The Step Cost Calculator in Puzzle allows you to track the financial impact of each workflow step by assigning hourly rates to roles. Puzzle then automatically calculates the cost based on the estimated time spent on that step. This feature helps with budgeting, resource allocation, and justifying automation costs by providing clear cost insights within your workflow.
Where do I enter cost details for my steps?
Where do I enter cost details for my steps?
You can enter cost details directly within the Step Sidebar:
Open the workflow step you want to track.
Assign a role with an hourly rate to the step.
Puzzle will automatically calculate the cost based on the assigned rate and estimated time spent on that step.
The total workflow cost can be seen at a glance, allowing for better cost control and decision-making.
Can I download a report of my workflow costs?
Can I download a report of my workflow costs?
Currently, cost tracking is visualized within Puzzle, but an export feature for downloading cost reports is in development. Stay tuned for updates!
How can I highlight workflow steps with colors?
How can I highlight workflow steps with colors?
Conditional Step Coloring allows you to set custom rules to automatically color-code steps based on specific conditions like tool usage, assigned roles, or workflow status. This makes it easier to analyze processes, manage changes, and present workflows to stakeholders by bringing instant clarity to your diagrams.
How do I set up Conditional Step Coloring?
How do I set up Conditional Step Coloring?
You can enable Conditional Step Coloring by following these steps:
Click the paintbrush icon in the left toolbar to open the settings.
Click + Add Rule to create a new condition.
Choose a criteria type (Step Status, Tools, Roles, etc.).
Assign a color to that condition, and Puzzle will automatically highlight the steps that meet your rule.
This feature ensures key workflow elements are easy to spot, improving process visibility and efficiency.
Why aren’t my colored steps updating
Why aren’t my colored steps updating
If your Conditional Step Coloring rules aren’t applying properly, try refreshing the page. Sometimes, updates take a moment to reflect in real time.
Can Puzzle help me write process notes automatically?
Can Puzzle help me write process notes automatically?
Yes! AI-Generated Notes in Puzzle can automatically create step and section descriptions based on the tools and roles involved. This ensures consistency, saves time on documentation, and helps teams stay aligned when managing workflows.
What are Entities & Attributes, and why should I use them?
What are Entities & Attributes, and why should I use them?
Entities & Attributes help track how tools, endpoints, and systems interact within your workflows. This feature is essential for:
API tracking – Understand where endpoints are used across workflows.
Managing system dependencies – Identify connections between different tools.
Reducing errors when updating workflows – Ensure smooth transitions when making process changes.
By using Entities & Attributes, teams can maintain a structured and clear view of their automation landscape.
How do I add an entity to a step?
How do I add an entity to a step?
Open the step sidebar in your workflow.
Click on Attributes.
Select an existing entity or create a new one to document how a tool or system is being used within that step.
This feature enhances process documentation and operational efficiency by making connections between tools and workflows more transparent.
Can I track how much my tools cost?
Can I track how much my tools cost?
Yes! The Tool Canvas in Puzzle provides a structured way to track the costs of all your business tools in one place. You can enter the monthly or annual cost of each tool, and Puzzle will automatically calculate total expenses for your workspace.
The Cost Summary panel on the right sidebar gives you an instant breakdown of:
✅ Total Monthly Costs – The combined cost of all active tools per month.
✅ Total Annual Costs – The total yearly expenses for all active tools.
✅ Total Number of Active Tools – A quick count of the tools currently in use.
Additionally, you can set renewal dates for each tool, helping you track upcoming subscription payments and avoid unexpected charges. If any cost details are missing or outdated, you can update them at any time within the Tool Canvas.
Can I see where a tool is being used across my workflows?
Can I see where a tool is being used across my workflows?
Yes! When you click on a tool in the Tool Canvas, the sidebar will show a list of all workflow steps where that tool is currently used. Clicking any of these steps will take you directly to the relevant part of your workflow.
How can I suggest a new feature for Puzzle?
How can I suggest a new feature for Puzzle?
We’d love your input! You can submit feature requests or vote for upcoming ideas on our Feature Request Board:
Our team regularly reviews feedback to enhance Puzzle’s capabilities.
What are Tabs in Puzzle, and how do they help organize my workflows?
What are Tabs in Puzzle, and how do they help organize my workflows?
Tabs allow you to organize different sections of your workspace for faster navigation and better workflow management. Instead of switching between multiple screens, you can keep relevant workflows, tools, or documentation accessible in separate tabs within the same workspace. This improves efficiency by reducing clutter and making it easier to switch between related processes.
Can I customize Tabs to fit how my team works?
Can I customize Tabs to fit how my team works?
Yes! You can rename, rearrange, and add new Tabs based on how your team organizes workflows. Simply click the + (plus) icon to create a new Tab, then assign workflows or tools to it. This allows you to structure your workspace in a way that makes sense for your processes.
Get More Help
Still have questions? Contact us at [email protected], or visit our Help Center for more guides.