Help for owners
My iPhone app will not build because the provisioning profile expired
Short answer
A provisioning profile ties your app, your certificates and your devices together. Apple says that if one expires you need to regenerate it, and that one also needs regenerating when it becomes invalid after you enable or disable app capabilities. Regenerate it in the developer account, then build again.
Does this sound like your situation?
- The build says there is no valid provisioning profile, or one has expired.
- A test version of the app stopped opening on the team's phones.
- It worked yesterday and nobody changed the code.
- Someone added a feature such as push notifications and the next build failed.
- The developer who set it up is no longer available.
Why does this happen?
Profiles expire
Apple's documentation states that if a provisioning profile expires, you need to regenerate it. The page does not give one standard lifetime, so the date shown in your own account is the one that counts.
Confirmed by developer.apple.com
Changing app capabilities invalidates the profile
The same page says to regenerate a profile when it is invalid because you enabled app capabilities, and when you enable or disable app services. Adding push notifications or sign-in features can therefore break the next build.
Confirmed by developer.apple.comTechnical detail: Xcode finds no provisioning profile for your bundle ID
The certificate inside the profile changed
Apple says to edit a profile after you revoke a certificate or disable a device in it. If the certificate a profile expects is gone, the profile and the signing setup no longer match.
Confirmed by developer.apple.comTechnical detail: Xcode says the profile does not include your signing certificate
Only some roles can fix it
Apple lists the Account Holder or an Admin as the roles required to regenerate profiles. A developer with a lower role can see the error but cannot clear it.
Confirmed by developer.apple.com
What can I do about it today?
- Check who has the right roleAsk the Account Holder whether your developer is an Admin in the Apple developer account. If not, the Account Holder or an Admin has to do the regeneration.
- Look at the profile datesIn the developer account, under Certificates, Identifiers and Profiles, the Profiles list shows each profile. Note which one the failing app uses and its expiry.
- Ask what changedAsk whether anyone enabled a capability, revoked a certificate or removed a device recently. That tells the developer where to look.
- Leave the live app aloneA failed build does not remove the app customers already have. There is no need to touch the published version.
- Do not delete profiles to clear the listRemoving a profile that something else still uses can create new errors. Let the developer regenerate the one that is failing.
When should I bring someone in?
- Regenerating the profile did not clear the error.
- Nobody on your side has the right role in the Apple account.
- A release is blocked and the cause might be the certificate, not the profile.
How do I handle it?
- Identify which profile the build usesI read the build settings and the signing setup to see which profile, certificate and app identifier it expects.
- Regenerate it with the right certificateThe invalid or expired profile is edited in the account and regenerated, with the correct certificate and, for test builds, the right devices.
- Rebuild and re-signThe old profile is removed from the build machine and the app is signed again with the new one.
- Write down the expiry datesEach profile and certificate gets its end date in a short document, so the next expiry is planned and not discovered by a failed build.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
What is a provisioning profile in plain words?
It is a file from Apple that says this app, signed by these certificates, may run on these devices or be distributed this way. If the file is out of date, the build cannot be signed.
Is this the same as an expired developer membership?
No. A membership renewal is a separate matter. A profile can expire while the membership is active.
Will the fix change my app?
No. Regenerating a profile changes the signing setup, not the code or the live app.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.
For your developer: the technical fixes
Xcode couldn't find any provisioning profiles matchingXcode finds no provisioning profile for your bundle IDProvisioning profile doesn't include signing certificateXcode says the profile does not include your signing certificateMissing private keyXcode shows a distribution certificate without its private key