# Known Bugs

{% hint style="info" %}
As of [version 1.1](https://workflower.constantin-maier.com/releases#1-1), *Workflower* offers the ability to log activity in order to help us debug. As of [version 2.0](https://workflower.constantin-maier.com/releases#2-0), logging is enabled by default. If it's disabled for you, go to *Settings > License & Help > Enable Logging*. If you cannot access the settings dialog, create a file named "wf\_enable\_log.txt" (without quotation marks) in your *Documents* user folder to enable logging.

Your logfiles are to be found under:

**\~/Documents/Adobe/Workflower/Logging**

If you want to resolve an issue, you might want to include your latest logfile when contacting customer support.
{% endhint %}

## Most Common Bugs/Problems

{% hint style="info" %}
[For the most common bugs or problems, please check out the F.A.Q. section on *Bugs/Problems*!](https://workflower.constantin-maier.com/faq#update_issues)
{% endhint %}

## System Bugs

* Sometimes, upon executing a function, the script just loads forever without executing anything.
  * **Workaround:** Hit *Escape* to stop the execution. If the problem persists when trying to execute the function again, please restart After Effects. Sometimes, this solves the issue. If it doesn't, please contact customer support.

## ScriptUI Panel Bugs

* Sometimes clicking a button does not execute a function.
  * **Workaround 1:** Most of the time, this is because you don't have a timeline selected and most functions require an active composition. However, often in the circumstances, you might have a timeline open but AE will not recognize that for some reason and think you only have the ScriptUI Panel active at the time. To make it work, please click on the timeline of the comp to select it and then click on the function button on the ScriptUI Panel again. Most of the time, the function will execute now.
  * **Workaround 2:** If clicking the button still doesn't work, please restart the panel which can solve the issue. To quickly restart the panel, right-click on empty space of the panel and click on *Restart ScriptUI Panel*.
* Sometimes AE throws an error unrelated to *Workflower* and then *Workflower's* ScriptUI Panel becomes unresponsive.
  * **Workaround:** Please restart the panel by closing it and then re-selecting it from *Window -> Workflower ScriptUI Panel.jsxbin.* You might have to do this two times as the panel can start up blank the first time.
* Sometimes after rendering in AE's *Render Queue*, *Workflower's* ScriptUI Panel becomes unresponsive. In some instances, AE will throw an error after rendering: *"Can not run a script while a modal dialog is waiting for response"*
  * **Workaround:** Please restart the panel by closing it and then re-selecting it from *Window -> Workflower ScriptUI Panel.jsxbin.* You might have to do this two times as the panel might start up blank the first time.
* **(Only on Mac:):** Sometimes, when clicking on a button while holding down a modifier key, the non-modifier-key buttons will flash in between.
  *  Unfortunately, there's no workaround to this problem.

## Dialog Bugs

* Sometimes a borderless dialog (*Main Menu, Rename Layer/s, Relabel Layer/s*) will not come up at all.
  * **Workaround 1:** In some instances, this is due to the fact that *Workflower* is unable to determine the mouse position. When you hit *Escape*, the panel should come up. However, if you continue to experience the issue, please restart After Effects. In some cases, this will solve the issue.
  * **Workaround 2:** If workaround 1 didn't work and you are a Windows user, you can go to *Settings > Miscellaneous* and set *Mouse Position Calculation* to *External File (Advanced)*. This will use a different method for calculating the mouse position. For this method to work properly, please deactivate *Warn User when Execting Files* in AE's *Scripting & Expressions* Preferences.
  * **Workaround 3:** If workarounds 1 and 2 don't work for you, please contact customer support, so we can investigate the cause. For the time being, please go to *Settings > Miscellaneous* and set *Position of Borderless Dialogs* either to *At Last Position* or *Always Centered*.
* **(Only on Windows:)** When hitting *Escape* on a borderless dialog (*Main Menu*, *Relabel Layer/s*, *Rename Layer/s*), in some instances an error message will pop up. This, however, does not affect anything.
* When your mouse cursor is right at the edge of the screen (or very close to it), borderless dialogs *(Main Menu, Relabel Layer/s, Rename Layer/s)* might not come up.
  * **Workaround 1:** Move the mouse cursor a little bit away from the edge.
  * **Workaround 2:** If you are a Windows user, you can go to *Settings > Miscellaneous* and set *Mouse Position Calculation* to *External File (Advanced)*. This will use a different method for calculating the mouse position which is still able to read the mouse position if it is close to the edge of the screen.
* **(Only on Mac + After Effects 2021 and below:)** When you move the mouse cursor away from the main menu and then back to it, mouseover icons won't work anymore.
  * **Workaround 1:** Update to After Effects 2022 or higher which will fix this issue.
  * **Workaround 2:** Click on a random button, hold it, then move away from the button and let go. After that, mouseover icons will work again.
* **(Fixed in** [**version 1.0.6**](https://workflower.constantin-maier.com/releases#1-0-6)**) **~~**(Only on Mac:)** On the *Main Menu*, no new icons will be revealed when pressing Shift, Cmd, or Option to execute additional functions. The execution of these functions works without problems, though.~~
  * ~~**Workaround:** Check the help-tip to know which modifier key will execute what.~~
* **(Fixed in** [**version 1.1**](https://workflower.constantin-maier.com/releases#1-1)**)** ~~There are issues with certain monitors, most of the time when their resolution is scaled up. Borderless dialogs (*Main Menu*, *Relabel Layer/s*, *Rename Layer/s*) might come up at the wrong position or not come up at all.~~
  * ~~**Workaround:** Open up the *Settings*, go to the *Miscellaneous* tab and change the *Position of Borderless Dialogs* from *At Mouse Position* to either *At Last Position* or *Always Centered*.~~

## Shortcut Bugs *(Windows - Single Script Mode)*

* **(Only on Windows:)** Sometimes hitting a shortcut might not work at all. An error message from *Workflower* will come up, telling you that you need to restart *After Effects* or your computer. Most of the time, restarting the computer will be necessary. Quite likely, this bug cannot be fixed since it seems to be a bug within the *Adobe* scripting environment. In these cases, the variable that gives information on the pressed key will not return anything. Unless *Adobe* isn't fixing this issue, you will need to stick to restarting *After Effects* or your computer.
  * **Workaround:** If you encounter too many problems when using shortcuts on Windows, switch to [Individual Scripts Mode](https://workflower.constantin-maier.com/main-functions/shortcuts#individual-scripts-mode-windows-mac) (go to *Settings / Shortcuts / Shortcut Mode*). You will only have a maximum of 20 shortcuts t
    o assign but you will not encounter any bugs anymore.
* **(Only on Windows:)** In very rare instances, a certain function is being executed when actually having hit the shortcut for another function.
* **(Only on Windows for Japanese users:)** [Single Script Shortcut Mode](https://workflower.constantin-maier.com/main-functions/shortcuts#single-script-mode-windows-only) doesn't work when the OS language is Japanese. (This is due to an AE bug. It has been reported to Adobe but as long as they haven't fixed this, Japanese users will have to rely on the following workarounds.)
  * **Workaround 1:** Use [Individual Scripts Shortcut Mode](https://workflower.constantin-maier.com/main-functions/shortcuts#individual-scripts-mode-windows-mac). It doesn't have some advantages that *Single Script Mode* has (like being able to set an unlimited amount of shortcuts) but it will work without a problem when the OS language is Japanese.
  * **Workaround 2:** If you really want to use *Single Script Mode*, you will have to switch your OS language to US or similar. Read up [here](https://workflower.constantin-maier.com/main-functions/shortcuts#shortcut-issues-for-japanese-users) for more information.

## Shortcut Bugs *(Mac)*

* **(Only on Mac:)** On some machines, shortcuts that contain a number might not work (e.g. *macControl+1* for *Create Group* or *macControl+3* for *Reveal Layer Opacity*).
  * **Workaround:** Please change the shortcuts to ones that do not contain a number. It would be great if you could contact [customer support](https://aescripts.com/contact/?direct=1\&sku=CMRW2-SUL) too, so we can try to help you fix the issue. Unfortunately, we haven't been able to reproduce the issue ourselves so we're reliant on users cooperating with us on this issue.

## *Select Group* Bugs

* When executing [Select Group](https://workflower.constantin-maier.com/group-functions/collapse-and-select-groups#select-group) on a group with [effects on its header](https://workflower.constantin-maier.com/layer-functions/adjustment-layers#applying-effects-to-the-group-header) or with [Group Opacity](https://workflower.constantin-maier.com/group-functions/miscellaneous-group-functions#group-opacity) enabled, this might cause "ghost" expression errors to occur (= not actual errors, however ones that are being displayed). This is because upon executing *Select Group*, the icon \[   ] will be displayed briefly next to the group header name in order to indicate it's being selected (and therefore confuse the expressions of the *Linked Effects* or the *Group Opacity* expressions).
  * **Workaround:** To avoid the errors, you can go to the *Icon Settings* and disable the icon when selecting a group.

## *Group Opacity* Bugs

* When using *Layers respect Group In/Out* on a group that contains a group which, too, has *Layers respect Group In/Out* enabled, the trim of upper group will behave as without the setting enabled. 
  * **Workaround:** Add a trimming exception to the upper group header by executing [Exempt Layer from Trimming](https://workflower.constantin-maier.com/main-functions/layout#exempt-layer-from-trimming). Now, you'll be able to trim the group properly.

## *Create Matte* Bugs

* If you want to undo your action after drawing a parametric shape on the group header and then executing [Refresh Connections](https://workflower.constantin-maier.com/main-functions/connections#refresh-connections) to create a [Group Matte](https://workflower.constantin-maier.com/layer-functions/matting#group-matte) from it, you create an undo state from within the execution of the function rather than before. (Note: This does not happen when drawing a bezier/custom shape path.)
  * **Workaround:** Hit *Undo* three times to go back to before the execution of the function.

## *Merge Mattes* Bugs

* Due to a bug of the *Calculations* effect used on *Matte Merge* layers, when setting the *Blending Mode* to *Stencil Alpha* or *Silhouette Alpha*, under certain circumstances a very slight transparency might become visible although the matte source layer is at 100% opacity. (Since this is an AE bug, this problem will remain until AE is fixing it.)
  * **Workaround:** Add a *Curves* or *Levels* effect to the *Matte Merge* layer and boost the alpha channel a bit to get rid of the transparency.
* **(Fixed in** [**version 1.0.4**](https://workflower.constantin-maier.com/releases#1-0-4)**)** ~~As of now, when changing the comp size, *Matte Merge* layers will **not** be adjusted to the new size automatically and produce weird results.~~
  * ~~**Workaround:** To make the *Matte Merge* layer work again, you need to go to its *Solid Settings* and hit *Make Comp Size*. It is recommended to disable *Affect all layers that use this solid.* (Only when you are sure that no *Workflower* layer other than the *Matte Merge* layers of the comp with a new size use this solid, you may enable *Affect all layers that use this solid*.)~~

## *Clone & Precomp* Bugs

#### Cloning Mode Bugs

* Under very rare circumstances, the *Clone & Precomp* mode *Faster for fewer properties* can cause various errors. This only happens when you have another script installed that uses a callback function *(app.onError)* to display errors that happen within the application.
  * **Workaround 1:** Remove the other script from your interface and restart *After Effects.*
  * **Workaround 2:** If you can't remove the other script, go to the *Cloning Settings* and switch the *Clone and Precomp Mode* to *Faster for more Properties.* This will not cause the errors to be generated. Please note that you won't be able to use *Quick Refresh Connections* in that case, too. You can only use the regular *Refresh Connections*.
* The *Clone & Precomp* mode *Faster for more Properties* invalidates the user's clipboard. Since the mode uses AE's native function *Copy with Property Links*, the clipboard will then contain the layers copied to the clone comp.
  * **Workaround:** If that's a problem for you, go to the *Cloning Settings* and switch to *Faster for fewer Properties* mode instead.
* The *Clone & Precomp* mode *Faster for more Properties* will cause a specific problem with AE's *Redo*: If you undo the cloning action and then try to redo it after that, you will not be able to recreate the original state but rather a state midway through the function's execution. Other *Undo/Redo* states aren't affected, though. The bug happens because *Workflower* has to rely on a workaround in scripting in order to make use of AE's native *Copy with Property Links.* Unless Adobe isn't fixing this issue, *Faster for more Properties* will cause issues with *Redo*.
  * **Workaround:** If that's a problem for you, go to the *Cloning Settings* and switch to *Faster for fewer Properties* mode instead.

#### Expression Errors

* Sometimes it may happen that expression errors come up directly after creating a *Precomp Clone* if the clone has been created within a *Group Precomp Clone* or a *Group Linked Adjustment Layer.* The errors come up because certain linked attributes in the clone comps/adjustment layers haven't been updated yet.
  * **Workaround:** Simply hit *Refresh Connections* on the new *Precomp Clone* and/or the higher clones/adjustment layers to fix that.
* Sometimes, after creating a *Precomp Clone* or refreshing its connections, expression errors can come up. These errors don't have any cause, though (quite likely due to some bug within *After Effects*). 
  * **Workaround:** Just click on the magnifying glass icon on the expression error message to search for the errors - that way, the error message will disappear by itself since AE cannot find any actual error.

#### Miscellaneous Bugs

* In rare instances, something within the *Precomp Clone* is off compared to the source layers.
  * **Workaround 1:** It might help just to execute [Refresh Connections](https://workflower.constantin-maier.com/main-functions/connections#refresh-connections) on the *Precomp Clone*.
  * **Workaround 2:** Sometimes issues occur because of the fact that *Workflower* adds an expression to the *Compositing Options* of every effect within the *Precomp Clone*. AE sometimes seems to have bugs when it comes to expressions on the *Compositing Options*. To get around this, [unlink](https://workflower.constantin-maier.com/layer-functions/cloning#unlink-properties) your *Precomp Clone*. That way, *Workflower* will copy the layers to the *Precomp Clone* without expressions on the *Compositing Options*.
* When using *Refresh Connections* on a *Precomp Clone* and one or more of its contained layers has audio, potential open property tabs of the *Precomp Clone* layer (including tabs of potential Dependent[ Clones](https://workflower.constantin-maier.com/layer-functions/cloning#duplicating-a-precomp-clone)) in the timeline will be collapsed.
  * **Workaround 1:** If you have any property selected on the *Precomp Clone layer* in the timeline, property tabs won't be collapsed. (Tabs of *Dependent Clones* will be still collapsed, though.)
  * **Workaround 2:** Use [Quick Refresh Connections](https://workflower.constantin-maier.com/main-functions/connections#quick-refresh-connections-experimental) instead of [Refresh Connections](https://workflower.constantin-maier.com/main-functions/connections#refresh-connections). In most cases, this will not collapse the tabs. (Using this technique, tabs of *Dependent Clones* will not collapse too.)
* In rare instances, when using *Refresh Connections* or *Quick Refresh Connections* on a *Prime Clone*, the first frame of one of the clone layers might become invisible.
  * **Workaround 1:** Trim the source layer's in-point to one frame before the first frame. (If you need the trim to be exactly where it is, you might want to animate the opacity to 0% on the frame before.)
  * **Workaround 2:** Use [Quick Refresh Connections](https://workflower.constantin-maier.com/main-functions/connections#quick-refresh-connections-experimental) instead of [Refresh Connections](https://workflower.constantin-maier.com/main-functions/connections#refresh-connections) (or vice-versa). Sometimes this gets rid of the first invisible frame.
  * **Workaround 3:** If the culprit is *Refresh Connections* but *Quick Refresh Connections* doesn't work either or you want to use the regular *Refresh Connections*, go to the *Cloning Settings* and deactivate *When disabling Source Layers, set Clone Layers to 0% Opacity by Expression*. Then select the clone and hit *Refresh Connections* to enforce the new setting. Visibility states won't be linked now but the first frame should be visible.
* When creating a [Precomp Clone](https://workflower.constantin-maier.com/layer-functions/cloning#clone-and-precomp) that contains another *Precomp Clone* with [enabled Precomp Transforms](https://workflower.constantin-maier.com/layer-functions/cloning#enabling-precomp-transforms), the position of the *Precomp Clone* with enabled transforms shifts within the higher *Precomp Clone*.
  * **Workaround:** Unfortunately, there's no workaround. We try to fix this in an upcoming update.
* When executing [Duplicate Layer / Clone / Group](https://workflower.constantin-maier.com/group-functions/create-and-duplicate-groups#duplicate-group) on a [Prime Clone](https://workflower.constantin-maier.com/layer-functions/cloning#prime-clone) with [enabled Precomp Transforms](https://workflower.constantin-maier.com/layer-functions/cloning#enabling-precomp-transforms) and their contained source layers, the duplication doesn't work properly and one *Precomp Clone* will be turned into a [Dependent Clone](https://workflower.constantin-maier.com/layer-functions/cloning#duplicating-a-precomp-clone).
  * **Workaround:** Unfortunately, there's no workaround. We try to fix this in an upcoming update.
* *3D Precomp Clones* are only experimental and have several limitations. You might encounter some bugs too. Check out the [dedicated chapter](https://workflower.constantin-maier.com/layer-functions/cloning#3d-precomp-clones-beta) to understand its limitations.

## *Linked Adjustment Layer* Bugs

* When using [Refresh Connections](https://workflower.constantin-maier.com/main-functions/connections#refresh-connections) on a *Linked Adjustment Layer*, the user's clipboard will be invalidated. Since it uses AE's native function *Copy with Relative Property Links*, the clipboard will then contain the effects copied to the *Linked Layers*.
  * Unfortunately, there's no workaround to this problem.
* When deleting a *Linked Adjustment* Layer with a *Calculations* effect applied to it (other effects might be affected too), then execting *Refresh Layout* (which delete the corresponding effects on the *Linked Layers*) and after that undoing the deletion, *After Effects* will crash in a lot of circumstances. (This is an *After Effects* bug and it has to do with an expression that *Workflower* applies to the *Effect Opacity* of the *Composition Options* on every *Linked Layer*. If the deletion of a referenced layer in this expression is undone, *After Effects* almost always seems to crash. So far, this behavior has only been observed when using the *Calculations* effect, though.)
  * **Workaround:** Use [Delete Layer / Clone / Group](https://workflower.constantin-maier.com/group-functions/ungroup-dissolve-and-delete-groups#delete-layer-clone-group) to delete the *Linked Adjustment Layer* instead. This does not seem to cause problems with *Undo* later.
* [Convert Property to Comp Size](https://workflower.constantin-maier.com/layer-functions/adjustment-layers#convert-property-to-comp-size) causes unexpected behavior on certain properties when AE's language is not in English. We already have fixed this issue and will provide the fix in the next release of *Workflower*.
  * **Workaround:** Change AE's language to English. 
* **(Fixed in** [**version 1.1**](https://workflower.constantin-maier.com/releases)**)** ~~When using~~ [~~Refresh Connections~~](https://workflower.constantin-maier.com/main-functions/connections#refresh-connections) ~~on a *Linked Adjustment Layer*, a specific problem with AE's *Redo* occurs: If you undo the refresh action and then try to redo it after that, you will not be able to recreate the original state but rather a state midway through the function's execution. Other *Undo/Redo* states aren't affected, though. The bug happens because *Workflower* has to rely on a workaround in scripting in order to make use of AE's native *Copy with Relative Property Links*. Unless Adobe isn't fixing this issue, using *Refresh Connections* on a *Linked Adjustment Layer* will cause issues with *Redo*.~~
  * ~~Unfortunately, there's no workaround to this problem.~~

## *Pre-Render* Bugs

* **(Only on Windows:)** When executing [Pre-Render](https://workflower.constantin-maier.com/layer-functions/pre-rendering#pre-render),  sometimes *Workflower* queues the renders but then stops before starting the render with this error: *An unexpected error occurred while exporting a composition. Error Code: 3. Please restart After Effects and retry the export.*
  * **Workaround:** To our knowledge, this problem only occurs very infrequently. Simply restart After Effects or your computer, and try executing *Pre-Render* again. This should get rid of the error. If it doesn't, please contact customer support.
* **(Only on Mac:)** When executing [Pre-Render](https://workflower.constantin-maier.com/layer-functions/pre-rendering#pre-render), sometimes After Effects freezes after finishing the render, and it has to be force quit it or it crashes with this error message: *After Effects quit unexpectedly.*
  * **Workaround:** In our testing, this problem only occurs infrequently. Simply restart After Effects or your computer, and try executing *Pre-Render* again. (Sometimes, you have to restart a second time.) This should get rid of the error. If it doesn't, please contact customer support.
* **(Only on Mac:)** When making use of *Resize WF Proxy*, the output has slightly different colors.
  * **Workaround:** Unfortunately, there is no workaround at the moment. Since this is an AE bug that always occurs when resizing via the output module, there's nothing much we can do about it. If Adobe is not fixing this, however, we want to find a fix for this ourselves in the future.
* *(This issue probably has been solved ->)* If you right-click the project item with pre-render, then set the AE Proxy to none, and you execute *Refresh Layout* afterwards, this can lead to a bug which crashes AE.
  * **Workaround:** Please always unset the pre-render by selecting the layers with pre-render and executing [Delete Layer / Clone / Group](https://workflower.constantin-maier.com/group-functions/ungroup-dissolve-and-delete-groups#delete-layer-clone-group).

## *Rename Layer/s* Bugs

* **(Only on Mac:)** On the renaming panel, when flipping forward or backward through the naming levels, the new name level will **not** be selected (as compared to the Windows version).
  * **Workaround:** Hit Cmd+A to select the name level.

## *Relabel Layer/s* Bugs

* *(Solved?)* On some machines, an error message might come up when trying to open the relabel panel. This is because *Workflower* has to rely on a workaround to read AE's label colors. If that is the case, contact customer support with specific details about the After Effects version, language, etc., so we can fix this issue.
  * **Workaround:** To relabel groups, you can also just come up to the group header, select another label color using AE's native label dropdown, and then hit *Refresh Layout* to relabel the entire group.

## *Reveal Layer Opacity* Bugs

* When revealing the opacity of a layer with time remapping enabled, the *Time Remap* property will be revealed as well.
  * Unfortunately, there's no workaround to this problem.