---
title: "Promote a Workday Extend App Past Development — Kiweely"
description: "Promote a Workday Extend app one level at a time, from Development to Implementation to Sandbox to Production, and wait for Friday when model components…"
url: https://kiweely.com/guides/workday-extend-promote-past-development-beginners
---

# Promote a Workday Extend App Past Development

Deploy and test on a development tenant, then promote only to the next level. Implementation can take a minute to refresh. Sandbox and Production can take 15 minutes. Model components still wait for Friday if you made the Thursday deadline. Install once per tenant.

-   **Checked** against Workday on November 16
-   Applies to **Workday Extend**
-   6 min read
-   Published November 16
-   By Kiweely

Promoting a Workday Extend app is not deploying it again. Deploy sends a build to a development tenant. Promote moves an existing version to the next level: Development to Implementation, Implementation to Sandbox, Sandbox to Production. You do not skip a level. The tenants you have not promoted to keep the old version until you do.

Workday’s prerequisite is blunt. You have deployed the app to a development tenant and finished development and unit testing there. Implementation is where you run data validation and integration tests. Sandbox is where you test with production data. Production is where a company administrator can install and configure the app, after you accept the production checklist.

## Promote the latest version, one level

1.  On the Developer Site, open the Console section of the menu and select Apps. The list is the apps in App Hub for your account. “Extend Apps in Production” filters to apps that have already been promoted to Production.
2.  Find the app by name or reference ID. You can view your own apps or all apps.
3.  Open the app, open the Promotions tab, and promote the latest version to the next level only.

| You are on | The only next action |
| --- | --- |
| Development | Promote to Implementation |
| Implementation | Promote to Sandbox |
| Sandbox | Promote to Production |

1.  For Production, read the checklist. If the app meets it, select that the app meets the criteria, then promote again. If the app uses connectors, configure a Production account for each connector before this step.
2.  Install the app on the tenant. You install once per tenant. Later versions do not get another install.

`wdcli app promote` with a level such as `implementation` follows these same rules, including the model-component deadlines. The CLI is not a second, faster ladder.

## What “available” means on the clock

After a promotion, Workday gives two different clocks.

**Cache.** Implementation tenants might take up to 1 minute to update the cached app. Sandbox and Production might take up to 15 minutes. If you open the tenant in the first minute and do not see the new pages, wait out the cache before you call the promotion a failure.

**Model components.** Attachments, business objects, business processes, reports, security domains, and tasks deploy to Implementation, Sandbox, and Production as part of the weekly service update. You can install an app that has model components on those tenants only after that deploy. Promote before the Thursday deadline in Pacific time, and the components go out Friday night. Promote after it, and they go out Friday night the following week.

| Extend region | Data center | Thursday deadline, Pacific |
| --- | --- | --- |
| EU | All | 03:59:59 AM |
| US | WD102, WD105, WD109, WD117 | 08:59:59 AM |
| US | Any other | 11:59:59 PM |
| Other regions | All | 03:59:59 AM |

Non-model changes are available immediately, unless a model-component change is already queued for the upcoming weekly update. In that case the whole app update waits until the weekly update finishes. A page fix does not pass a queued business object.

If this is the first time the customer goes live, promote to Production one week before Workday creates the Production tenant from the Gold tenant. Otherwise the app is not installable on that new Production tenant until you promote it.

## Updating an app that is already in Production

Download is not required for a tiny App Builder edit, but Workday’s update path starts from the source you upload back to App Hub. Deploy the new build to a development tenant. Only Development moves to the new version. The table Workday prints is:

| Environment | After you deploy the new source |
| --- | --- |
| Development | New version |
| Implementation | Previous version |
| Sandbox | Previous version |
| Production | Previous version |

Promote to Implementation and test there. You do not reinstall. Sandbox still has the old version until you promote to Sandbox. Production still has the old version until you promote to Production. On each of those promotions, model-component changes wait for the weekly update again.

If you are still editing a version that has never left Development, further saves update that same development version. Workday does not mint a new version number for every save.

Allowed model updates, and only these, once a component has deployed in a previous version: add model components, add fields, add security domains on objects, add security domains on fields, and update page routes in business processes. You cannot remove a model component that has already deployed. Check the diff before you promote, not after Friday.

## Sandbox, refresh, and a second install

Workday calls out one Sandbox-specific failure. On the external client credential store you must create refresh tokens in both the Sandbox tenant and the Sandbox Preview tenant. If you create business objects in Sandbox Preview and you do not have refresh tokens there, you get HTTP 500 when you access those objects. Tokens that exist only on Sandbox let you access the objects only on Sandbox.

You also reinstall, despite the once-per-tenant rule, in two refresh cases:

-   You refresh an Implementation tenant from a tenant where the app was not installed.
-   You did not install the app on Production before Workday refreshes Sandbox.

Those are reinstalls of an app that fell off the tenant. They are not how you ship version 2.

## A beginner sequence

1.  Validate, save, and deploy to the development tenant. Test as a user who has the domain security policy, not only as the developer who built the page.
2.  Activate security policy changes on that development tenant and confirm a real row, for example with Extend Business Object Instance Count.
3.  Promote to Implementation before your Thursday deadline if the version has model components. Wait for Friday night if it does. Allow up to a minute for the cache. Test integrations there.
4.  Promote to Sandbox. Create the Sandbox and Sandbox Preview refresh tokens before you depend on business objects in Sandbox Preview. Allow up to 15 minutes for the cache. Test with production data, which is the point of Sandbox.
5.  Promote to Production only after the checklist is true. Configure connector production accounts first. Allow up to 15 minutes. The company administrator installs and configures it if this is the first time on that tenant.

## Failure modes

-   **You promoted Development straight to Sandbox in your head.** The action from Development is Promote to Implementation. Sandbox is the action from Implementation.
-   **Friday came and Implementation still has no object.** The promotion was after the deadline, or it was the wrong region’s Thursday. The US-all-day deadline does not apply to WD102, WD105, WD109, or WD117, and it does not apply to EU.
-   **Production promotion is disabled until you check the box.** Workday requires you to confirm the checklist and promote again. Connectors without a Production account are a reason to stop, not a warning to click through.
-   **HTTP 500 on a business object in Sandbox Preview.** The refresh-token note is the published cause. Create the Sandbox Preview refresh token. Do not redeploy the development tenant to fix a Sandbox Preview grant.
-   **A new security domain is in the app and the Sandbox policy is empty.** The domain file arrives with the model deploy. The policy is something you configure on that tenant. Development’s activated policy does not copy itself.

## Frequently asked questions

### Is Save and Deploy a promotion?

No. Save and Deploy targets a development tenant. Promotion starts from the Promotions tab, or from `wdcli app promote`, and only to the next level.

### Do I install on every version?

Install once on each tenant. Promote later versions onto that install. Reinstall only after the Implementation or Sandbox refresh cases Workday names.

### How long before Implementation shows the app?

Up to about a minute for the cached app, longer if you are waiting for a model component’s weekly service update. Sandbox and Production can take up to 15 minutes for the cache, and the same Friday rule for model components.

### Can I remove a field I promoted by mistake?

Not if that field deployed in a previous version. The allowed updates do not include removal. Catch it on the development tenant, before the promotion.

## Sources checked

-   [Promote Extend Apps Through the Lifecycle](https://developer.workday.com/documentation/ujq1579478936974-1/PromoteExtendAppsThroughtheLifecycle)
-   [Concept: Update Workday Extend Apps](https://developer.workday.com/documentation/inq1613067239283/ConceptUpdateWorkdayExtendApps)
-   [Reference: Promotion Deadlines for Extend Apps with Model Components](https://developer.workday.com/documentation/giw1660842903762/ReferencePromotionDeadlinesforExtendAppswithModelComponents)
-   [Concept: Extend Apps with Model Components](https://developer.workday.com/documentation/svf1623189172850/ConceptExtendAppswithModelComponents)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Workday Extend Model Components and the Weekly Update Business objects, security domains, attachments, processes, reports, and tasks are model components. Development deploys immediately. Other tenants get model changes on Friday night, and only if you promoted before Thursday. Deployed model components cannot be removed.](https://kiweely.com/guides/workday-extend-model-components-weekly-update)
-   [### The Validate and Deploy Proof Ladder for Workday Extend Preview and validate before a tenant sees anything. Save to App Hub writes a build. Deploy reaches a development tenant only. Promote one level at a time. Model components still wait for the weekly update. Orchestrations validate in Orchestration Builder.](https://kiweely.com/guides/workday-extend-validate-deploy-proof-ladder)
-   [### Security Domains for Your First Workday Extend App A security domain file does nothing until you deploy, create the domain security policy, grant a security group, and activate it. Page security should use unconstrained role-based groups. Developer Agent can write the file. It does not configure the tenant.](https://kiweely.com/guides/first-workday-extend-app-security-domains)

### More guides on Extend apps and pages

[All 97 guides](https://kiweely.com/guides#extend)

-   [Use the Workday Extend App Catalog as an AI Jump Start](https://kiweely.com/guides/workday-extend-app-catalog-ai-jump-start)
-   [AMD vs PMD in Workday Extend, for Beginners](https://kiweely.com/guides/workday-extend-amd-vs-pmd-beginners)
-   [Your First Workday Extend Validation Error from AI](https://kiweely.com/guides/first-workday-extend-validation-error-ai)
-   [Is there an AI tool that can build, validate and deploy Workday Extend apps?](https://kiweely.com/guides/ai-tool-build-validate-deploy-workday-extend-apps)
-   [AI Browser Testing for Workday Extend Pages: Grids, Attachments, and BP Steps](https://kiweely.com/guides/ai-browser-testing-workday-extend-grids-attachments-bp)
-   [Workday Extend App Preview Is Not Proof the App Works in the Tenant](https://kiweely.com/guides/workday-extend-app-preview-is-not-tenant-proof)
-   [How to Map Control Fields and Related Business Objects in Workday Composite Subreports](https://kiweely.com/guides/workday-composite-report-control-fields-business-object-swap)
-   [Workday Lookup Related Value (LRV) Explained: Crossing Business Objects Without Blank Rows](https://kiweely.com/guides/workday-lookup-related-value-lrv-calculated-field)

### From the blog on Extend apps and pages

[All posts](https://kiweely.com/blog)

-   [What can you change in a Workday Extend app after its model components deploy?](https://kiweely.com/blog/workday-extend-model-components-first-deploy)
-   [How do you test a Workday Extend app end to end?](https://kiweely.com/blog/test-workday-extend-app-end-to-end)
-   [When a Workday Custom Report Is Enough vs. When You Need Prism or an Extend App](https://kiweely.com/blog/when-workday-custom-report-is-not-enough)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
