VersionUp
A Premiere Pro plugin that versions a sequence in one click – archives the old copy, keeps your bin structure, and leaves you working on the sequence you were already on.
Overview
Versioning a sequence by hand is four steps – duplicate, rename, drag into a folder, and try to remember which one the client approved. VersionUp does it in one click.
The part that matters most: most tools move you onto a new copy and leave you hunting for it. VersionUp renames the sequence in your timeline and archives the duplicate instead. Your open tab never changes. The sequence you can see is the sequence you are working on, always.
Three buttons, and each one says what it is – Version up, Approve and Project. Nothing here needs learning: the words are on the buttons, and resting on one shows you the exact name it is about to write.
Requirements
| Premiere Pro | 25.6 or newer. Check under
Premiere Pro > About Premiere Pro. Earlier versions cannot run it – VersionUp
uses Adobe's current plugin system (UXP), and there is no build for older releases. |
|---|---|
| System | macOS or Windows. |
| Licence | One key covers two machines – a desktop and a laptop. A Studio key covers ten. |
Install and activate
The short version:
- Open the order email from NK Courses. It has your licence key and the download link.
- Download
VersionUp.ccxand double-click it. Creative Cloud Desktop installs it for you – nothing to unzip. - Quit Premiere Pro and open it again. Premiere only looks for new plugins at startup.
- Window > UXP Plugins > VersionUp.
- In the plugin, open the ☰ menu > Help & licence, paste your key and press Activate.
Double-clicking did nothing? Open Creative Cloud Desktop first, then double-click the file again. Still nothing, or a message saying Creative Cloud cannot open it? Install it from Terminal or Command Prompt instead.
Quick start
- Open a project and select a sequence, or just have one open in the timeline.
- Press Version up.
- Look at your Project panel: the previous version is now in a
_Previousbin with a colour label, and the sequence in your timeline has the new number.
That is the whole loop. Everything below is detail.
Version up
Duplicates the sequence, bumps the number, and files the old copy away with a colour label. Four fiddly steps become one.
Your folder structure is rebuilt inside the archive, not flattened. A 9x16
archived from a 9x16 bin lands in a 9x16 bin inside _Previous – not in one flat heap
at the bottom of the project.
It reads the names you already use. v03, V03,
v1.4, 001 and dates all count on in their own style. Count work inside a
round, like V1_WIP01? Version up gives V1_WIP02 (REV, R and DRAFT work the
same way). Want a capital V on new versions? Settings → Buttons → Version up → Click
→ Case gives Brand Film_V01. A name that already has a version
keeps its own case, so Cut_v03 still becomes Cut_v04.
Undo takes it back. Cmd-Z (Ctrl-Z on Windows) undoes a version up in two presses, and the same two presses undo a whole batch of twenty. A new bin costs one extra press the first time it is made.
Four ways to click Version up
Hold a key as you click and Version up does something different. The symbol on the button changes the moment you hold the key, so you can see which one you are about to get before you press anything.
| Symbol | Click | What it does | Example |
|---|---|---|---|
| Click | The next version. The old one is filed in _Previous and you stay in the sequence you are cutting. | Brand Film_v03 → Brand Film_v04 | |
| Alt-click Option on a Mac | An alternative. A copy beside the original, filed in an ALT bin and opened. The original is not renamed or moved. In Settings it can keep the version, as here, or move on one (ALT_v04). | Brand Film_v03 → Brand Film_ALT_v03 | |
| Shift-click | A new major version, for when the brief changes rather than the trim. The number after the dot resets to 0 (or 1, if you choose that in Settings). | Cut_v4.4 → Cut_v5.0Brand Film_v03 → Brand Film_v04.0 | |
| Cmd-click Ctrl-click on Windows | Your own naming pattern, from Settings → Buttons. The pattern needs {version} in it. | Pattern {client}_{project}_{name}_{version}, Client ACME, Project Harbour:Brand Film → ACME_Harbour_Brand Film_v01 |
Rest on the button for a second and the plugin lists all four with the real names it would write for the sequence you have selected, and lights the row for the key you are holding. Holding Alt and Shift together makes an alternative – Alt wins.
Choosing what to version
| Select nothing | Versions the sequence open in your timeline. |
|---|---|
| Select sequences | Versions every one you selected in the Project panel. |
| Select a bin | Versions everything inside it, at any depth. |
A batch is planned against the current state of the project as it goes, so twenty at once can never collide with itself. One failure does not stop the rest.
Approve
One click marks the cut the client signed off: moves it into your approved bin, colours it
green, and renames it – Brand Film_MASTER. Findable from the Project panel weeks
later without opening the plugin at all.
Approving an old version is allowed, on purpose. Clients sign off v03 while you are already on v05. The approval marker replaces the version and date, because an approved cut is a deliverable rather than another rung on the ladder.
Press it twice and nothing bad happens. Already approved means re-coloured, not re-moved.
Four ways to click Approve
Not every cut that leaves the edit is the final one. Hold a key as you click Approve and the cut goes into a bin for that stage instead, with its own colour, so the Project panel shows at a glance what went to the client, what is out for review and what was delivered. The thumb on the button turns into the key's symbol the moment you hold it.
| Symbol | Click | Stage | Example |
|---|---|---|---|
| Click | Approved. The cut the client signed off: filed in APPROVED, coloured green, renamed with _MASTER. | Brand Film_v03 → Brand Film_MASTERin APPROVED | |
| Alt-clickOption on a Mac | Sent. What went out to the client. Filed in Sent, coloured Cerulean, and the version is kept so you can see which one went. | Brand Film_v03 stays Brand Film_v03in Sent | |
| Shift-click | Review. Out for comments. Filed in Review, coloured Mango.Off until you switch it on | Brand Film_v03 stays Brand Film_v03in Review | |
| Cmd-clickCtrl-click on Windows | Delivered. Handed over. Filed in Delivered, coloured Iris.Off until you switch it on | Brand Film_v03 stays Brand Film_v03in Delivered |
Make them yours. In Settings → Buttons → Approve, pick a key and change its Label, Bin, Where, Colour and Suffix, or switch it off. A key that is off does a plain Approve. The symbol belongs to the key, so Shift is always the speech bubble whatever you call it.
Each key chooses its own name. Out of the box Sent, Review and Delivered leave
the name alone. Pick Use label name and Brand Film_v03 becomes
Brand Film_v03_SENT, or type your own suffix, which can use the same tokens as a
custom name, like the date. The suffix always goes after the version. The plain Approve click
ends in _MASTER, _FINAL, your own word, or leaves the name alone.
Counting work inside a round? If your names run V1_WIP01,
V1_WIP02, switch on Drop the WIP number for that key. The cut goes out
as V1 (or V1_SENT with a suffix), and Version up on it starts the next
round, V2_WIP01.
Or leave the cut where it is. Set any key's Where to Leave in place and Approve only colours and renames the cut, with no bin made. The other choices are drawn in Where each bin goes.
A sent cut is never touched again. Version up on it leaves it in its bin and puts the new version back in your working folder, the same as an approved cut.
Rest on Approve with one sequence selected and each key's row shows the exact name it will make,
like Test_V1_WIP02 → V1. A press that keeps the name shows its bin instead.
Versioning an approved cut leaves it alone. The approved cut stays in your
approved bin, untouched, and the new version goes back to your working folder without the approval
word: Brand Film_MASTER versions up as Brand Film_v02, not
Brand Film_MASTER_v02. An alternative made from it drops _MASTER too.
Undo is one press, even for twenty cuts approved at once.
Project
Versions the .prproj itself – Job_v01.prproj becomes
Job_v02.prproj, and the new file becomes the one you are working in.
This one cannot be undone. Everything else in VersionUp can be undone with Cmd+Z (Ctrl+Z on Windows); saving a project writes a file. That is why the button shows you the name it is about to use.
It will not save over a project that already exists. Because the write cannot be undone, a click that would land on a filename already on disk is stopped and the plugin says so, rather than quietly replacing a day’s work.
The Project button takes the same modifier keys as Version up, plus one of its own:
| Click | The next project version – Job_v03.prproj |
|---|---|
| ⌥ Alt-click | An alternative – Job_ALT_v03.prproj, beside
the original. Also works when the guard is blocking an old project file. |
| ⇧ Shift-click | A new major – Job_v04.0.prproj |
| ⌘ Cmd-click (Ctrl-click on Windows) | Shows the current project’s folder. Nothing is written. |
Your version history
At the foot of the plugin is a Versions strip. It starts closed; click it to open. It lists what VersionUp has made and when, so you can answer “when did I last version this?” without going anywhere near the Project panel.
- Sequence and Project tabs appear once there is something in both.
- A green tick marks a cut that was approved, with the date it happened.
- Click a sequence row to open that sequence in the timeline. The one you are in now is marked with a blue edge.
- Select a sequence in the Project panel to see all its versions, not only the one in the timeline, including versions made on another computer.
- Click a project row to show that file’s folder, with its full path copied to your clipboard.
It only knows what it did itself. A version you made by hand, or one from before you installed VersionUp, shows as no record rather than a guess. If a cut merely carries your approved suffix in its name, it gets a tick with no date – recognised, not remembered.
You can put it away. Settings → Panel → Show version history. It is on to start with; turn it off and the strip goes, giving that height back to the buttons – useful if you keep the plugin docked short. Nothing is forgotten: VersionUp carries on recording, and switching it back on shows everything it made while the strip was hidden.
The wrong-version guard
Open an old sequence by mistake and an amber banner says so, names the newer version, and offers to jump you straight to it.
It watches the project file too
Open Job_v02.prproj from your recent files while Job_v04.prproj sits in
the same folder, and the same amber banner says so: You’re in Job_v02.prproj.
Job_v04.prproj is newer.
Show folder opens the folder the newer file is in and copies its full path to your clipboard, so you can open it straight away. VersionUp does not open it for you – it shows you where it is.
While you are in the older file, the Project button won’t version it. If you really do mean to work from the old one, Alt-click Project to branch an alternative from it on purpose.
Both checks follow one switch: Settings → Panel → Block VersionUp on an old version. It is on to start with. Turn it off and the banner still warns you, but nothing is blocked.
Alt-click: an alternative
Hold Alt – Option on a Mac – and click Version up. Instead of advancing
the version, VersionUp makes a copy, Brand Film_ALT_v03, files it in an
ALT bin and opens it, so you carry on in it. The original is not renamed and not
moved.
For the version of a cut you want to try without giving up the one you have.
In Settings → Buttons → Version up → Alternative you can change the word
(ALT), keep the version (Brand Film_ALT_v03) or move on one
(Brand Film_ALT_v04), or pick Next letter, so a03
becomes b01.
Alt-click Project does the same thing to the project file –
Job_ALT_v03.prproj beside the original. Showing the project’s folder moved to
⌘ Cmd-click (Ctrl-click on Windows) so that Alt could mean the same
thing on every button.
Rest on any button for a second and the plugin shows you what each key does – with the real name it would write, not a placeholder – and lights the row for the key you are actually holding.
If a row never lights up, that key is not reaching the plugin. Alt is the one to rely on. Premiere does not always pass Cmd and Shift through to a plugin, so the plugin still lists them but cannot promise them on every system – and showing a project’s folder is also one click on its row in the Versions strip, with no key held at all.
Shift-click: a major version
Hold Shift and click Version up. Cut_v4.4 becomes
Cut_v5.0 instead of Cut_v4.5 – a new major version, with the minor
number back at 0. Prefer it to start at 1? Settings → Buttons → Version up → New major
→ Resets to.
For the cut that has been through four rounds of notes and is now a different edit, rather than the next revision of the same one.
If your names have no major part, Shift makes one. Brand Film_v03
becomes Brand Film_v04.0, and ordinary clicks after that run v04.1,
v04.2 and so on.
It works whatever naming format you use. With a custom pattern, Shift keeps the
name you have and raises its number – Brand Film_v03 becomes
Brand Film_v04.0. The only name it can't raise is one with no version number in it,
and it says so and changes nothing.
It counts on from the highest major in the project. Shift on
Cut_v1.7 while a Cut_v2.3 exists gives Cut_v3.0, so a new
major never clashes with one you already have.
Holding Alt and Shift together makes an alternative. Alt wins, and the plugin says so while you are holding them.
While it is working
Press a button and it dims and reads WORKING… until Premiere has finished. The count stays on screen, so you can still see how many sequences it is working through.
It does not spin, and that is deliberate. Premiere stops the plugin completely while it duplicates and saves – nothing in it can move, including a spinner. A frozen animation reads as a crash; a button that plainly says it is working does not.
Naming and tokens
☰ > Settings → Buttons. Pick a button (Version up, Approve or Project), then pick a key: a plain click, or a key held as you click (Option, Shift or Cmd on a Mac; Alt, Shift or Ctrl on Windows). The section underneath shows that press's settings and, under Makes, the exact name it will give.
Names are built from tokens. Tap one to drop it into the pattern you are editing – the
row of tokens always sits under that box. A token already in the pattern turns purple; tap it
again to take it out, since each one can only be used once. If a pattern uses a client, project,
job number or initials that is not filled in, its token turns red and a line under it says so.
{dimensions} is not offered for a project file, which has no frame size. A pattern
only contains what you put in it, so leave out {name} and the sequence's own name is
not in the result.
Choosing Custom as Version up's Format opens the same pattern as ⌘-click right there, so a plain click and ⌘-click share one pattern.
| Token | Becomes |
|---|---|
{name} | The sequence's own name |
{version} | v01, v02, v03… |
{project} | The project file's name, unless you type another in the Project box |
{client} | Whatever you type in the Client box |
{job} | The job number from the Job no. box |
{initials} | Yours, from the Initials box |
{date} | Today, in the order you choose |
{time} | The current time |
{dimensions} | The sequence's frame size, e.g. 1920x1080 |
{dimensions} is the one worth knowing about: a 1080x1920 and a 1920x1080 name
themselves apart without you typing anything.
Save as preset… keeps a ⌘-click pattern by name, and it joins the Click format list for when you want it on a plain click too. Or leave the defaults alone – they are sensible.
Project version names
Alternatives of the project file get their own pattern, in the Project section of Settings → Buttons, with the same tokens as above.
Ready-made presets cover most of it – ALT + same version,
ALT + next version, ALT + date, ALT + date + time,
ALT + date + version, or the built-in naming. Each keeps the project's name first
with ALT just before the version, so Job_v08 gives Job_ALT_v08 (or
Job_ALT_v09 with next version). Pick one and the pattern fills itself in; edit it
afterwards and your edit stands.
{dimensions} is not offered here. A .prproj has no frame size, so a
token for it would only ever come out blank. One extra token is: {next}, the version
one up from the project's own.
Client, Project, Job no. and Initials live in Project setup, under the Project button in Settings → Buttons, shared by every pattern. Client, Project and Job no. are saved with each project file; your initials are the same everywhere. The date order is set there too.
Bins and colours
Call the bins what you already call them. Each press sets its own bin, right beside its name
in Settings → Buttons: Version up's plain click sets where old versions go
(_Previous), its Alt-click sets Alternatives (ALT), and
Approve sets APPROVED, with Sent and your own keys beside it. Each
has the same three settings: the Bin name, Where it sits, and
the Colour its sequences get.
The colours start different for each, so old versions, alternatives and approved cuts stay distinct at a glance in the Project panel.
Where each bin goes
Every press that files something has a Where, with the same four choices: Version
up, its Alt-click, Approve and each Approve key. Below is the same sequence each time,
Cut_v04 in 00 SEQUENCES / SOCIAL / 15s, after a Version up. The bin and the
old version are in tan, the colour old versions get; the new version stays where it was.
At the project root
The bin sits at the top of the project, with your bins rebuilt inside it.
In the top-level bin
Inside the outermost bin the sequence is in. Out of the box, every bin goes here.
Next to its bin
Beside the sequence's own bin, one level up, so the filed copy stays close to where you work.
Leave in place
No bin at all. The old version stays beside the new one, coloured so you can tell them apart.
Mirror bins off
Every filed cut goes straight into the one bin, with no bins inside it. With At the project root, that is a single _Previous for the whole project.
Mirror bins sits under Where and is on to start with: the bins your sequence sits in are rebuilt inside the new bin, so you find the cut by the same path you always do. It is hidden for Leave in place, which makes no bin.
See it for your own sequence. Under each Where, Show examples draws this same picture using the sequence you have selected, with its real bins and names (or an example when nothing is selected). It starts hidden each time Settings opens.
Approve and its keys work the same way: swap _Previous for APPROVED,
Sent, Review or Delivered, and the cut that moves is the one
you approved.
Hiding buttons and docking
Hide the buttons you don’t use. Any of the three, Version up included. Turn one off in Settings → Panel and the plugin reshapes around what is left – two side by side, or one taking all the room – with no empty band where a button used to be.
The last button on cannot be switched off. An empty plugin has no obvious way back.
Show hover tips, on that tab, turns off the read-out that appears when you rest on a button, listing what a click and each key would do. Switch it off once you know them.
It fits any dock. Four layouts, and you never choose between them – the plugin picks whichever one fits as you drag it.
- Two rows and a project bar. The full layout. Version up and Approve fill the space with their names under them, and Project sits as a wide bar underneath showing the filename it would write.
- Three full-width bars. Docked as a narrow vertical strip beside your timeline, each button takes the whole width with its name beside the symbol, rather than three squares squeezing across.
- Three across in one row. Wide but short – no room for the bar as well as the buttons, so Project joins the other two as a third named tile.
- Icons only. Squeeze past either of those and the words step aside – all three together, never some of them – leaving the symbols.
There is a floor. Below the width at which a button can still hold its symbol, the buttons do not keep shrinking – they step aside too, and the plugin shows WIDER until you give it room again. Nothing is lost and nothing is switched off; drag the edge back and the buttons return exactly as they were.
Parked as a narrow column beside the timeline is what it was built for. If you only ever use Version up, turn the other two off in Settings → Panel and it will happily live in a strip barely taller than one button – and if Version up is the one you never press, that can go instead.
Your licence
One key, two machines – a desktop and a laptop, or a work machine and a home one. One payment, no subscription.
Studio licence: one key for up to ten machines, for a team or an edit suite. Everyone activates the same key the same way, and the Help & licence window shows how many of the ten are in use. Remove works exactly as below.
Changing computer? Open ☰ > Help & licence on the machine you are leaving behind and press Remove. That frees the seat immediately, so you can activate the new one straight away.
Updates
VersionUp tells you when there is a new version – a quiet bar at the top of the plugin, never a nag. Wave it off and it stays out of the way; it will not pester you about the same version twice.
Updates are free. Press Update in the bar: VersionUp downloads the new version and
Creative Cloud asks once to replace the current one. Click Replace and VersionUp reloads – no file to
find and no restart. Your licence key stays activated. (One-click Update arrived in 1.5.4; on an older
copy, or if Update can't install from inside Premiere, download the .ccx from the link in
your licence email, double-click it, and restart Premiere.)
☰ > Help & licence checks straight away, every time you open it, and says under the version number whether you are up to date. Use it if you have heard a new version is out and the plugin has not mentioned it – the automatic check runs at most once a day, so there is a window where a release exists and your copy has not looked yet. Press Check for updates at the bottom of the window to ask again at any time: the answer appears in its place, telling you whether you're on the latest version, and if there is a newer one it offers Update and What's new.
Release history
Every version, newest first.
Loading the release history…
Sending feedback
☰ > Send feedback. Tell me it's a bug, a feature request or a testimonial, write what happened, and press Send. Your email is optional, but without it I cannot reply.
Pick Testimonial and two more boxes appear: who to credit, and a switch saying I may quote you on the website. Nothing is ever quoted without that switch turned on, and you are welcome to send kind words with it off.
One report per thing, please. And if something happens twice, say so – knowing a fault is repeatable is worth more than a long description of it.
What is and isn't collected
VersionUp does not collect or transmit any project data, file names, or usage data. Feedback is sent only when you click Send – it includes your message, your optional email, your operating system and the app version.
Nothing is sent in the background, and nothing about your projects, sequences, bins or clients ever leaves your machine. The plugin talks to the network for exactly two things: checking your licence key, and checking whether an update exists.
Troubleshooting
Double-clicking the .ccx did nothing, or said “Creative Cloud cannot open files of this type”
Creative Cloud Desktop has to be installed and signed in. Open it first, then double-click the file again. That fixes most cases.
Still not working? Your Mac or PC has lost track of which Adobe app opens .ccx files. Nothing is wrong with the file. Install it with Adobe’s own plugin installer instead, the same one Creative Cloud uses behind the scenes. Quit Premiere first.
Mac: open Terminal (Applications > Utilities), paste this, type a
space, then drag VersionUp.ccx into the Terminal window and press Return:
"/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/MacOS/UnifiedPluginInstallerAgent" --install
Windows: open Command Prompt (not PowerShell), paste this, type a
space, then drag VersionUp.ccx into the window and press Enter:
"C:\Program Files\Common Files\Adobe\Adobe Desktop Common\RemoteComponents\UPI\UnifiedPluginInstallerAgent\UnifiedPluginInstallerAgent.exe" /install
Dragging the file in types its exact location for you, wherever it was saved. When it finishes, restart Premiere and look under Window > UXP Plugins. Still stuck? Email me and I will sort it with you.
VersionUp isn't in the Window menu
Check Premiere Pro > About Premiere Pro – VersionUp needs 25.6 or
newer. And look under Window > UXP Plugins, not Window >
Extensions; that menu is for the older kind of plugin.
My licence key was refused
Re-copy it – a trailing space is the usual culprit. If you have used both machines, press Remove on one you no longer use to free the seat.
The buttons are greyed out
Either there is no licence key activated yet, or there is no project open. Add your key in ☰ > Help & licence.
Only the Project button is grey? You are probably in an older project file and a newer one is sitting in the same folder – see It watches the project file too. The amber banner at the top of the plugin says which file is newer.
There is no trial or free mode. Until a key is activated, all three buttons are disabled and the plugin does nothing – so if you have just installed it and everything is grey, that is the licence, not a fault.
Nothing happened when I pressed a button
If the button is greyed and reads WORKING…, it is running – give it a moment. Premiere stops the plugin while it saves, so nothing on screen can move until it is done.
Otherwise, open the log at the bottom of the plugin – it says what ran and what it did. If the button was greyed out before you pressed it, either nothing was selected, or a newer version of that sequence already exists and VersionUp is refusing to branch off an old one.
The Versions list says “no record”
That version was not made by VersionUp – renamed by hand, or made before you installed it. The plugin says so rather than inventing a date. Everything you version from here on will be listed.
Cmd-click (Ctrl-click on Windows) or Shift-click does nothing
Premiere does not pass every modifier key through to a plugin on every system. Rest on the button first: if the row for that key never lights up while you hold it, the key is not reaching VersionUp. Alt is the reliable one. To show a project’s folder without a key, click its row in the Versions strip.
What it doesn't do
- It won't tidy an existing mess. It stops the mess starting from the day you install it.
- It doesn't sync, share or back anything up. It renames and moves things inside your project.
- Project versioning can't be undone. Everything else can be undone (Cmd+Z, or Ctrl+Z on Windows). VersionUp will at least refuse to write over a project file that already exists.
- It doesn't replace autosave. Different job entirely.
Support
The quickest route is ☰ > Send feedback inside the plugin – it attaches your version and system automatically, which saves us both an email.
Otherwise: support@nkcourses.co.uk. I am one person, so it might take a day, but it will be me answering.
VersionUp