Manage your storage connections

Updated Oct 29, 2026 · 7 min read · All plans

This article shows you around Settings → Storage: how to check, update and remove the storage buckets connected to PlayerMagick, and choose where new uploads go.

This is optional. PlayerMagick stores your videos for you, with nothing to set up. Connecting your own bucket is only for accounts where it is turned on: accounts that already used their own storage, and accounts where support turned it on at your request. See How PlayerMagick stores your videos.

Before you start

Only the account's Owner and Admins can change storage. Editors and Viewers see the bucket cards without buttons. See Understand team roles.

Open your storage settings

Go to Settings → Storage. Each connected bucket has its own card. At the top you see how many buckets your plan allows, for example "2 of 3 connections used on the Pro plan".

If your account also has PlayerMagick storage, it shows as its own card, PlayerMagick storage, marked Included in your plan, with the storage used. It has no keys, no tests and no Disconnect: there is nothing to manage. See How PlayerMagick stores your videos.

Each card shows the provider and bucket name, and:

ItemWhat it tells you
WorkingThe last check passed. If a check fails, the badge is replaced by the problem in plain words and its error code, until a later test passes.
Default for uploadsNew uploads go to this bucket. Exactly one bucket has it.
Public URLThe address your videos are played from (your Public URL for playback).
VideosHow many videos are stored in this bucket and how much space they use.
CDNBuilt in when the address shows your videos are delivered through a fast worldwide network (Cloudflare R2 with your own domain, Amazon CloudFront, the DigitalOcean Spaces CDN). None when they come straight from the bucket (the provider's own address, an r2.dev address, a server address such as an IP). Not known when your own domain points somewhere PlayerMagick cannot check; if no CDN is behind it, follow the steps below.
Last checkWhen PlayerMagick last checked the connection, for example "5 minutes ago". Point at it to see the exact time.

A card also shows any reminder saved when the bucket was connected, for example "This address is for testing only". See Reminders that do not stop you from saving.

Your access key ID is shown with only its last characters. Your secret access key is never shown or sent to your browser, not even to you.

About "CDN: None"

A CDN (content delivery network) keeps copies of your videos in many places around the world, so they start faster for visitors far from your bucket, and often cost less to watch.

If a bucket shows CDN: None, its card shows a reminder, for example: "Videos from this bucket start slower for visitors far from its region." with a Show me how link. The Speed check in each video's Publish tab also points this out. Your videos still play, but you can make them faster:

  • Cloudflare R2: connect your own domain to the bucket (see Connect Cloudflare R2 storage) and change the public URL.
  • Amazon S3: put Amazon CloudFront in front of it (see Connect Amazon S3 storage) and change the public URL to the CloudFront address.
  • Backblaze B2, Wasabi and others: put a CDN such as Cloudflare in front of the bucket and change the public URL to the CDN's address.

Check a connection

Click Test now. PlayerMagick runs the same four checks as when you connected the bucket, ticking each line as it goes, and updates Last check. If a check fails, see Fix a storage connection test error.

If you run many tests in a row (about 10 in a minute), PlayerMagick asks you to wait a minute before the next one.

If some videos in this bucket show "Could not convert" because PlayerMagick could not access your storage, a passing test starts them again on their own, within about a minute.

Replace the keys

Do this when you rotate keys at your provider, or when a key was deleted or expired.

  1. Create a new key at your provider (see the guide for your provider).
  2. Click Replace keys on the bucket's card.
  3. Enter the new Access key ID and Secret access key.
  4. PlayerMagick tests the new keys before saving them. If the test fails, your old keys stay in use and nothing changes.
  5. Once saved, the form is empty again. You can now delete the old key at your provider.

Videos in this bucket that could not be converted because the old key stopped working start converting again on their own, within about a minute. Conversions that were waiting continue.

Change the public URL for playback

Do this when you connect your own domain or a CDN to a bucket that is already connected, for example to replace an r2.dev address.

  1. On the bucket's card, click Change public URL.
  2. In Public URL for playback, enter the new address, for example https://videos.yourdomain.com, with nothing after the domain.
  3. Click Test and save. PlayerMagick checks that it can read your files through the new address and that the player is allowed to load them (CORS).
  4. If both checks pass, the new address is saved, and every video in this bucket plays from it within seconds. You do not need to change your pages.

If a check fails, nothing changes: your videos keep playing from the old address. Fix the problem and try again. See Fix a storage connection test error.

Choose where new uploads go

Click Make default on a bucket. New uploads go there from now on. Videos you already uploaded stay in the bucket they are in and keep playing.

Make default is offered only for a bucket whose last test passed.

Disconnect a bucket

  1. Click Disconnect on the bucket's card.
  2. Read the message: "Disconnecting never deletes files from your bucket. Videos in it stop playing until you connect it again." It also tells you how many videos are affected.
  3. Confirm.

What happens:

  • Your files stay in your bucket. PlayerMagick deletes nothing and changes nothing there.
  • Every video in this bucket stops playing on your pages within seconds, and shows "Storage disconnected" in Videos. Replace those videos on your pages first if you want to keep them visible.
  • Uploads to this bucket that are still running are cancelled, and conversions are stopped.
  • PlayerMagick removes your secret access key.
  • If this was the Default for uploads bucket, your oldest remaining bucket becomes the default.
  • If it was your only bucket, you cannot upload until you connect one.
  • A disconnected bucket does not count toward your plan's bucket limit. PlayerMagick storage never counts as a bucket.

Bring a disconnected bucket back

  1. Click Connect a bucket.
  2. Connect the same bucket again, with the same provider details and bucket name, and a key that works.
  3. When the test passes and you save, its videos play again within seconds. Their settings and embed codes are unchanged.

Add another bucket

Click Connect a bucket and follow the guide for your provider. You get the same provider choice, form and live checklist as in the setup steps. The number of buckets depends on your plan:

StarterProBusinessAgency
1 bucket3 buckets3 bucketsUnlimited

When you reach your plan's limit, Connect a bucket asks you to upgrade. Your existing buckets keep working.

Keep your keys safe

  • PlayerMagick stores your secret access key encrypted, and never shows it again after you save it, not even to you.
  • Never share your secret access key by email or chat, including with support.
  • Give PlayerMagick its own key, limited to one bucket. If you ever need to cut access, delete that key at your provider.

Was this article helpful?