Troubleshooting

Use this guide to diagnose common Flowize access, configuration, validation, and processing issues. Find the product area below, then match the symptom you see.

Before you begin:

1. Confirm that you are signed in to the correct organization.
2. Confirm that you opened the correct project or environment.
3. Check whether the page, action, or item is limited by your role, permissions, item status, or project group access.
4. Save pending changes before testing a configuration.

Account access and sign-in

I cannot create a Flowize account

Flowize accounts can only be created from an invitation. There is no separate self-service account creation flow. Ask an administrator to invite you, then open the link in the invitation email.

My invitation link has expired

Invitation links expire after 14 days. Ask your administrator for a new invitation.

I signed in, but Flowize asks for another code

Two-factor authentication is enabled for your account. Enter the six-digit code from your email or authenticator app. If email authentication is available, you can request a new email code.

I forgot my password

Select Forgot password? on the sign-in page, request a reset email, and use the link in that email to create a new password.

I cannot see the organization I need

Confirm that you selected the correct organization. If the organization is not available, contact your Flowize administrator or support team.

See Onboarding and Welcome to Flowize.

Organizations, groups, and projects

I do not see the option to create a project

Your account may not have permission to manage projects. Ask your organization administrator to confirm that you have the required permission and are working in the correct organization workspace.

I cannot select a project group when creating a project

Every project must belong to a project group. The available groups depend on your group access. Ask your organization administrator to confirm that an appropriate group exists and that you can access it.

I created a project, but it does not appear in the Projects menu

Refresh the workspace, then check the Projects menu and Latest projects on My Work. If the project is still missing, confirm that:

• You created it in the correct organization workspace.
• It belongs to the expected project group.
• You have access to that group.

Why can I see a group but not all its projects, or a project but not all actions?

Group membership controls which projects you can access. Your role and permissions control what you can do in those projects.

See Create a project, Project group, and Projects.

Data retention and cleanup

I cannot see Data Management or save retention settings

Open the project's Settings under Manage. Data Management appears only when your account has access to delete project data. Saving retention settings also requires access to save project settings. Ask your administrator to review these rights if the section or save action is unavailable.

My retention settings will not save

Use whole-number durations and select Day, Month, or Year. Batch retention requires a positive duration; leaving it empty or entering 0 prevents saving. For Data records retention and Webhooks retention, an empty duration or 0 disables automatic retention for that category. Select Save to apply retention changes.

I saved retention settings, but old data is still present

Automatic deletion runs during background cleanup. Saving the settings does not start cleanup immediately. Check the duration and unit for the relevant category; data record and webhook retention are disabled when their duration is empty or 0.

Data record retention uses the record's last run date and deletes only Finished, Error handled, or Reviewed records. It preserves records with Finished with an error, Paused, or Scheduled status. Webhook retention uses each response's creation date.

Delete is disabled, or one selected category was skipped

Under Delete specific data, turn on Delete My Data reports, Delete Webhook responses, or both. Delete remains disabled until at least one category is enabled. Enter both From and To for every enabled category. A category with either date missing is skipped, even if the other category is processed.

If a deletion request has no selected category, Flowize reports No data to delete.

Select Delete and confirm to request date-range deletion. Save applies retention settings; it does not request date-range deletion.

Date-range deletion did not remove the records I expected

Manual deletion uses the item's creation date, including the whole From and To days. Automatic record retention instead uses the last run date. Both record cleanup methods include only Finished, Error handled, or Reviewed records.

The success message's My Data count shows records marked for background removal, so removal may not have finished yet. Webhook Responses are deleted during the request.

Batch files were deleted, but their data records remain

Batch retention deletes batch files and batch entries with Finished or Finished with errors status. It uses the batch's finish date, or its last update date when no finish date is available. It does not delete the data records created by the batch; those follow Data records retention.

There is no batch-file date-range option under Delete specific data. Use Batch retention for automatic batch cleanup.

Records are still being removed after I disabled automatic retention

Disabling data record retention stops age-based cleanup. Records already marked for deletion can still be removed during background cleanup.

Can I recover data removed by project cleanup?

Deletion is permanent and cannot be undone. Deleting a data record also removes its execution steps and analytics. Inspect records in Reports and check the selected categories and dates before confirming deletion.

See Data retention and cleanup for retention rules and deletion steps.

Environments and Public Cloud

Why is my project not running as a production workload?

A project contains your logic and configuration. An environment is the server where the project runs with production data and settings. Build and test in the Designer, then move the project to an environment when it must run as a production workload.

The Create environment button is disabled

Complete the required environment configuration, including its name, package, region, and timezone. The package controls characteristics such as storage and actions per minute; the region and timezone affect hosting location and time-based behavior.

Why does performance differ from the package estimate?

Actions per minute are an estimate. Actual performance also depends on the app being run. For example, a custom app that calls an external API also depends on that API's response time.

Why did my table data not move with the project?

Review the Tables data section in Push to environment. Select the tables whose rows you want to copy from the source, then choose an Action to do for each selected table. Table data is an additional deployment choice. You can also import data directly into the environment.

See Deploy and update projects.

Why am I seeing a Flowize banner in generated content?

Public A includes Flowize banners in content such as websites, emails, and hosted pages. Public B and Public C do not include those banners.

Why can I send only a limited number of records in one Public Cloud batch?

The per-request limit depends on the package:

Package	Records per batch
Public A	100
Public B	250
Public C	500

Does Public Cloud have a fixed API request limit?

No fixed request count is documented. API access is subject to fair usage, defined as up to 150% of the average requests per minute made by other Public Cloud users.

If the project needs more capacity or a dedicated setup, use an environment.

See Environments, Create an environment, and Public Cloud.

Custom domains and SSL certificates

URL mapping shows Not ready yet

URL mapping cannot load while the environment is not ready. Check Environment status under General settings and wait for the current operation to finish. If the status card shows Error, follow its instruction to contact the Support team.

A hosted page or website is missing from the mapping selector

The project must be hosted in the environment. Hosted page choices come from active projects. Website choices also require an environment software version that supports website mapping, and the website must be active.

I cannot save a URL mapping

Enter a Relative URL for every row and select the hosted page or website for each mapping you want to save. Use only a path, such as /home or /, without a protocol or hostname. Absolute URLs are rejected. Select Save All URL mapping, then confirm with Save.

My saved path changed, or its external-link icon is disabled

Saving removes query strings and adds a leading /. Except for the root path /, hosted page paths have no trailing /, while website paths end in /.

After you edit a saved path, its external-link icon remains disabled until you save the change or restore the original value.

My custom domain does not open the expected content

In SSL Certificate, find the current environment IP address. At your domain provider, check that the domain or subdomain's A record points to that address. URL mapping accepts relative paths; it has no editable domain field.

Check that the intended mapping is saved and points to the correct hosted page or website. Under Current SSL Certificate, review Domain and Valid until to check the uploaded certificate.

I cannot upload or delete an SSL certificate

Certificate upload and deletion require the corresponding account rights. Ask your administrator to review your access if these actions are unavailable.

An SSL certificate upload fails

Select the upload option that matches your files:

• I have a PEM file requires a PEM file containing a readable private key and certificate. Its picker accepts .pem and .txt files.
• I have separated certificate files requires both a Private Key file and a Domain Certificate file. The domain certificate picker accepts .crt, .cer, and .txt files. The optional Root and Intermediate certificate files field accepts .ca-bundle, .crt, .cer, and .txt files and allows multiple selections.

Missing required files prevent submission. Unreadable key or certificate content can cause the upload to fail. Expired certificates are rejected; use the expiration date in the error to check your files and provide a valid certificate.

Certificate details are missing, expired, or were replaced

Certificate fields appear only when their values are available. You currently don't have an SSL certificate hosted in this Environment means the panel has no certificate details to display. An expired certificate is marked Expired beside Valid until.

Upload a valid new certificate to replace or renew the current one. Uploading overwrites the current certificate, so you do not need to delete it first. After a successful upload, check the new Domain and Valid until values.

My domain stopped working after I deleted its certificate

Deleting the certificate prevents the domain or subdomain from working in the environment. Deletion is permanent and cannot be undone. Use the certificate upload procedure to provide a valid certificate again.

See Custom domains and SSL certificates for mapping rules, DNS guidance, and certificate procedures.

Updates and storage optimization

A new Flowize version is available

When Flowize displays a new-version notification, save your work and select Reload promptly to load the new version. Continuing to work without reloading may cause some services to fail.

Update or optimization actions are unavailable

Open Updates & Optimization in the environment settings. The environment must be ready for Update now! and Save configuration to appear, or for Optimize storage to be enabled. Saving a request also requires account access to the action.

If the page shows Environment Updated, no newer software versions are available. Select See what's new to read the current version's changelog.

I confirmed a software update, but it has not finished

Confirmation schedules the update request. The success message does not mean installation has finished. Open General settings and review Environment status, the current activity, and the progress bar. The status card is hidden when the environment is ready.

If the card changes to Error, follow its instruction to contact the Support team. Open Log to review the recorded activity.

Processing stopped during an update or storage optimization

Software updates and scheduled maintenance put the environment in Maintenance, preventing it from processing or receiving data until the operation finishes. Manual storage optimization also puts the environment in Maintenance and stops processing until it finishes.

Wait for the operation to complete. When configuring recurring maintenance, choose a time that suits the projects hosted in the environment.

My recurring maintenance schedule was not saved or was canceled

Under Automation, select Install new updates, Optimize storage, or both, choose at least one day, and set the execution time. Select Save configuration and Confirm.

Saving without any days selected cancels the automation rather than scheduling it. Clearing both operation options and saving also cancels the recurring automation.

Scheduled maintenance runs at a different time than I expected

The schedule uses the environment's timezone shown beside the time field. Review that timezone and the selected days before saving. You can also find the timezone in the information table under General settings.

The environment updated without a manual update request

When new versions are available, the page displays an automatic-update notice with a release window in days. Flowize automatically updates an environment that has not been updated within that window. Check the notice for the window that applies to your environment.

Deleting records did not reduce the environment's storage usage

Storage optimization can defragment storage and recover free space after data records are deleted. Open Updates & Optimization, find Storage optimization, select Optimize storage, and confirm the maintenance warning.

Confirmation saves an optimization request. Wait for the operation to finish before expecting processing to resume. Any duration displayed on the page is an estimate.

See Environment updates and storage optimization for manual requests, recurring schedules, and progress monitoring.

Worker controls and logs

I cannot see Workers or change the worker switch

Open General settings and look under Danger zone. Workers appears when the environment's installed software supports worker controls. Your account also needs access to the environment.

If you cannot change worker status, the switch is disabled and its tooltip asks you to contact your manager.

Pending data stopped processing across the environment

Check the Workers switch. Workers paused means background workers have stopped processing pending data across the environment's hosted projects. To resume, turn on the switch and select Resume in the confirmation. Workers then pick up and process queued data, and the switch shows Workers active.

The change applies when you confirm; you do not need to select Save Details. If the environment is in Maintenance, also review Updates and storage optimization.

The worker switch returned to its previous state

Canceling the pause or resume confirmation restores the previous switch state and label. A failed request also restores them and displays an error. Review the error before trying the change again.

Where can I find who paused workers and why?

Open Log, select Search, and choose User under Action. Narrow the results by user or date. Worker changes have the action Workers, and the User column shows the user's email.

The message reports Workers have been disabled or Workers have been enabled. A pause reason appears after Reason in the disabled-workers message when one was entered. The reason is optional, so a pause entry can have no reason.

The environment log shows No messages yet or is missing recent activity

No messages yet means there are no entries to show for the current search. Select Reset search to clear the filters, then Refresh to reload the log. Use the page controls or Items per page to review more entries, and sort with Server Time or Action.

My log search disappeared after I reopened Log

Selecting the Log tab again resets the search. To reload entries while keeping the current search, use Refresh within the Log page.

See Worker controls and environment logs for pause and resume steps and log search.

Deploying and updating projects

I cannot see Push to environment

Open the project in the Designer. Push to environment appears when environment deployment is enabled. All roles can push a project to an environment. If you have no environments yet, create an environment.

A destination environment is disabled or missing

An environment with a blocking software update is disabled in the destination selector and marked with an update indicator. Update its software to the latest version before deploying a project. Environments in a critical state are excluded from destination and source lists.

Use Updates & Optimization in the environment settings to request a software update. See Environment updates and storage optimization.

I cannot select another environment as the update source

Update from another Environment is offered when another available environment hosts the project. The source must host a newer project version than the destination, and the destination is hidden from the source table. If no other available environment hosts the project, the dialog uses the Designer configuration.

After choosing Update from another Environment, select an enabled source. The update button remains disabled until a source is selected. Wait for its data choices to load before confirming.

The project update could not start

Confirm that the selected environment and project are still valid. An update also requires the destination to host the project. Follow the displayed message to try again if Flowize reports that the update process could not start.

The project update has not finished or has failed

Select Settings in the deployment notification. In the environment's General settings, review Environment status, Current activity, and the progress bar. In progress means the update is still running; Environment updated confirms success.

For Environment update failed, follow the notification's link to the environment logs, or open Log in the environment settings. If the status card shows Error, follow its instruction to contact the Support team.

For refreshing and searching those entries, see Worker controls and environment logs.

Existing static values did not change after deployment

Yes, update static schema adds keys missing from the destination and preserves values of keys already there. It does not replace those existing values. No leaves the static-schema update option off.

A deployment overwrote files or replaced stored data

Selected File Manager files overwrite destination files with the same name; selected folders merge their contents with existing folders. Copied website assets also overwrite destination website files and folders.

For tables and keystores, review Action to do. Delete current data and then Insert data empties the selected destination item before inserting source data. Insert only new data preserves existing data, while Insert new data and/or update if data matches updates matching keystore keys or table row IDs without deleting existing data. In add mode, the available action is Insert only new data.

See Deploy and update projects for source selection, included data, and progress monitoring.

Apps and integrations

An app card says the connection is still in progress

The app is missing one or more configuration steps. Open the app and complete its setup before using it in a flow.

A connected Marketplace app does not appear in the flow designer

Open the app and complete its configuration wizard. Configure the required functions, review the incoming response, and select Finish. A Marketplace app becomes available in the flow designer only after its configuration is complete.

A Marketplace function does not return the response fields I expected

Open the function's Parameters step and select Save and Test. Then open Incoming response and review the response parameters returned by the test. Map the values to the Data Schema when they need to be stored there.

Can I recover a Marketplace function configuration after uninstalling it?

No. You can install the function again, but uninstalling it deletes its configuration and that configuration cannot be restored.

Importing a cURL request removed my custom-app request settings

Importing a cURL command replaces the previous outgoing-request configuration. Review the imported URL, method, headers, payload, and parameters before saving the app.

Changing custom-app authentication affected existing flows

Authentication changes are copied to every flow that uses the custom app. Review all affected flows after changing authentication settings.

My custom-app headers disappeared

Switching Headers to No opens a confirmation to delete all headers. After deletion, the headers cannot be restored automatically; add them again manually.

I cannot add a custom-app parameter

The parameter name must be unique within the app. Also complete every field marked as required before saving the parameter.

My custom app has no incoming-response variables

Test the request first. In Incoming response, select Get from last test response to retrieve response parameters, or add header and body parameters manually. Use Save response variables when testing if you want to keep the response information.

The legacy FTP tool is unavailable or no longer updated

The FTP tool is no longer supported. Migrate existing FTP configurations to Advanced FTP, and use Advanced FTP for new FTP or SFTP work.

An Advanced FTP operation fails or cannot find a file

Confirm that the FTP account has the read, write, or delete rights required by the selected operation. Use the complete directory path and include the file extension in the file name where the function requires it. Review the returned error and error_code values for failure details.

Execute code reports an unsupported-module error

The JavaScript function runs on Node.js 20 and can import only the modules listed in the Execute code documentation. Importing any other package returns an error.

A variable makes my JavaScript code fail

Flowize replaces @ variables and macros before running the code. If the replacement value is a string, place the variable or macro inside quotes where JavaScript expects a string. Also call your function at the end of the script so the app can return its result.

My Tables Query SQL fails

Enclose every table name in square brackets, for example [my_table_name]. If the query still fails, inspect the returned message for the explanation and check whether error is true.

Tables Query returns only 200 results in the Designer

The Tables Query app is limited to 200 output results in the Designer. That limit does not apply when the app runs in your own environment.

The SMTP email tool rejects my connection or attachment

Confirm the SMTP host and secure-transfer setting with your email provider. The documented ports are 465 and 587. If the server uses authentication, provide its username and password. For an attachment, provide both its name and path; the tool supports only one attachment.

Send a Report Email rejects a recipient

Each address in Send to must belong to a user of your account. Separate multiple recipient, CC, or BCC addresses with commas. When attaching a report, include the extension in the attachment name and provide its Base64 or File Manager path.

Writing a file erased its previous content

The File Manager tool's Overwrite option replaces all existing content. Use Append when the new content must be added to the end, and choose the appropriate line terminator when appending a new line.

My Analytics metric is missing from a report

The Analytics name, Metric name, and Metric value fields are case-sensitive. Confirm that the values used by the Analytics app match the values used to filter the Storage Analytics report.

See Apps, Marketplace apps, Custom apps, and Tools. Tool-specific guidance is available for Advanced FTP, Execute code, Tables Query, SMTP email, Send a Report Email, File Manager, and Analytics.

Conditions

I cannot save a condition

Enter a condition name. The name is required. Then confirm that every rule contains the fields required by its selected operator.

The fields in a condition rule changed after I selected an operator

This is expected. The condition editor displays different fields depending on the selected operator. For example, comparison operators require a comparison value, while is empty and is not empty do not.

My condition combines rules differently than expected

Check the AND or OR control at each level. AND requires every rule at that level to match; OR requires one matching rule. A nested group has its own AND/OR setting, independent of its parent group.

I cannot duplicate a condition

Enter a name for the duplicate. Flowize copies the original rules, but a name is required to create the new condition.

Editing a condition changed a flow or content item

Conditions are shared saved configurations. Changes affect every flow or content item that consumes the condition, including conditions edited from a Decision object or content item.

A flow or content item stopped working after a condition was deleted

Deleting a condition does not remove its use from consumers safely. Any flow or content item that still references it can stop working correctly. Recreate the required condition or update each consumer to use another condition.

See Conditions.

Flows and variables

Why is my flow not processing new data records?

Check its status:

Status	What it means
DRAFT	The flow does not process data records.
PUBLISHED	The flow is ready to process data records.
PAUSED	The flow does not process new records until it is resumed.
INACTIVE	The flow no longer receives new records.

If a published version is paused and an earlier published version exists, new records go to the earlier published version.

For a flow running in an environment, also check Worker controls and logs. Paused environment workers stop background processing across hosted projects. Review Updates and storage optimization if the environment is in Maintenance.

I cannot add, remove, or rearrange apps in a published flow

Structural changes are allowed only in a DRAFT flow. Create a new version, make the changes in that draft, then publish it. A published flow permits updates only to parameter values of existing apps.

A flow action is missing

Actions in the flow overview vary by flow status and user permissions. For example, Publish is available only for draft flows, while New version applies to published flows.

My flow test fails

Check that:

• The sample payload matches the expected structure.
• Variable paths are correct.
• Every flow object is configured.
• Objects are connected to the intended path and endpoint.

Use Save and Test or Run Test to save before the test runs.

A variable does not appear in the variable picker

Variables become available only after their source has been created. Check the relevant data structure, static schema, interface, webhook, table, keystore, app, website form, or other variable source.

Interface and webhook variables require their corresponding interface or webhook configuration. Header-variable names use lowercase in Flowize, for example @interface-header.interface_example.x-usertype@.

An interface variable will not map to a data variable

The variable types must match. For example, an array variable cannot map to a non-array variable. Automatic mapping also requires matching names at the same level; always review the generated mapping.

How can I stop or continue after an app error?

Open the app's Error handling tab and enable error handling. Configure the HTTP code or code family, retry count, retry interval, and whether the flow should continue or stop. You can also create an error-handler flow from the flow save dialog.

Why will my loop not run more than 1,000 times?

Flow loops are limited to 1,000 iterations for performance reasons.

Can I recover a data record removed by an End object?

No. Removing the data record from an End object cannot be rolled back. If you need time to debug before removal, place a scheduler before the End object.

See Flows, Create a flow, and Variables.

Interfaces

I do not see New Interface

Interface creation appears only when creation is available and you have the required permissions.

The interface Save button is disabled

The save action stays disabled until the required payload or global-data-structure conditions are met. For a custom JSON, XML, CSV, or Multi Record structure, provide representative input and select Check the payload and mapping.

Check the payload and mapping returns an error or no preview

Confirm that the selected request format matches the payload and that the payload is not malformed. Flowize generates the preview, variables, and mapping only after parsing succeeds.

For JSON arrays, the first object defines the generated variables and mapping options.

My CSV interface is not parsed correctly

Check the Header, Delimiter, and Enclosure settings. Flowize rejects invalid delimiters. All lines sent to the CSV batch endpoint must contain the same number of columns.

The browser preview shows only the first 100 lines of a large CSV payload; this preview limit does not mean the input contains only 100 lines.

My Multi Record preview is incomplete or detects records incorrectly

The browser preview shows only the first 100 lines of large input. Check the record-start rule, delimiter, enclosure, field index, indicator size, header behavior, and parameter detection. Use Detect parameters to verify parameter boundaries.

Why can I not use a Raw interface for a batch?

Raw interfaces accept unstructured single-record submissions as-is. They do not support batching or data mapping.

I cannot find the Data Record endpoint

The single Data Record endpoint is enabled only for JSON and XML interfaces. Use the batch endpoint for supported batch formats.

An IP address disappears from the interface allowlist

Allowlist entries must be valid IPv4 or IPv6 addresses. Flowize removes invalid entries and displays an error. If the allowlist is enabled but contains no IP addresses, requests using the interface credentials are accepted from any IP.

A CORS origin is rejected

CORS origins must start with https:// and include a hostname. Flowize saves only the scheme and host.

The Test action is disabled

Save the interface, open Test API, and select a published flow. The Test action remains disabled until a published flow is selected.

If payload or mapping changes are unsaved, the test uses the previously saved configuration.

See Interfaces and Create interfaces.

URLs

I cannot change the interface or flow on a URL

The interface and flow can be changed only when the URL is not locked to a flow start object.

My synchronous URL did not return where I expected

A synchronous URL returns when the workflow reaches the first Stop, Run a flow, Move to flow, or End object, or when the workflow finishes with an error. Configure a global response on the URL or install and use the Sync URL app before one of those stopping points for a branch-specific response.

A dynamic URL webhook does not run

The incoming status value must match the string configured for that webhook. A webhook configured for approved, for example, is skipped when the payload contains pending.

See URLs.

Webhooks

The external service cannot call my webhook

Use the generated Custom Webhook URL and send a POST request. If IP security is enabled, confirm that the sender's IP address is included in Whitelist IPs.

Find Response or mapping does not produce fields

The example payload must be non-empty, valid, and recognized by Flowize's parser. Use Find Response after the endpoint receives a representative request, or use Paste Response or Import from file. In create mode, you can skip the sample step and add mappings manually later.

I cannot continue configuring a webhook

Every webhook requires an Identifier and Status parameter. Batch mode also requires the path containing the list of webhook events.

A webhook event is not triggering the expected flow path

Confirm that the incoming identifier and status match the listener, and that the event value is included in the webhook's configured events. You can inspect captured payloads from Responses.

My webhook flow enters a loop and stops

Do not reactivate a Normal listener + All responses in a loop. The same older response can match each newly activated listener repeatedly. Use Only new responses when each new listener must wait for a response received after that listener was created.

Persistent listeners do not need to be reactivated. They remain available for matching responses.

Should I enable priority processing for a webhook?

Use priority processing only for real-time events. It consumes more workers and memory and can reduce overall system performance. It is not recommended when multiple websites run on the same environment.

See Webhooks.

Batches

I cannot create or validate a batch

Confirm that:

• A published flow is selected.
• The interface contains the fields present in the payload.
• The interface has the batch scope.
• The payload passes interface validation.
• Priority is numeric and between 0 (highest) and 100 (lowest).

I cannot run a batch

Save the draft and make sure it contains a valid record count. Select Run and confirm. The batch changes to READY and enters the processing queue; processing can begin later.

I cannot edit a batch configuration

Configuration can be edited only while the batch is in DRAFT.

Why were only 20 batch records inserted in the Designer?

The Designer inserts and executes only the first 20 records of a batch.

Why is Batch v2 unavailable for this payload?

Batch v2 supports JSON and CSV interfaces. Other formats use the v1 processing path.

The batch finished with errors

Finished with errors means processing completed but some records failed. Open the batch report and inspect the process log. An error log is generated only when an error occurs.

How do I recover a failed v2 batch?

When an errored v2 batch still has records to process:

• Resume requeues the errored chunks from the last inserted record.
• Skip error and resume requeues the errored chunks and adds them to the skipped count.

Batch files are also available in the batch folder in File Manager.

See Batches.

Schedules

Why is a new schedule paused?

PAUSED is the initial status of a schedule. Use Run to change it to RUNNING.

Why can I not test a schedule in the Designer?

Schedules must be moved to an environment for testing. In the environment, you can run or pause them.

I cannot delete a schedule

Delete is available only when the schedule is PAUSED, FINISHED, or F.ERROR.

What does F.ERROR mean?

The schedule encountered a problem while processing.

See Schedules.

Data structure and static schema

I cannot create or save the data structure

Organization admins and project admins can create a data structure and save editor changes. If you do not have one of those roles, ask an administrator for help.

Create structure in the editor does not accept my XML or CSV

The Create structure in the editor option accepts JSON only. To use XML or CSV, import a file.

My CSV-generated data structure is missing fields

Flowize uses only the first two lines of CSV input to generate a data structure. Make sure those lines represent the structure you need, and verify the header, delimiter, and quote settings.

Changing the data structure affects an existing flow or interface

The global data structure supplies variables and mappings to other product areas. Review the confirmation carefully when Flowize warns that a structure is already in use.

A static variable changed for a record that was already running

Static values are shared by all running records and are replaced at execution time. Changing a static value in the editor affects running records when they next use that value. Static values cannot be changed during flow execution.

See Data structure, Static schema, and Variables.

File Manager

A file will not upload

Remove whitespace from the filename. For example, use my_image.png or myImage.png, not my image.png. Also confirm that the extension is supported.

Supported categories include images, audio and video, fonts, Microsoft Office documents, text and data files, HTML/CSS/JavaScript, PDFs, ZIP archives, and certificate files.

See File Manager for the complete extension list.

Project SFTP access

I cannot see File access or change the SFTP switch

Open the project in the target environment, then select Settings under Manage and File access. This section does not appear in the Designer. The switch is disabled if your account cannot enable or disable SFTP access; its tooltip asks you to contact your manager.

My SFTP client cannot connect to the project

Confirm that the project shows SFTP enabled. Under Connection Details, use the displayed Host, Port, and Username, with SFTP as the protocol. Download the project's private key under Authentication and configure the client to use it. Only private key authentication is supported.

The private key download is unavailable

The download requires active SFTP access and an available private key. Otherwise, Flowize displays SFTP private key is not available for this project. Check the project's SFTP status in File access.

My previous SFTP key stopped working after re-enabling access

Disabling access invalidates the current key. Enabling access again generates a new key. Select Download private key and update every client that used the previous key.

Changing one project's SFTP access interrupted transfers in other projects

Enabling or disabling SFTP access restarts the environment's shared SFTP service and may interrupt active transfers in other projects. Disabling access also stops active connections to the affected project. These actions take effect when you confirm Enable or Disable, without selecting Save.

I cannot find my SFTP files or access the rest of File Manager

The SFTP upload directory is /upload. It corresponds to the project's sftp folder in File Manager. The connection is restricted to that project's SFTP folder.

The sftp folder remains after I disabled access

Disabling SFTP removes the project's keys and hides its authentication and connection details. It keeps the sftp folder and its files in File Manager. Re-enabling access also preserves those files.

See Project SFTP access for connection steps and the effects of enabling, disabling, or re-enabling access.

Tables

A table will not save

The table name must be unique and contain only lowercase letters, numbers, and underscores. After changing a table or its columns, select Save and confirm the change.

I cannot import CSV data into a table

Add at least one custom column first. The CSV must include the required headers. Review the parsed preview and CSV options before selecting Import data.

My table export does not finish

Keep the browser open while the CSV export runs.

A row value is rejected or a system column is disabled

Row values are validated against their column types. The id, date_created, and date_updated columns are system-managed and can appear disabled when editing a row.

A column is unavailable in the table query builder

Search conditions use columns marked Indexed/Searchable. A saved query also requires a Query Name.

Why does the Tables app return at most 100 rows?

Table queries have a maximum limit of 100 results. Use Offset to skip results when retrieving another set.

Why do both the old and new column names appear after publishing?

When you rename a column and publish the project, Flowize keeps the old column and creates a new column with the new name.

Why do table rows disappear after deployment?

Review the tables selected under Tables data in Push to environment and their Action to do. To copy missing rows while preserving destination data, use Insert only new data. Delete current data and then Insert data empties the destination table before inserting the selected source data.

For the deployment choices, see Deploy and update projects. You can also import data directly into the environment.

See Tables and the Table workflow example.

Keystore

A keystore will not save

The keystore identifier must be unique and contain only lowercase letters, numbers, or underscores. Flowize validates the keystore schema and key data before saving.

I cannot delete a keystore

A keystore cannot be deleted while it contains stored data rows. Remove the rows first, when your permissions allow it.

Why did a keystore schema change affect a flow?

Schema edits affect new flows that use the keystore. Review schema changes before saving.

See Keystore.

Analytics and Insights

My Storage Analytics report has no expected data

Storage Analytics reports use metrics collected from data records by the Analytics app or an object's Analytics tab. Confirm that the flow collects the expected analytics name, metric name, and metric value.

Analytics belong to their source data records. Deleting those records also removes their analytics.

Project data record cleanup also removes associated analytics. Review Data retention and cleanup if older metrics are missing.

I cannot create or edit an Insights dashboard or widget

Users with the Full Admin role can create or edit dashboards and widgets. A dashboard requires a valid name that is unique within the organization.

My dashboard layout changes disappeared

An Unsaved changes indicator appears when the dashboard has changes. Select Save to keep additions and layout changes. To keep the changes in a separate dashboard, use the copy option in the Save menu. Discard changes restores the last saved configuration after confirmation.

Changing one widget's filter did not update the others

Insights has no dashboard-wide data or date filter. Configure the environment, project, channel, and period separately for each widget.

A widget shows no data or has not updated immediately

Confirm that the widget's environment, project, and period include the activity you expect. Error trend by app displays a no-data state when there is no activity in the selected period.

If the widget shows This widget could not be loaded, select Try again. If it shows No results found, select Change filters and review the selected data scope and period.

See Storage Analytics, Insights, and Insights widgets.

Default channels

A default channel is missing from the menu

Only active channels appear in the Default Channels menu. The visible channels and actions can also differ by role and organization configuration. If the organization has no active channels, the page shows the available channel types and an option to contact Sales.

A default-channel app is missing from the flow palette

The app is available in Apps with the type Default Channel only while its channel is active. Deactivating a channel makes it unavailable to communication flows.

A default-channel status object is missing

Check that the channel is active and its project webhook is available. Ask support to check the channel setup if the action is available but its status object is missing.

A channel action reports Default channel not enabled

Default channel not enabled, or a channel-specific Default channel not enabled message, means the channel is unavailable for the organization. Request a configuration check before retrying.

An Email action reports Domain configuration nof found or not valid

Reselect Domain, or check the value supplied in Input mode.

An email was sent but not received

1. In your project, open Reports and find the data record by UUID, flow, or date. Open its Report and find the Email action in the execution steps. See Inspect a record's execution.
2. Where available, inspect the action's Parameters, Request, and Response. Check the resolved recipient address, domain, response, and any error details. Also check the recipient's spam or junk folder.
3. If the flow handles an Email Status event, inspect the status step and its Webhook Response when available. Check that its Webhook ID value refers to the Email action's returned id and that the relevant event is selected.

A successful Email action response confirms the request result, not that the message reached the recipient. The Email Status event selector does not offer a delivered event. A missing failure event also does not confirm delivery; it may not have been received or matched by the listener. See Handle channel events.

An email bounced or was rejected

Check the Email action response and any FAILED: Email could not be delivered status response in the execution report. Review the recipient address and any available error details. If the reason is unclear or the problem persists, contact Support with the details listed below. Support can investigate whether the email provider needs to be involved.

A recipient received duplicate emails

In Reports, compare the relevant data records and Email action execution steps, including their dates, recipient values, and returned request IDs where available. Check whether the flow ran the action more than once or whether more than one record was processed. A repeated action is a lead for investigation; the report alone may not explain every duplicate.

Before restarting a record, testing an Email action, or sending again, review the existing results: these actions can send another message. If the cause is unclear, contact Support with the records and request IDs for the affected messages.

What should I provide to Support about an email delivery issue?

Include the project and flow, data record UUID, approximate date and time with time zone, affected recipient address, and the Email action's request id when available. Describe the symptom and provide the action response, error details, and any relevant Email Status event and timestamp. For duplicates, include the corresponding details for each message or record. Share only the information needed to investigate and omit credentials and unrelated sensitive content.

A channel action reports Webhook URL could not be configured

Ask support to check the channel's event configuration. Review the action result before retrying: the channel request may already have been sent.

A status object does not take the EVENT path

Check Webhook ID value, the selected Events value, listener settings, and whether the provider has returned that event. For Email opens and clicks, also check the domain's tracking settings.

A channel status object does not have all outputs linked

Connect both outputs of the status object and save the flow. See Handle channel events.

I cannot add, update, or remove an SMS, Print, Archive, or Berichtenbox configuration

Contact Sales to activate or deactivate these channels or to add, update, or remove their configurations. These changes are not documented as self-service actions.

An email domain remains NOT READY

A domain remains NOT READY until its required DNS records are added and verified. Copy each hostname and value exactly, select Verify DNS, and try again later if the records remain PENDING because DNS propagation can take time.

If the hostname already has an SPF record, update that record instead of creating a second SPF record for the same hostname.

Flowize rejects the email domain I entered

Enter only a domain that your organization owns, without a protocol, path, or query string. Use example.com, not https://example.com/path.

Can I recover a deleted email domain configuration?

No. Deleting a domain permanently removes its default-channel configuration and cannot be undone.

What should I do with a Berichtenbox registration key?

Treat it as sensitive configuration data. Do not include it in screenshots, tickets, or messages.

See Default channels, Email, SMS, Print, Archive, and Berichtenbox.

Users, roles, and tag restrictions

I cannot open the Users page

You need at least View Organization Users or Update Organization Users permission.

The Invite user button is disabled

Enter a valid email address and select a role. The invite action becomes available only after both requirements are met.

I cannot invite a user

Confirm that:

• You have Invite Organization Users permission.
• The email address is valid and a role is selected.
• The user does not already belong to the same organization.

I cannot resend an invitation

You need Invite Organization Users permission. The resend action is available only when the user belongs to the organization, an invitation was sent, it has not been accepted, and an activation code still exists.

Resends are limited to one request every 30 seconds for the same user in the same organization. Wait at least 30 seconds before trying again.

I cannot change a user's role

Changing roles requires Update Organization Users permission. A role change applies only to the current organization; the user's roles in other organizations are preserved.

I cannot remove a user

Removing users requires Delete Organization Users permission. You cannot remove yourself. Every organization must retain at least one full admin, so assign another full admin before trying to remove the only administrator.

Removing a user detaches them from the organization and removes organization-specific tags, roles, project assignments, and environment assignments. Existing content is not deleted.

I cannot create, rename, or recolor an organization tag

Full admins and project admins can create, rename and recolor organization tags. If these actions are unavailable, check your role and the displayed permission message.

I cannot assign tags to a Flow or Content item

Full admins and project admins can assign tags to Contents and Flows. Open the item's Tags field and select an available tag. If the action is unavailable, check your role and the displayed permission message.

I cannot assign tag restrictions to a user

Assigning, changing or removing user tag restrictions requires full admin access. Project admins cannot manage these user restrictions. A full admin can enable User restricted to edit on these tags from the user's details and select the tags that define the user's editing scope.

I cannot delete an organization tag

Flowize prevents deletion while the tag is assigned to one or more users for access restrictions. Review those user restrictions first. If the action remains unavailable, use the displayed permission message and ask a full admin or organization manager for help.

Deleting an organization tag is permanent: it removes the tag everywhere it is used and cannot be undone.

I removed a tag from an item, but the tag still exists

Removing a tag from a Flow or Content item removes only that assignment. The organization tag remains available for other items. Deleting the tag throughout the organization is a separate action: use Delete tag from the tag's actions menu if you have permission.

A tag-restricted user cannot edit or delete an item

The item must share at least one tag with the restricted user's authorized tags. Check the item's Tags field and hover over the disabled action to read the permission message. Ask a full admin to review the user's tag restrictions if access should be expanded.

A tag's name or color changed on several items

Organization tags are shared. Renaming or recoloring a tag updates it everywhere that tag is used.

A tag-restricted user can still see Contents and Flows

Tag restrictions apply to all types of Contents and to Flows. They limit editing, not existing view access. A restricted user can edit only items that share at least one of their assigned tags, subject to their role permissions. New content they create or generate receives the tags linked to that user.

To remove the user's tag-based editing restrictions, a full admin must turn off the access-restriction toggle and save the change. The user's role permissions still apply.

See Organization users and Roles and restrictions.

See Using tags in Flowize for tag selection, organization-tag management, and tag-based editing restrictions.

Websites

My new website is published, but its public URL returns a 404

In the template editor, select a page container other than the body element and save the template. This creates the Index content page. Open Index from Website Menu, add the content visitors should see, and save it. A Published status alone does not mean the page is ready to view.

If a link in the imported HTML points to a file such as index.html and returns a 404, update it in Block Configuration to point to the Flowize page URL. For a link to the site's home page, ./ works from the site root.

Content from my website ZIP is missing from the Index page

The imported template does not automatically copy its visible content into Index. Open Index, add content with Website Blocks or reuse markup from the ZIP by editing a block's HTML, then save the page.

My website form does not start or continue the expected flow

Create the flow first. In the website editor, select the form's submit button, open Block Configuration, choose Start a Flow or Send status to the flow, and select the flow. If you send a status, configure a Website status object in the flow to listen for that exact status name. For input values, select each input in Block Configuration and save its name to create its @site...@ variable.

A visitor is redirected instead of seeing a private website page

Check the page's Page security setting, its Security Level Tags, and the page configured for visitors without matching tags. In the flow, the Privacy level tool must activate the matching tags for that website. Visitors without matching tags are redirected to the configured page.

I cannot delete a website

Unpublish it first. Delete is available when the website is in Draft status. In the deletion dialog, type DELETE to confirm. Deletion is permanent.

See Websites.

Emails and HTML Blocks

I cannot create or save an email

Enter a unique name when creating the email. In the editor, select Save, review the Title, Description, and Publish Options in the Saving Design dialog, then select Save again. If the HTML depends on classes or stylesheets, review the options for removing class attributes and preserving stylesheet links and <style> tags.

My saved email is not being used by the flow

In the flow's Send an email action, open Parameters → Content → HTML body, select Choose an Email, choose the saved email, complete the other action settings, and select Apply.

An HTML Block is not appearing in my email

Save the HTML Block in its editor and complete the Saving Design dialog. Then open the email editor, select HTML Blocks in the top toolbar, and choose the saved block. Flowize inserts a reference based on the block's name, such as @htmlblock.my_html_ul@.

See Emails and HTML Blocks.

Documents, layouts, and components

I cannot create a document

Enter a Name in the document's Information step, then choose a layout or create a new one before selecting Create. A document needs a layout to define its pages and print areas.

My layout saves but cannot be published

A layout can be saved with errors, but it cannot be published until every area is configured correctly. In Areas configuration, check warning icons and red fields, then complete the required dimensions and positions for each affected page design. Save the corrected layout before publishing.

I cannot delete a layout

A layout that is used by a document cannot be deleted. Check Times used in the layout overview, or open the usage dialog from the layout editor to see which documents use it.

I cannot edit or delete a published document version

Published content is read-only, and a published version cannot be deleted. Create or open a Draft to make changes. Publishing enables version history automatically; the published version is the one sent to production.

An older document version uses different component content than I expected

When you recover an older document version to create a new version, it uses the latest available versions of its components. It does not restore the component versions that were used when that document version was originally created.

Editing a component changed content in other documents

Custom components are reusable across documents. Check Times used or the component's usage information before editing a shared component. To customize one document instance, select its component block and choose Convert to local component. Changes to the local content apply only to that instance.

Content is missing from my PDF preview

Select Test PDF and check which data record is selected, or choose No data record to preview without one. If content is still missing, review conditions on its section and inspect the output again after saving changes.

PDF element settings

Message or issue	What to check
A repeating section is empty	Select a data record. Check that the variable resolves to a non-empty array or that the query returns results. Check the section's condition.
A query-driven table row is missing	Check that the selected query still exists and returns results for the preview data.
Settings changes are missing after reopening the document	Select Apply in the element editor, then Save in the document toolbar.
The document you are trying to save could not be found	Return to the Documents overview and check that the document still exists.
User Unauthorized	Ask your organization administrator to check your project access and role. If you are a Content Editor with tag restrictions, the document must share at least one of your assigned tags before you can edit or delete it. See Roles and restrictions.

See Documents content, Documents, Layouts, and Custom components.

Attributes and legacy content

An element in a template cannot be edited, moved, or removed

Check the attributes on that element. HTML templates use attr-canedit for editing, attr-candelete for removal, and attr-canmove on child elements together with attr-movablearea="yes" on the parent for rearranging. Plain-text templates use attributes such as ATTR-CANEDIT and ATTR-CANDELETE inside [#LAYER] or [#BLOCK] tags.

An array does not produce the expected rows in HTML content

Check that attr-dynamic points to the array variable and is on a supported <tr>, <td>, <option>, or <div> element. If each row has its own condition, check attr-dynamicrow-condition and the named condition.

Hosted Pages, Content Collections, or Templates are unavailable in my new project

These features are deprecated and unavailable in new projects. Existing items may continue to operate, but support for Hosted Pages and Content Collections has been announced to cease. Contact the support team for transition guidance and alternatives.

My Content Collection displays the wrong item

Flowize displays the first item in the collection whose condition matches. Reorder the items to change which one is checked first. If no condition matches, the collection displays its default content. The collection must be Published to be available in flows; an Inactive collection is unavailable until reactivated.

See Attributes, Hosted Pages, Content Collections, and Templates.

Still need help?

When an option remains unavailable after you check the documented prerequisites, status, and permissions, contact your organization administrator. For default-channel activation and configuration changes, contact Sales.

Open a support ticket

Use the ADDCOMM service desk for new support tickets.

To open it from Flowize:

1. Open your profile menu at the bottom of the sidebar. The profile control shows your name or initials.
2. Select Service desk. The support portal opens in a new tab.

For help with the transition or an existing ticket, contact the support team.

Existing Managed Service tickets

If your older Managed service page shows New ticket? Use our new system!, new tickets can no longer be submitted there. Select Open new ticket in the notice to open the ADDCOMM service desk.

The notice displays a deadline for viewing and managing existing tickets in Managed Service. Check that date and contact the support team if you need help accessing or following up on an existing ticket.