Troubleshooting
Real behaviors, what they mean, and what to do.
Offline and connection
Section titled “Offline and connection”“Offline mode, showing last synced data” Your device lost its connection; CineFlow is serving the last synced copy of the project. Reconnect and the app refreshes automatically. CineFlow verifies connectivity with a real network probe, so this banner reliably means you are actually offline.
“Cannot reach CineFlow, showing what was last saved here” The same situation seen from the other side: your device believes it is online, but CineFlow itself cannot be reached. A captive portal, a hotel or airport network that has not been signed into, a VPN, or an outage on our side all look like this, and so does the desktop app with the Wi-Fi off, because the desktop serves itself from your own machine and so never reports itself as offline. The page keeps showing what was last saved on this device rather than emptying out, and it refreshes on its own once CineFlow can be reached again.
Your project name, your account and your permissions while CineFlow cannot be reached CineFlow keeps showing you what it already knew. Your project keeps its name, your account keeps its name, and you keep the access you had, so a production you own does not turn into a read only one because a request did not go through. The catch is that this is the last answer we could get, not necessarily today’s: if your access to a project was changed while you were disconnected, you can keep editing until you reconnect, and those edits are refused when you do, with “You do not have permission to make this change. Ask the project owner for edit access.” If that happens, ask the owner to restore your access and redo the work.
Opening a document while CineFlow cannot be reached A rich text document, a script or a beat board you have opened at least once on this device opens again with no connection, with the text you last had, and you can keep writing in it. It is the copy on your own machine, and CineFlow says so: on a document opened on its own you get a small Cannot reach CineFlow, showing what was last saved here marker at the bottom of the screen, and inside a project the same line sits with the project’s other offline notices. Closing the app, or force quitting it, does not lose anything: the next time you open it, connected or not, your work is there. When CineFlow can be reached again your changes merge with anything other people did while you were away, and nothing is overwritten in either direction.
A project, document or script you have never opened on this device has nothing saved to fall back on. CineFlow says so plainly rather than guessing, so you will see “We could not load this document” or “We could not load this script” with a Try again, not a claim that the thing was deleted. A document that really has been deleted says “This document no longer exists” instead. That answer needs the server, so you see it when CineFlow can be reached; while it cannot, a deleted document reads the same as any other one that could not be loaded, because from here the two are genuinely indistinguishable.
“We could not reach CineFlow, so this change was not saved. Check your connection and try again.” An edit that could not be sent. On the pages that queue offline edits you would see “Saved offline. Will sync when you reconnect.” instead; this message is the honest version for everywhere else, and it means the change is gone rather than waiting. Reconnect and make it again.
“Editing unavailable offline” Some pages (callsheet list, gear, cast and crew overview, scene creation) are read only while offline. Other surfaces keep working offline: shot edits, availability, and the script and document editors, which show confirmations like “Saved offline. Will sync when you reconnect.”
After reconnecting: “Synced N offline changes” Queued offline edits replay automatically. “N changes failed to sync, will retry” retries on the next reconnect. “N changes could not be synced and were set aside” means those specific edits could not be applied (for example access changed in the meantime); redo them manually.
“Editing offline. Changes will sync when you reconnect.” / “Connection lost. Reconnecting…” Script and document editors keep your edits locally and reconnect on their own; no action needed.
“Editing offline. Keep this tab open until you reconnect: no backup could be saved on this device.” Rare, and only in the document editor. Your browser refused to keep a local copy of the document, which Safari on iPhone and iPad sometimes does when a tab has been in the background or the device is short of memory. Your edits are still in the page and still sync the moment you are back online, but they are not written to this device, so closing the tab or reloading before you reconnect would lose them. Keep the tab open until the banner goes away. Reloading once you are back online clears it.
“You’re offline. This page couldn’t be loaded.” You navigated to a page that was never loaded on this device while offline. Reconnect and click Retry.
After an update
Section titled “After an update”“A new version is available.” A new CineFlow version was deployed while you had the app open. Click Update now to reload into it. If a page briefly reloads itself once after a deploy, that is the app fetching the new version and is expected.
Desktop app
Section titled “Desktop app”On Windows, the app asked you to sign in again after an update Once, and only once. The Windows app used to serve itself from a different internal address, and a browser keeps your sign-in, your open tabs and anything saved offline against that address. Moving the app to the address the Mac version already uses is what fixes canvases going blank on Windows, and it starts that storage fresh. Sign in again and everything you have synced is where you left it, because your projects and documents live in your account rather than on the computer. Your open tab groups do not come back; reopen the projects you want and the app remembers them from then on. No later update does this again.
The one thing to watch: edits you made while offline that have not synced yet. If you saw “Saved offline. Will sync when you reconnect.” on a shot list or an availability change and you have not been online since, that edit is held against the old address and the update cannot carry it across. So before you update, open CineFlow while you are connected and let it finish syncing. If you have already updated and something offline is missing, contact support with the log file described below before making the edit again.
On Windows, a whiteboard, diagram, slides or drawing area goes blank a few seconds after it opens Fixed in the Windows app released after v0.2.6. The canvas painted, then cleared itself about five seconds later and clicks in the empty area did nothing. Update to the newest Windows build. On that first launch you are asked to sign in again, which is expected and explained above.
Desktop notifications do not appear These checks apply to the desktop app from its next release. Check, in order: the row in Settings, Notifications is set to Push or Both (a row set to Email shows no desktop notification); CineFlow is in the background, since while it is in front the bell shows the activity instead; and CineFlow is allowed to notify. If it is not, the Notifications settings say “Notifications from CineFlow are turned off in System Settings” (or Windows Settings) with a button that opens that page. On Windows, Focus assist or Do not disturb hides notifications without telling CineFlow, so check those too. On Windows CineFlow has to be running; on a Mac it keeps running after you close the window, until you quit it.
The desktop app says “CineFlow cannot start” From the desktop app’s next release. The app runs on a private network port on your own computer, 17421, and it will not open while another program is using that port, because that program’s page would then run inside CineFlow. Quit the other program, or restart your computer, then open CineFlow again. If the message stays after a restart, contact support and attach the log file below; the log names the port it could not use.
Opening or saving a file in the desktop app From the desktop app’s next release, the app reads and writes only its own data folder and the files you choose in an open or save window. Importing a script or saving a PDF works the same way as before: pick the file, or choose where to save it, and CineFlow can use that one file.
Support asked for the desktop app’s log file
The desktop app keeps a log file on your computer and sends it nowhere by itself. On a Mac it is cineflow.log in ~/Library/Logs/cloud.cineflow.desktop. On Windows it is cineflow.log in %LOCALAPPDATA%\cloud.cineflow.desktop\logs, which is usually C:\Users\<your name>\AppData\Local\cloud.cineflow.desktop\logs. Attach that file to your message. It records errors and what the canvas was doing, and never your sign in, your e-mail address or the contents of your documents.
“Windows protected your PC” when running the installer SmartScreen warns because the Windows build is not yet code-signed. Click More info, then Run anyway. See Getting started.
“CineFlow is up to date.” but you expected a newer version The update check found no newer build for your platform. Download the latest build from the link in Getting started.
“Could not reach the update server.” / “The update server is temporarily unavailable.” Check your connection or try again later. Check for Updates… repeats the check on demand.
“The update’s signature could not be verified, so it was not installed.” The downloaded update did not match CineFlow’s signing key, so it was refused. Download the latest build directly instead and contact support.
“The update is installed. Quit and reopen CineFlow to finish.” Windows sometimes closes the app before it can restart itself. Reopen CineFlow from the Start menu.
You paid in your browser and the app did not reopen Payment happens in your browser, not inside the Mac or Windows app, so the page you land on afterwards has to hand you back. It says Payment complete and reopens CineFlow by itself. Some browsers will not open an app without being asked, so if nothing happens, press Open CineFlow on that page. Your plan is applied either way: it is granted when the payment clears, not when you get back. If you have closed that page already, just switch to CineFlow and open Settings, Usage and billing.
“Open another page in this project to split with.” A split shows two different pages of one project, and the tab you chose would put the same document in both panes. Open another page of that project and split again, or pick a different page for the other side.
“Open a project to show this document beside.” A standalone document does not split on its own: it is shown beside a page of whichever project is in front, and it never joins that project. Open the project first, then use Show beside the current page in the picker (Cmd T) or Show in split on the Documents group.
Signing in and sessions
Section titled “Signing in and sessions”“You’ve been logged out. Your session expired.” The session genuinely ended (expiry or revocation). Click Log in again; you return to where you were.
“Reconnecting to your account.” CineFlow could not reach your account several times in a row, so it has stopped asking for a few moments rather than retrying over and over. You are not signed out and nothing has been lost: whatever page you were on keeps working. It clears by itself as soon as your account answers again, usually within a minute, and you never have to reload or sign in again to get out of it. Press Try again if you would rather not wait. If the same message keeps coming back over a longer period, your connection is dropping rather than your session.
“Close your other CineFlow tabs to finish switching accounts” or “CineFlow could not clear the previous account’s saved data on this computer” CineFlow keeps a copy of your recent work on your computer so it still opens without a connection, and it clears that copy when a different account signs in. Until the clear has finished, CineFlow will not show you the copy, so you are never shown anything belonging to the account before yours. One of these lines appears when the clear could not finish after a few tries of its own. The first asks you to close your other CineFlow tabs and windows, because one of them can still be holding on to part of the copy. The second means your computer’s storage refused, and restarting CineFlow is what usually clears that. In both cases CineFlow has already stopped trying by the time you see the line, so press Try again once you have closed the tabs or restarted: that is what starts it off again. You are not signed out, nothing you have saved is lost, and the rest of CineFlow works normally while the line is showing: the only thing missing is the copy you could otherwise open with no connection. The line goes away on its own as soon as the clear succeeds.
“Wrong email or password.” The email and password do not match an account. On CineFlow’s sign in screen, press Reset password beside the message to choose a new password, with the email you typed already filled in, or Sign up if you do not have an account yet. If you signed up with an email code and never chose a password, press Email me a code beside the message, or Email me a code instead under Sign in, and sign in with the 6 digit code we email you. If you joined with Apple or Google, use that button instead.
“You already have an account” The email you typed has a CineFlow account, and CineFlow and Backlot share one account per email. On the sign up page, press Sign in and your email is already filled in. If the account was made with Apple or Google and has no password, the message says which button to use, on the sign up page, on CineFlow’s sign in, and on Backlot’s Log in. Reset password or Forgot password? lets you add a password to it.
“Confirm your email first.” The account’s email address has not been confirmed yet. Find the code we emailed you when you signed up.
“Too many tries. Wait a minute.” Too many sign in attempts in a short time. Wait a minute and try again.
“This account has been suspended.” The account was suspended by the CineFlow team, so signing in to CineFlow and the desktop app is refused, and any device it was signed in on is signed out. Nothing in the account is deleted. If you think this is a mistake, write to support@cineflow.cloud from the account’s email address.
Signed out after closing the browser Remember me was unchecked at sign in, which makes the session end when the browser closes. Sign in with it checked to stay signed in.
A new password is refused Signing up, an emailed password reset and changing your password in Settings all need at least 8 characters, with upper and lowercase letters and a number.
Sharing and invites
Section titled “Sharing and invites”A visitor sees “This share link doesn’t exist.” or “This share link is invalid or has been disabled.” The link was revoked, expired, or mistyped. Create a fresh link and send it again.
“Callsheet unavailable. This link may be inactive or the callsheet has not been published yet.” Callsheet links deliver published versions only. Open the callsheet, click Publish in the Share popover, and the link starts working.
A share link does not show my latest changes Links serve a frozen snapshot. Click Update link to latest on the link’s row (or Publish update for a callsheet). Visitors with the page open get a Refresh banner.
“Invite not found, expired, or already used” The invite link is no longer valid. Send a new invite.
I invited someone by @username and they never got it CineFlow gives the same answer for every username, so it cannot tell you whether the account exists. Check the spelling of the username, revoke the pending invite, and invite again, or invite their email address instead. A project Admin can also click the copy icon on the pending invite to copy its link and send it directly.
“Too many invites sent just now. Try again later.” Each person can send up to 20 invites by username and 20 by email in an hour, and 100 of each in a day, half that in an account’s first week. Wait and try again.
“This project’s team is full. Ask the project owner to upgrade their plan, then try again.” The owner’s plan has no project collaborator places left. The pool is account-wide, not per project, and counts distinct people across every project the owner has, live pending invites included. The owner can upgrade, buy an Additional project collaborator add-on, or free a place by removing the person from every project they are on and revoking any pending invite to them, then re-invite. Archiving a project alone does not clear a pending invite. See Billing and usage.
A collaborator sees “You don’t have access to this page” Their per-page access for that page is set to none. A project admin can change it under the member’s Custom access menu.
Limits and upgrades
Section titled “Limits and upgrades”A control asks a question such as “Need more projects?” with Upgrade, says “Limit reached”, or a dialog says “Project Limit Reached” You reached an enforced plan limit; the dialog names it (Project, Collaborator, Team Member, Workspace, Document, Export or Storage Limit Reached) and the smallest plan that lifts it. Archive or remove items, or upgrade. See Billing and usage.
A button says “Owner’s limit” The limit is on the account of the project or workspace owner, so a plan on your account would not change it. Ask the owner to upgrade. See Billing and usage.
“Export Limit Reached” The monthly PDF quota is used up: on the project owner’s plan or, for a workspace document or a script exported from its own Share panel, on yours. Buy the PDF Export pack in that dialog, or upgrade. Client-side exports (slides, Word, JSON, Fountain, FDX, Outline) still work. See Billing and usage.
An AI action opens an upgrade dialog instead of running Brief import, AI import, the AI part of a script markup’s breakdown, and the descriptions written when you convert markup into a shot list need a paid plan, and brief import needs Team or higher. On a plan without one, each shows a short question such as Import with AI? with an Upgrade button where you would use it, and the trigger opens the upgrade dialog named for that feature; converting a markup that has camera lines works on Free and creates their shots without descriptions, and one with no camera line asks for the upgrade. The help Assistant and the Gear page’s catalog matching are not affected and work on Free. See Billing and usage.
A project page says “This project is no longer available” The project was deleted, or your access to it changed, while you had it open or since you saved the link. Click Back to dashboard. If someone removed you by mistake, ask the project’s owner to invite you again. An import never deletes a project, so this is never the result of an import that could not read a file.
The overview says “Imported, with 1 file left to read”, or “Your files could not be read yet” An import could not read one or more of your files. Nothing was deleted: the project, everything that was read and the files are all there. Click Try again beside a file to read just that file into the same project, or Leave it to keep the project as it is. A file marked This looks like a script. Is it? has two answers: Import as script, or Read as a document. See Brief import.
The Script page says “Filling in from your files” or “No script yet” While a project’s import is running, the Script page waits for the script to arrive rather than starting a blank one, and shows it as soon as it lands. No script yet means the project has no script: click Import a script, or Try again. If you can only view the project, its editors have not added a script.
“Checking your plan. Try again in a moment.” An AI action was clicked before your plan finished loading. Wait a moment and click again.
The Assistant says “The assistant is unavailable right now”, or a support message says “Failed to send ticket” Besides an outage, this is what you see after many requests in a short time. The Assistant answers up to 30 questions an hour and 100 a day for each account, and Contact support sends up to 5 messages in 10 minutes and 20 a day. Wait a while and try again; the pause lifts on its own. If you cannot reach support this way, write to support@cineflow.cloud from the account’s email address.
“Storage Limit Reached” Shown when an upload, such as a project cover, a script file or an image on a canvas, would go past your storage allowance. Remove files or upgrade.
Uploads
Section titled “Uploads”A file’s preview is taking a while. The first time a PDF is opened, CineFlow draws and stores every page, so a long PDF can take the better part of a minute. The CineFlow logo shows while it opens. An image shows its name and size. After 10 seconds Download appears, beside the file’s name and size, so you can take the file itself without waiting. If the preview fails it says Preview failed, with Retry and Download.
- Person photos: JPEG, PNG, or WebP up to 5 MB; save the person first, then add the photo.
- Documents page: PNG, JPEG and PDF are stored as attachments, and DOCX, PPTX, XLSX, XLS and CSV are converted into documents. Anything else, HEIC photos included, is refused with Wrong type, and a PDF over 20 MB with Too large. A drop holding both says Not added. The file name or number of refused files shows beneath.
- A document upload that fails shows Upload failed and stays until you press Retry or close it.
- Brief import, in the New project wizard’s From a brief and in the Bring a project? step of the redesigned onboarding: up to 15 files of up to 15 MB each (PDF, DOCX, PPTX, TXT or MD), or one image up to about 3.5 MB.
- Document text editor drops: images only.
Callsheet email
Section titled “Callsheet email”Recipients show Sent once the email service has accepted their address, Opened once they open it, and Confirmed when they confirm presence. An address the email service refuses is not listed at all, and the send toast names it after “Not sent to”. It also stays in the address field, while the addresses that went out are cleared from it. If the toast says an email “went out but will not appear in the recipient list”, that person was emailed but is not tracked, so their opens and confirmations will not show. If someone reports no email, check whether they are in the recipient list and whether their address is right, ask them to check spam, or send them the share link directly. A send that says “Nothing was sent. The email service could not take the request right now.” reached no one because of a problem on the email service side, not with the addresses; try again shortly. A send refused with “This share link has expired”, “This share link has been revoked” or “Share link is not active” sent nothing; create a new share link and send again. Recipient limit under the send button means the list has more addresses than one send allows (100, or 50 on Free): split it into smaller sends. Daily limit means you have reached the recipients you can email in 24 hours (500, or 150 on Free); it shows how many are left, and room comes back as your earlier sends pass 24 hours. Email unconfirmed means your own email address is not confirmed yet: open the confirmation email we sent you, then send again.
Errors and crashes
Section titled “Errors and crashes”“Something went wrong on our end. Report it?” An unexpected error was caught. Click Report to send a crash report, then reload the page.
“This canvas could not be displayed” Something went wrong drawing a whiteboard, diagram, slide deck, storyboard or PDF markup. Everything that has already synced is safe on our servers, and the error has been reported to us automatically. The panel shows the error itself: use Copy details if you are contacting support, since that text tells us exactly what happened. Leave this document takes you back to your documents, which is the one to use if reloading lands you on the same error again. Reload is worth one try. Reset data is a last resort that clears the canvas data stored on this device, including anything not yet synced; a shared document is restored from our servers the next time you open it.
“That change was too large to save” One change on a whiteboard, diagram, slide deck or PDF markup was bigger than CineFlow can sync in one go, which nearly always means a very large paste. That change was not saved, and everything saved before it is safe. Reload opens the canvas again from the last saved version, and Leave this document takes you back to your documents. To bring the content in, paste it in smaller pieces, or upload a large image as a file instead of pasting it.
A whiteboard opens blank with no error Reload the page first. If it stays blank, contact support; this can indicate a sync problem on our side rather than lost content.
Could not read pixels from <host>: it does not allow cross-origin reads.
Palette needs the image bytes, and that image’s host refuses to hand them over to a web page. Upload the image to the whiteboard instead of pasting its link.
“That image has no colour to extract.” The selected image is fully transparent or empty, so there is no palette to build.
“Could not load collaborative document/script” A server-side permission or configuration problem rather than your connection. Refresh once; if it persists, contact support.
Contacting support
Section titled “Contacting support”Ask the Assistant (see Help and support). To reach the team, ask it to put you in touch, then click Contact support under its answer to file a ticket (Bug Report, Feature Request, Billing, or General Inquiry).