# Known Limitations and Considerations

As insights are gathered from users of this feature, there are some known limitations and considerations to be aware of.

## Format Restrictions

The packaged artifact from your CI/CD pipeline must adhere to the Umbraco Cloud API's required zip source file format. This could necessitate changes to your existing build and packaging scripts. Read about [Artifact best practice](/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/umbraco-cicd/samplecicdpipeline/artifact-best-practice.md).

## Workflow considerations

To ensure smooth execution of the CI/CD Flow, it is recommended to avoid making any schema changes on any [cloud environment](/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/deployment.md). Use your local clone to add or edit Document Types, Data Types, Templates, and the like. Use CI/CD Flow to deploy to Umbraco Cloud. The intention behind this principle is to prevent conflicts that could potentially arise due to simultaneous modifications made in different environments.

## Additional Build Steps

The CI/CD Flow feature starts an isolated instance, which may add an extra build to the deployment process. It takes longer for a deployment to finish through Umbraco CI/CD Flow compared to standard deployments.

## Conflict Management

Without coordination between teams, the risk of project conflicts increases, especially when trying to avoid unintended changes across different environments. Make sure to handle changes and local conflicts in your version control system.

## Key Points to Consider

* **Direct Commits to Umbraco Git Repos**: Any commits made directly to the Umbraco Git Repos are not advised.
* **Incomplete API**: The promotion endpoint for transitioning between environments is not fully functional yet.
* **Lack of Predefined Tasks**: There are no Umbraco-provided Azure DevOps tasks or GitHub Actions available.
  * [GitHub Actions: Our Umbraco Cloud Action](https://github.com/marketplace/actions/umbraco-cloud-deployment-action)
* **No Webhooks**: Currently, there's no webhook support for real-time feedback to the pipeline; polling is the only option.
* **Casing Conflicts**: Be cautious of casing issues, such as having a `README.md` file created by Azure DevOps and a `Readme.md` file from the default Umbraco Cloud. This can cause conflicts in the cloud Git repository.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/umbraco-cicd/known-limitations-and-considerations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.