Auto Updater Documentation – Ultrapack
23.377 items in the catalog7.814 updates delivered this month
963 sites receiving auto-updates through UAU
WP Adminify agora mesmo

Auto Updater Documentation

Documentation

Ultrapack Auto Updater

A complete guide to install, set up and use the UAU on your WordPress. v1.2.1

1. Introduction

O Ultrapack Auto Updater (UAU) centralises and simplifies updating the items from the Ultrapack catalogue (plugins and themes) straight from your WordPress, with no ZIP downloads and no reinstalling item by item. You decide what Ultrapack manages, without touching third-party plugins and themes.

WP Recovery Agent, and it needs one click:  o UAU usa um plugin Must-Use (MU) chamado WP Recovery Agent, which is required. It does not install itself: the first time around, the plugin shows the notice "WP Recovery Agent is not installed" with the button Enable protection. Until you click that button, updates stay disabled and Auto Updates cannot be turned on. After that click it keeps itself updated on its own. Details in section 10.
RequisitoMinimum version
WordPress6.0.3 (tested up to 7.0)
PHP7.4
MultisiteSupported, with network activation

The up-to-date list of supported items is available on the supported items page.

2. Installation

Download the plugin from the product page: Ultrapack Auto Updater. Then pick one of the methods below.

Method 1: from the WordPress dashboard

  1. Envie o ZIP

    In your site dashboard, go to Plugins → Adicionar novo → Enviar plugin and pick the file .zip baixado.

  2. Instale

    Click "Install Now".

  3. Ative

    Once installed, click "Activate". On Multisite, use "Network Activate".

Method 2: manual install (FTP)

  1. Extraia o ZIP

    Descompacte o arquivo baixado.

  2. Envie a pasta

    Over FTP or a file manager, upload the folder ultrapack-auto-updater to wp-content/plugins.

  3. Ative

    In the dashboard, go to Plugins and activate the Ultrapack Auto Updater.

On Multisite, the plugin has to be network activated to manage the sites in the network.
Right after activating:  abra o menu Ultrapack Auto Updater and click Enable protection in the notice at the top. That is what installs the WP Recovery Agent and unlocks updates.

3. Setup and token

Once installed and activated, the plugin gets its own item in the WordPress sidebar menu: Ultrapack Auto Updater, with the update icon. Every tab lives inside it, and the first one is Settings. Atalho: na tela Plugins, the UAU row has the links Settings e Force check. The API token connects the plugin to your account and is generated on the page Gerenciar sites.

With White Label on the menu item starts using the name and logo you set, so look for your own product name.
Ultrapack Auto Updater
Set up your token and enable your site to get automatic updates.
Automatic updates are globally disabled. Turn them on in "Auto Updates".×
SettingsGerenciadorAuto UpdatesSnapshotsWhite LabelLogs
Token Ultrapack
••••••••••••••••••••••••••Salvar TokenRemover Token
Nota: The current token is safe and masked. Paste a new token only if you want to replace it.
Licence information
Manage authorised sites from your account Ultrapack
Licensed toultrapack2
Current planVIP II
Valid until:25 de setembro de 2026 03:00
Domain statusAutorizado
For technical problems, questions or suggestions, get in touch at [email protected]
  1. Gere o token

    Acesse Gerenciar sites in your Ultrapack account and generate your token.

  2. Paste and save

    In the plugin, paste the value into the field Token Ultrapack and click "Save Token".

  3. Autorize o site

    Se aparecer "Site not authorised!", go to "Authorised Sites", copy your full site URL straight from the browser, paste it into the field and authorise it. Go back to the plugin and click the reload icon. The badge should turn Autorizado.

Importante:  keep your token safe. It gives access to your account downloads. You can generate a new one at any time with "Remove Token" and pasting a new one. In Gerenciar sites there is also the button Reset token: it invalidates the old token, and every site still holding it stops updating until it gets the new one.
Renewal notice:  quando o plano se aproxima do vencimento, esta aba mostra um aviso discreto ao lado do Current plan, with a link to renew. It starts showing 30 days ahead on yearly plans, 15 on quarterly and half-yearly ones and 7 on monthly ones, and turns red in the final stretch. Lifetime plans never show it, and neither does a site with White Label on.

4. Registering sites and the site limit

Every domain has to be authorised before it gets updates. The UAU limits by active domain, and each plan has a different authorisation limit. Regular sites and WordPress Multisite networks count against separate limits. Check and manage everything in Gerenciar sites.

The system also identifica sozinho when a domain registered as a regular site is in fact a Multisite network. The row then gets a notice and the button Migrate to Multisite, to fix the record. If the detection got it wrong, use Contestar on the same row and our team reviews it. While the dispute is open, the row shows the badge "Dispute pending".

Site statusWhat it meansAction
AutorizadoReady to receive updatesNenhuma
PendenteWaiting for the domain to be approvedAguardar
BloqueadoMisuse detected, or the plan quota was already full when the site was registeredContatar suporte
  1. Enter the domain

    On the "Manage sites" page, type the domain and tick "Is it a Multisite?" if it is a network.

  2. Send it for authorisation

    Click "Register new site". The site comes in as Pendente.

  3. Wait for the authorisation

    Once approved, the status changes to Autorizado and updates begin.

Need more sites than your plan gives you?  existe o add-on Extra Sites, yearly or lifetime, for 1, 3 or 5 extra sites, with no need to change plans. Regular sites only.

5. Automatic updates

The UAU has its own automatic update system, independent from the WordPress settings: even with WordPress automatic updates turned off, Ultrapack items keep being updated. Set the interval and the risk level in the tab Ultrapack Auto Updater → Auto Updates, which is split into six sections: Auto Updates, Agendamento, Notifications, Controle Manual, Sobre e WP Recovery Agent.

Auto Updates can only be turned on with the WP Recovery Agent installed. If the button is locked, that is what is missing.
Auto Updates
Set the automatic update options for the Ultrapack plugins and themes installed on this site
SettingsGerenciadorAuto UpdatesSnapshotsWhite LabelLogs
Auto UpdatesAgendamentoNotificationsControle ManualSobreWP Recovery Agent
Enable automatic updates for plugins and themes.
Up to MAJOR
Understand the levels and their risks
Sets, for every item at once, the largest automatic update allowed. Changing this level can affect the stability and compatibility of the site.
OptionDescriptionRecommendation
IntervaloHow often the plugin checks for new versions. Options: 1, 6, 12 or 24 hours6 horas ✓
Tipo PATCHFixes only (1.0.0 → 1.0.1). SafestRecomendado ✓
Tipo MINOR/MAJORBrings new features and larger changesOnly with a backup
NotificationsE-mail on success, on failure, and when an update is blocked for exceeding the allowed level. Sent through WordPress or your own SMTP, with a button to test the connectionAtivar ✓
Temporary pauseIn Controle Manual, it suspends the checks for 30 minutes, 1, 2, 6 or 12 hours, and resumes on its ownFor maintenance windows
Run check nowAlso in Controle Manual, it runs the cycle right away, without waiting for the interval. It deliberately does nothing while Auto Updates are off or pausedTo test your setup
Dica:  leave it on PATCH to update safely on its own, and use the manual update for MINOR/MAJOR versions.

6. Item manager

A aba Gerenciador (in Ultrapack Auto Updater → Gerenciador) lists your Ultrapack themes and plugins with the installed and the available version. This is where you set what Ultrapack manages and what stays with WordPress, without affecting third-party items. The Ultrapack icon on each row works as a switch: it moves the item between being updated by Ultrapack or by WordPress. Itens sob o Ultrapack exibem a mensagem "Gerenciado por Ultrapack Auto Updater".

Update manager
Choose which Ultrapack plugins and themes get updated automatically. Unticked items are updated by WordPress
SettingsGerenciadorAuto UpdatesSnapshotsWhite LabelLogs
PLUGINSTHEMESBuscar por nome...Items per page: 25 ▾
PluginUpdatesStatusGerenciamentoAuto atualizarActions
Elementor ProAutor: Elementor | Updates: 3.21.0
3.22.1 disponívelActiveAtualizar
Ultrapack Auto UpdaterAutor: Ultrapack | Updates: 1.2.1
Atualizado ActiveWN/A
  1. Abra a aba Gerenciador

    Search for the item or browse the paginated list.

  2. Click "Update"

    The plugin takes the snapshot, applies the new version and runs a smoke check: a visit to your own site over HTTP to confirm it is still responding. If the site reports a critical error, the previous version comes back on its own.

  3. Ative o auto por item

    Use the toggle on each item to leave it on automatic or manual.

Items carrying the badge Original licence follow their own rule and only change version once you confirm. See section 7. Items showing a block notice are covered in section 8.

7. Original licence protection

If an item is already installed on your site under the official licence from its author, replacing it with the catalogue version can void that licence and cut off the official updates. That is why the UAU treats those items differently: it warns you and leaves the decision to you.

  • In the automatic update, a protected item is never replaced. It is skipped and the reason is recorded in the logs.
  • In the WordPress updates list, the Ultrapack version is not offered, so the official update from the author keeps showing up as usual.
  • In the Gerenciador, o item mostra o selo Original licence and updating through Ultrapack only happens after you explicitly confirm it.

Each item has three states, set from the badge itself in the Manager:

EstadoEfeito
AutomaticDefault. Detection decides, and it recognises the item when there is a pending update from the author or an active licence registered on the site
Sempre protegerForces the protection, even when detection finds nothing
Nunca protegerReleases the item for Ultrapack to update. Use it when detection got it wrong
Since version 1.1.1 the protection applies only to the items you mark. Automatic flagging was turned off because it was protecting items by mistake and holding back valid updates.

8. Item blocked after a failed update

When an update fails because the package itself is broken, the UAU does not keep retrying in a loop. It bloqueia aquele item por 1 hora, takes the update off the list and shows a button to contact support, with the error message already filled in.

The most common case is a version mismatch: the item is announced at one version and the package carries another. The check happens before installing, so the version currently live stays untouched, and the item is neither replaced nor deactivated.

  • After 1 hour the block lifts on its own and the item is tried again.
  • If the problem persists, it gets blocked again. Use the contact button then: the fault is at the source and has to be fixed by us.
  • With White Label on, the contact points to the support channel the reseller set up.

9. Snapshots and legacy versions

The Snapshots system is on by default and makes a copy of the item before every update. If anything fails, you restore the last working state in one click. Manage it in Ultrapack Auto Updater → Snapshots. Pelas Snapshots e pelo Gerenciador também dá para instalar legacy versions (earlier ones) of the items, which come from our catalogue and not from your server.

Factory defaults: 4-day retention, at most 2 snapshots per item and a floor of 24 horas that protects the most recent snapshot of each item, even once the retention has run out. All three values can be changed in the tab itself. Turning snapshots off is possible, but takes a double confirmation, because without them the site loses the automatic rollback.

Snapshots
Manage the backups (snapshots) Ultrapack makes before every update. Restore any earlier version with one click.
SettingsGerenciadorAuto UpdatesSnapshotsWhite LabelLogs
Mandatory snapshots9 snapshot(s)
Remote legacy versions
Retention (days)4Maximum per item2Save settings
The most recent snapshot of each item is protected for at least 24h.
RecursoDescriptionRecommendation
Automatic snapshotBackup taken before every updateManter ativo ✓
RollbackRolls the item back to the previous versionUse se algo quebrar
Previous versionInstalls any version from the catalogueFor compatibility
  1. Open "Versions"

    In the Manage tab, click "Versions" on the item you want.

  2. Pick the version

    The list shows local snapshots and catalogue versions, with date and size.

  3. Click "Restore"

    The UAU safely reinstalls the version you picked.

What gets rolled back:  the rollback restores the item files to the previous version. Database changes made by newer versions may still need manual attention.

10. WP Recovery Agent

This is the extra safety layer. If an update leaves the site unreachable, the agent brings it back and, in Self-repair mode, disables the faulty item, even when WordPress itself has locked up. The administrator gets an e-mail explaining what happened and what was recovered.

It takes one click to get started:  the agent is a Must-Use (MU) plugin and needs explicit consent the first time. While it is not installed, the plugin shows the notice at the top of every tab and updates stay disabled. Clique em Enable protection to install it. From then on it keeps itself updated, with no further clicks.

The controls live in Ultrapack Auto Updater → Auto Updates → WP Recovery Agent, with the status (installed, and which version) and the switch Auto-reparo, which is on by default. With Self-repair off, the agent still brings the site back, but disables nothing on its own.

11. White label

Aimed at resellers and administrators, white label lets you restyle almost the whole plugin (logo, name, colours and your own CSS). Turn it on and set it up in Ultrapack Auto Updater → White Label. With it on, the name and the logo change even in the WordPress menu item, and the plan renewal notice stops showing, since whoever runs the end client site does not manage the subscription.

ItemCustomisable
Logo and namePlugin header and footer
CoresReady-made presets or a custom colour
CSSYour own CSS, scoped to the plugin
AcessoOptional per-user restriction: only the owning user sees and edits the White Label options
SupportThe contact channel for blocked items becomes yours, not Ultrapack

12. Logs and telemetry

Every update attempt is recorded in logs, kept for 24 hours in Ultrapack Auto Updater → Logs. If an update fails, check the logs and send the details to support. The tab has a button to copiar and baixar the logs, with site, URL and token user already in the header, plus a button to clear them. There is also the option logs detalhados, which records each update step by step and helps when the error is hard to reproduce.

The plugin also has product telemetry on by default, used only to spot problems and improve the Ultrapack Auto Updater. You can turn it off in the same Logs tab. The data collected follows the Ultrapack Privacy Policy.

13. Compatibilidade

The UAU works with the vast majority of WordPress plugins and themes, and is tested up to WordPress 7.0. We do not recommend running another third-party update plugin alongside the Ultrapack Auto Updater, to avoid clashes in the update system.

  • Child themes are not offered for automatic updating, so your customisations are never overwritten.
  • Items with the author own updater built in keep working. You are the one who decides who updates, through the original licence badge from section 7.
  • Multisite is supported with network activation. The options live in the network dashboard, and the plan quota for multisites is separate from the one for regular sites.

14. Troubleshooting

My site is "Pending" and does not update
Sites come in as Pending until the domain is authorised. Check "Manage sites"; if it takes too long, open a support ticket.
Site "Bloqueado"
This happens when misuse is detected (too many domains, for instance). Click "Contact support" in the plugin itself to dispute it.
"You reached the site limit"
You registered more sites than the plan allows. Remove an unused site, get the add-on Extra Sites (1, 3 or 5 extra sites, with no plan change) or upgrade.
Updates do not run, and nothing shows up
Check in this order: (1) the notice about WP Recovery Agent not installed at the top of the plugin, because without it updates stay disabled; (2) whether Auto Updates are on in the tab Auto Updates; (3) whether there is an pausa ativa em Controle Manual; (4) se o selo do domínio está Autorizado.
An item disappeared from the updates list
It was most likely blocked over a broken package and stays off the list for 1 hour. See section 8 and use the contact button, which already carries the error description.
The item asks for confirmation and mentions an original licence
That is the protection from section 7. If you use the official licence from the author on that item, keep the protection. If detection got it wrong, switch the badge to "Never protect" in the Manager.
My site is a Multisite and a notice showed up on its row
The system spotted a Multisite network on a domain registered as a regular site. Use Migrate to Multisite in Gerenciar sites to fix the record, or Contestar if the detection got it wrong.
An update failed
The UAU rolls back to the previous version on its own. Check the logs tab and, if it persists, use "Versions" to restore manually.
Did not find what you were looking for? Open a ticket in Suporte → Ultrapack Auto Updater with screenshots and a description of the error.