Insight
What Questions Should You Ask CMS Vendors About Integration Complexity Before You Buy?
Evaluating a new CMS? Learn what to ask vendors about APIs, data migration, authentication, integration costs, and long-term maintenance before committing to a platform. Includes a practical vendor evaluation questionnaire.
Choosing a new content management system usually begins with the visible parts of the platform. How easy is it to edit a page? Can the marketing team manage content without developer assistance? Does the publishing workflow make sense? Will the new system support the organization's existing websites?
These are reasonable questions, and most CMS vendors are well prepared to answer them.
The more difficult questions often come later, when the organization begins connecting the new platform to everything it already uses.
A CMS rarely operates in isolation. Depending on the business, it may need to communicate with a CRM, an ERP, an identity provider, an employee directory, an e-commerce platform, or several internal applications that have been in place for years.
During a product demonstration, a vendor might explain that the CMS offers APIs, supports third-party integrations, and can accommodate custom development. All of that sounds promising.
But knowing that an integration is possible is not the same as understanding what it will take to build it, how much it will cost, or who will be responsible for maintaining it.
Before committing to a platform, it is worth taking a closer look at what those integration promises actually mean for your organization.
1. When a vendor says the CMS integrates with your existing systems, what does that mean?
An integration can take several forms.
The CMS might offer a native connector that the vendor develops and maintains. It might support a third-party integration that requires a separate subscription. In other cases, your development team may need to build an entirely custom solution using the platform's APIs.
These approaches can produce similar results from an end user's perspective, but they create very different responsibilities behind the scenes.
Consider an organization that wants to display employee information from its existing HR system on its corporate website.
One CMS might provide a ready-made connector for that HR platform. Another might require a custom service that retrieves employee records, transforms the data, and sends it to the CMS.
Both vendors could reasonably say their platforms support the integration. The difference becomes apparent when the organization starts estimating development time, maintenance requirements, and long-term operating costs.
Ask the vendor to explain how each required integration would actually be implemented.
If a connector already exists, find out who maintains it, whether it requires additional licensing, and what happens when either system changes. If custom development is required, establish which components your organization will own and what support the vendor will provide.
The goal is not necessarily to avoid custom integrations. Sometimes a custom solution is entirely appropriate. The important thing is to understand what you are agreeing to before the project begins.
2. Does the API support what your organization actually needs to do?
The availability of an API is often treated as a simple checkbox during software evaluations.
Does the platform have an API? Yes.
Is it documented? Yes.
Can developers build custom integrations? Yes.
Those answers are useful, but they are only a starting point.
An API may allow developers to retrieve published content without providing the same level of access to administrative functions, publishing workflows, permissions, or other information your organization needs.
Suppose your organization wants to synchronize information between an internal business application and the CMS.
You need to know whether the API allows you to create and update the relevant records, which fields are accessible, how authentication works, and whether the integration can operate without someone manually signing in.
You also need to understand the platform's limitations.
Are there restrictions on how many requests an application can make? Can large amounts of information be processed in batches? Are certain API capabilities available only with a more expensive subscription?
These questions become particularly important when an integration works with substantial amounts of data or must operate frequently throughout the day.
Ask the vendor to demonstrate the specific API operations your integration will require, rather than relying on a general confirmation that the platform has an API.
Ideally, your technical team should be able to review the documentation and test the relevant capabilities before the final platform decision.
If the vendor provides a sandbox or evaluation environment, use it to verify the assumptions that matter most to your organization.
Discovering an API limitation during evaluation is inconvenient. Discovering it after signing a contract, when the implementation team has already committed to a particular architecture, can be considerably more expensive.
3. Where will the information come from, and which system will own it?
This question is easy to overlook because it is not really about the CMS itself.
It is about how the CMS fits into the organization's existing data environment.
Imagine that customer information is stored in a CRM, but certain customer details also need to appear on a website managed through the CMS.
Which system should employees use when they need to correct that information?
If a customer record changes in the CRM, should the CMS update automatically? If someone edits the same information in the CMS, should that change flow back to the CRM?
And what happens when the two systems contain conflicting values?
Without clearly defined data ownership, even a technically functional integration can create operational problems. Employees may begin correcting information in multiple places, synchronization rules become harder to maintain, and nobody is entirely sure which system contains the authoritative record.
Before selecting a CMS, identify the systems that will supply information to it and determine how that information is expected to move.
For each integration, establish which system is the source of truth, what information needs to be exchanged, how frequently it must be updated, and whether changes need to travel in one direction or both.
The vendor should be able to explain how its platform can support those requirements.
This is also a good time to discuss how records will be matched between systems, how deleted or inactive records will be handled, and what should happen if synchronization fails.
4. How will authentication and permissions work across the connected systems?
Authentication often looks straightforward during a CMS demonstration. A user signs in, accesses the dashboard, and begins working.
The situation becomes more complicated when the CMS needs to communicate with existing systems or support different groups of users.
Your organization may already use a centralized identity provider. Employees may have different access levels depending on their department, job responsibilities, or location. Some integrations may need to operate automatically without any interactive user login.
Ask the vendor how its authentication and authorization capabilities fit into that environment.
Can the CMS work with your existing identity provider? Does it support the authentication methods your organization uses? Can service accounts or other machine-to-machine authentication mechanisms be used for automated integrations?
It is also important to establish how permissions are managed.
An integration that retrieves information from an internal system should not automatically receive access to everything that system contains. Your technical team needs to understand which permissions are required, how they are granted, and how access can be revoked.
The same applies to credentials and tokens used by automated processes.
Who will manage them? How will they be rotated? What happens when a credential expires?
These are not questions to leave entirely until implementation. Authentication restrictions can influence integration architecture, operational responsibilities, and even whether a proposed approach is feasible.
5. What will it take to move your existing content and integrations to the new platform?
A CMS migration is often described as moving content from one platform to another.
For a relatively simple website, that may be a reasonable description. For an organization with several websites, custom applications, shared content, and established publishing workflows, the migration can involve considerably more.
Your current CMS may contain more than pages, images, and documents.
It may also hold content relationships, metadata, redirects, user permissions, reusable templates, scheduled publishing rules, and configuration that other applications depend on.
Before accepting a migration estimate, ask the vendor to explain what its migration tools can transfer automatically and what will require additional development or manual work.
Will the tools preserve content relationships and metadata? How will existing URLs and redirects be handled? Can your organization retain its current content structure, or will information need to be reorganized to fit the new platform?
The existing integrations deserve the same attention.
If an internal application currently retrieves content from your CMS, will that application continue working after the migration? Will its integration need to be rewritten? Does the new platform expose the same information in a compatible format?
These questions are especially important when an organization has been using its current CMS for many years.
Some dependencies may be well documented. Others may exist because a developer built a small integration years ago, and it has continued working quietly ever since.
Replacing the CMS without identifying those dependencies can create problems that were never included in the original migration plan.
A useful migration estimate should account for the work required to move the content, adapt the connected systems, test the result, and retire the old platform without disrupting the business.
6. What happens when an integration stops working?
During an evaluation, vendors naturally demonstrate their products under favorable conditions.
The platform is available, the sample data is correct, and the integration behaves as expected.
Production environments are less predictable.
An external API becomes unavailable. A request times out. A scheduled import processes only part of its data. Authentication credentials expire. An upstream application introduces a change that affects the information it sends.
None of these situations necessarily means that the CMS is unreliable. They are ordinary conditions that connected systems need to handle.
The question is whether your organization will have the tools and processes necessary to recognize and recover from them.
Ask the vendor what monitoring, logging, and error-handling capabilities are available for integrations.
Can your technical team determine when an integration last ran successfully? Can it identify which records failed to process? Are failed requests retried automatically, or does someone need to intervene?
If a scheduled synchronization stops working, how will anyone know?
A particularly important detail is whether failed operations can be safely repeated without creating duplicate records or introducing inconsistent data.
Not every CMS provides all these capabilities directly. Depending on the integration architecture, some may need to be implemented in middleware or in your organization's own applications.
That is perfectly reasonable, provided the responsibility is understood and included in the implementation plan.
The concern is not simply whether the integration can work when everything is available. It is whether your organization can operate and support it when something goes wrong.
7. Who will maintain the integration after the implementation project ends?
The implementation team may build a perfectly functional integration, test it, and put it into production.
Six months later, the CMS vendor releases an update. An external application changes its API. Your organization introduces a new authentication policy.
Who investigates the impact? Who modifies the integration if necessary? Who tests the changes and deploys them?
The CMS vendor may maintain the platform and its native connectors but exclude custom integration code from its support agreement. An implementation partner may support the solution only during the initial project. Your internal development team may then inherit ongoing maintenance responsibilities that were never included in its workload estimates.
Ask the vendor to identify the boundaries of its support and maintenance obligations.
If a third-party integration is involved, determine who is responsible for diagnosing problems that affect more than one system.
It is also worth asking how the vendor handles API changes, how long older API versions remain supported, and what notice customers receive before breaking changes are introduced.
The objective is to understand not just what it takes to launch the integration, but what it will take to keep it running.
A platform that appears less expensive during the initial purchase may require more development and maintenance work over time. That does not automatically make it the wrong choice, but those costs should be visible before the organization commits.
8. How much of the integration work has actually been included in the proposal?
By the time an organization receives a CMS proposal, the project may already have a substantial price attached to it.
The proposal might include licensing, hosting, implementation, content migration, training, and support.
Integration work, however, may be described in broad terms or treated as an optional professional service.
Before comparing proposals, establish exactly what each vendor has included.
Does the quoted implementation price cover connecting the CMS to your existing systems? Does it include data mapping, custom development, testing, and deployment? Are additional environments, API usage, or third-party services charged separately?
What happens if the implementation team discovers that an existing system requires a different integration approach than originally anticipated?
There is a practical reason to resolve these questions during evaluation: two proposals with similar licensing costs may represent very different amounts of work for your organization.
A lower initial price can be perfectly reasonable if your internal team is prepared to handle the additional development. But that should be an informed decision, not an unexpected responsibility discovered after the contract is signed.
For integrations that are important to business operations, ask vendors to identify their assumptions, exclusions, and expected customer responsibilities in writing.
You do not need every implementation detail finalized before selecting a platform. You do need enough information to understand the likely scope of work and the major uncertainties that could affect cost or delivery.
Before you choose a CMS, understand what it needs to connect to
A CMS evaluation should consider more than the capabilities of the proposed platform. It should also account for the environment in which that platform will operate.
An organization that already understands its systems, data flows, technical dependencies, and operational responsibilities is in a much better position to evaluate vendor proposals.
It can ask specific questions instead of relying on broad assurances. It can recognize which integrations are straightforward and which require further investigation. And it can distinguish work the vendor will perform from work its own team will need to take on.
You do not need to design every integration before purchasing a CMS.
But you should know which systems the new platform will depend on, what information those systems exchange, and where the significant technical uncertainties remain.
If those details are unclear, identifying them before the platform decision can prevent expensive surprises during implementation.
The next time a vendor tells you that its CMS integrates with your existing systems, don't stop at asking whether the integration is supported.
Ask what it will take to make that integration work in your environment—and who will be responsible for keeping it working.
Practical CMS Integration Evaluation Questionnaire
Before selecting a CMS, use these questions to understand how the proposed platform will work with your existing systems. You don't need to answer every question during the first vendor meeting, but the critical integration requirements should be understood before you make a final decision.
For each integration, ask the vendor to explain how the proposed solution would work in your environment. Where possible, request documentation, a demonstration, or a technical discussion with the people who would actually be responsible for implementation.
Integration capabilities
- Which of our existing systems can your CMS integrate with using native or vendor-supported connectors?
- Which integrations would require third-party software or custom development?
- Can you demonstrate how the proposed integration would work with our specific systems?
- Which API capabilities, licensing tiers, or usage limits could affect the integration?
Data and system dependencies
- Which system will be the authoritative source for each type of information exchanged?
- How will records be matched, updated, or removed across connected systems?
- Will information move in one direction or both, and how frequently will it be synchronized?
- What existing applications or business processes could be affected by replacing our current CMS?
Authentication and security
- Can the CMS integrate with our existing identity provider and authentication methods?
- How will automated integrations authenticate without an interactive user login?
- How are integration permissions, credentials, and access revocation managed?
Migration and testing
- Which content, metadata, configurations, and relationships can your migration tools preserve?
- Which existing integrations will need to be modified or rebuilt?
- Can we test the critical integrations in a non-production environment before committing to the platform?
- How will we verify data integrity and integration behavior before the new CMS goes live?
Reliability and maintenance
- How are failed requests, incomplete synchronizations, and unavailable external systems handled?
- What logs, monitoring, and alerts will be available to our technical team?
- How are API changes and platform upgrades communicated and managed?
- Who will investigate and resolve integration failures involving multiple vendors or systems?
Costs and responsibilities
- Which integrations and related implementation services are included in the proposal?
- What additional licensing, middleware, development, or API usage costs should we expect?
- Who will own and maintain custom integration code after implementation?
- Which technical responsibilities will remain with our organization, and are they documented in the agreement?
One final question before signing
After reviewing the answers, ask your team:
Do we understand what it will take to connect this CMS to our existing environment, including the work our own organization will be responsible for?
If the answer is still unclear, identify the unresolved requirements and obtain the necessary technical clarification before committing to the platform.