Deploy and update projects

Use Push to environment to add a project to an environment or update a project already hosted there. You can use the project's current Designer configuration or, when available, the version hosted in another environment.

The update includes project configuration such as interfaces, flows, content, webhooks, and apps. In the same dialog, choose which additional data and files to copy.

Before you start

All roles can push a project to an environment.

Open the project in the Designer. Push to environment appears in the project navigation when environment deployment is enabled.

If you have no environments yet, create an environment.

Deploy from the Designer

1. Open the project in the Designer and select Push to environment.
2. Under Environments, choose the destination from Select an Environment.... Flowize adds the project if that environment does not already host it, or updates the existing project if it does.
3. Use the Designer as the source. This is the default and uses the project's current configuration. If source choices are displayed, select Add from Designer or Update from Designer, as shown in the dialog.
4. Review the data and files to include.
5. Select Update Project, then confirm with Update project. If the dialog displays Add Project, select it and confirm with Yes, Add Project.

The process may take a few minutes. After the process starts, a notification provides a Settings link to monitor progress.

Use a version hosted in another environment

When another available environment hosts this project, the dialog offers Update from another Environment. Selecting a source environment also selects the project version hosted there.

You can only update from another environment if it hosts a newer project version than the destination environment.

1. Select Push to environment and choose the destination environment.
2. Select Update from another Environment.
3. Review the source table. It shows Version, Last Updated, Environment, and Organization. A version name appears alongside the version number when one is available.
4. Select a source environment with an enabled selection control. The destination environment is hidden from the source table.
5. Wait for the source project's data choices to load, then review the data and files to include.
6. Select the dialog's Update Project or Add Project button and confirm.

The update button remains disabled until you select a source. If no other available environment hosts the project, the dialog uses the Designer configuration instead.

Choose data and files to include

Expand each section to choose what to copy from the selected source. The section label shows whether anything is selected or how many items are selected. Review these choices before confirming the deployment.

Static Schema

Select Yes, update static schema to add static keys that are missing from the destination project. This preserves the current values of keys already present in the environment. Select No to leave this option off.

File Manager

Select the files or folders to copy in the file tree.

Files with the same name are overwritten. If a selected folder already exists in the destination, its contents are merged with the copied folder's contents.

Keystore data and Tables data

Select each keystore or table to include, or use the checkbox in the table header to select all items in that section. The lists show Keys to export for keystores and Rows to export for tables. Empty items display [EMPTY].

For each selected item, choose an Action to do from the available options:

Action	Effect on the destination keystore or table
Insert only new data	Adds keys or rows that are missing from the destination. Existing data is preserved.
Insert new data and/or update if data matches	Adds new data and updates existing data when keystore keys or table row IDs match. Existing data is not deleted.
Delete current data and then Insert data	Empties the selected destination keystore or table, then inserts the source data.

The options depend on whether the dialog is adding or updating a project. In add mode, the available action is Insert only new data.

warning

Delete current data and then Insert data deletes the existing data in the selected destination keystore or table. Check the source and selected items before confirming this action.

Websites

Select the websites to include. The list shows each website's name and Num. Pages, with an Action to do selector for each selected website.

Moving a website includes its pages and templates, plus the CSS, JavaScript, and images in its assets folder. The copied assets overwrite the current website files and folders in the destination environment.

Monitor progress

After the deployment starts, select Settings in the notification. In the environment's General settings, the Environment status card shows In progress, the Current activity, and a progress bar.

You can keep working while the update runs. Flowize displays an Environment updated notification when the process succeeds.

If the update fails, Flowize displays Environment update failed and provides a link to the environment logs. You can also open Log in the environment settings. If the status card shows Error, follow its instruction to contact the Support team.

Unavailable environments and blocked updates

An environment with a blocking software update cannot receive a project deployment. It is disabled in the destination selector and marked with an update indicator. Update the environment software to the latest version before adding or updating the project.

Environments in a critical state are excluded from the available destination and source lists.

The update can also fail to start if the environment or project is no longer valid, or if an update targets an environment that does not host the project. If Flowize reports that the update process could not start, follow the message to try again.