Selling to Government? Your PDFs May Be Part of the Accessibility Test

A startup can spend months preparing for a government contract, then discover that the problem isn’t its price, staffing plan or product. It’s a PDF.

The company website may work well with a screen reader. The product may meet the buyer’s technical requirements. But if the service includes an unlabeled form, a poorly tagged report or a manual with a scrambled reading order, the accessibility review may reach those files too.

The Department of Justice has given state and local governments another year to meet its web and mobile accessibility rule. That’s useful breathing room. It’s also a good time for vendors to find the documents that could cause trouble later.

Build Your Business. Get Grant Ready.

Take free expert-led courses and unlock access to tools, mentorship, networking, and Verizon grant opportunities for small businesses.

Get Grant Ready

We earn a commission if you make a purchase, at no additional cost to you.

Why a vendor’s documents can enter the accessibility review

The rule applies to web content and mobile apps that state and local governments provide or make available. That includes content supplied through contracts, licenses and similar arrangements.

The legal responsibility remains with the public entity, but vendors may still feel the practical effects through bid requirements, contract language, acceptance testing or requests to fix inaccessible work.

The DOJ’s guidance for small public entities is direct on this point. A government that hires another organization to provide public services must make sure the resulting web content or mobile app meets its Title II responsibilities. DOJ also defines web content broadly enough to include documents.

For a vendor, the sensible question isn’t “Does the rule regulate our company?” It’s “Which parts of our work will the customer publish or use to provide a public service?”

That could include a county benefits form, a software-generated transit report, a public university’s training manual or notices produced by a third-party platform. The document doesn’t become somebody else’s problem simply because a contractor created it.

Don’t assume every PDF exchanged with a government customer is covered. A brochure emailed to one buyer may be treated differently from a form the agency posts for residents. Ask the buyer what’s in scope while there’s still time to make changes.

Find the PDFs attached to the service

Companies tend to review the files inside a proposal and stop there. The bigger risk may be the documents the customer receives after the contract is signed.

Trace the whole service. What will your team create, upload, update or generate for the buyer? Which files could eventually reach a resident, student, patient, passenger or business owner?

Forms people must complete
Reports and notices generated by your software
Manuals, instructions and training materials
Templates the customer will edit and publish
Recurring statements or letters
Presentations and meeting documents
Scanned records made available online

Include the editable source file for each document when it exists. A PDF is much easier to correct when someone can repair the headings, table structure and image descriptions in the original Word, PowerPoint or design file before exporting it again.

Then record who owns the document, where it will appear and how often it changes. Pay particular attention to files that people need to apply for a service, submit information, understand a decision or meet a deadline. A decorative brochure and an application form don’t carry the same consequences when something goes wrong.

StartupNation’s older advice to make sure you can deliver before you bid applies here. Accessibility belongs in that delivery check alongside staffing, financing and technical capacity.

Some older documents may qualify for an exception under the DOJ rule, including certain preexisting conventional electronic documents. Don’t build the inventory around that assumption. Updating a file may affect whether an exception still applies, and other ADA obligations may still require a public entity to provide accessible information to someone who needs it.

A PDF can look fine and still fail a real user

Visual inspection is a poor accessibility test. A clean page can hide missing tags, unnamed form fields, and text that a screen reader announces in the wrong order.

Take a two-column report. A sighted reader knows to finish the left column before moving to the right. If the file’s structure is wrong, assistive technology may read straight across the page, joining unrelated sentences into nonsense.

Reading order is one of the checks described in the W3C’s PDF accessibility technique. W3C explains that tag order helps determine how a PDF is read and that complex layouts don’t always convert correctly, even when the source document looks orderly.

A useful first review should ask:

Can the text be selected, or is the document only a scanned image?
Do headings, paragraphs and lists have meaningful structure?
Does the reading order follow the intended meaning?
Do informative images have useful text alternatives?
Can someone understand a table from its headers and cell relationships?
Do links make sense without the surrounding sentence?
Are form fields named, explained, and placed in a sensible tab order?
Can every interactive part be reached with a keyboard?
Are the document title and language identified?

This is where website accessibility and document accessibility part ways. A company may have fixed its navigation, page headings, and color contrast while leaving dozens of downloadable files untouched.

Automated checkers can catch some defects, but a green result doesn’t settle the matter. Software can detect a missing image description. It can’t always tell whether the description is useful. It may flag a reading order, yet fail to recognize that the order makes no sense to a person following the document.

Use the tools, then have someone check the file with a keyboard and assistive technology. For an important form or public notice, include a reviewer who understands PDF structure and accessibility. The file has to work, not merely pass a scan.

#mc_embed_signup{background:#fff; false;clear:left; font:14px Helvetica,Arial,sans-serif; width: 600px;}
/* Add your own Mailchimp form style overrides in your site stylesheet or in this style block.
We recommend moving this block and the preceding CSS link to the HEAD of your HTML file. */

Sign Up for The Start Newsletter

* indicates required

Email Address *

function getCountryUnicodeFlag(countryCode) {
return countryCode.toUpperCase().replace(/./g, (char) => String.fromCodePoint(char.charCodeAt(0) + 127397))
};

// HTML sanitization function to prevent XSS
function sanitizeHtml(str) {
if (typeof str !== ‘string’) return ”;
return str
.replace(/&/g, ‘&’)
.replace(//g, ‘>’)
.replace(/”/g, ‘"’)
.replace(/’/g, ‘'’)
.replace(/\//g, ‘/’);
}

// URL sanitization function to prevent javascript: and data: URLs
function sanitizeUrl(url) {
if (typeof url !== ‘string’) return ”;
const trimmedUrl = url.trim().toLowerCase();
if (trimmedUrl.startsWith(‘javascript:’) || trimmedUrl.startsWith(‘data:’) || trimmedUrl.startsWith(‘vbscript:’)) {
return ‘#’;
}
return url;
}

const getBrowserLanguage = () => {
if (!window?.navigator?.language?.split(‘-‘)[1]) {
return window?.navigator?.language?.toUpperCase();
}
return window?.navigator?.language?.split(‘-‘)[1];
};

function getDefaultCountryProgram(defaultCountryCode, smsProgramData) {
if (!smsProgramData || smsProgramData.length === 0) {
return null;
}

const browserLanguage = getBrowserLanguage();

if (browserLanguage) {
const foundProgram = smsProgramData.find(
(program) => program?.countryCode === browserLanguage,
);
if (foundProgram) {
return foundProgram;
}
}

if (defaultCountryCode) {
const foundProgram = smsProgramData.find(
(program) => program?.countryCode === defaultCountryCode,
);
if (foundProgram) {
return foundProgram;
}
}

return smsProgramData[0];
}

function updateSmsLegalText(countryCode, fieldName) {
if (!countryCode || !fieldName) {
return;
}

const programs = window?.MC?.smsPhoneData?.programs;
if (!programs || !Array.isArray(programs)) {
return;
}

const program = programs.find(program => program?.countryCode === countryCode);
if (!program || !program.requiredTemplate) {
return;
}

var smsConsentHtmlRenderingFixEnabled = true;

const legalTextElement = document.querySelector(‘#legal-text-‘ + fieldName);
if (!legalTextElement) {
return;
}

const divRegex = new RegExp(‘]*>’, ‘gi’);
const blockWrapperRegex = new RegExp(‘]*>’, ‘gi’);
const fullAnchorRegex = new RegExp(‘<a.*?', 'g');
const anchorRegex = new RegExp('(.*?)‘);

const template = smsConsentHtmlRenderingFixEnabled
? program.requiredTemplate
.replace(/\s*

]*>/gi, ‘ ‘)
.replace(blockWrapperRegex, ”)
: program.requiredTemplate.replace(divRegex, ”);

legalTextElement.textContent=””;
const parts = template.split(/(.*?)/g);
parts.forEach(function(part) {
if (!part) {
return;
}
const anchorMatch = part.match(/(.*?)/);
if (anchorMatch) {
const linkElement = document.createElement(‘a’);
linkElement.href = sanitizeUrl(anchorMatch[1]);
linkElement.target = sanitizeHtml(anchorMatch[2]);
linkElement.textContent = sanitizeHtml(anchorMatch[3]);
legalTextElement.appendChild(linkElement);
} else {
legalTextElement.appendChild(document.createTextNode(part));
}
});

}

function generateDropdownOptions(smsProgramData) {
if (!smsProgramData || smsProgramData.length === 0) {
return ”;
}

var programs = false
? smsProgramData.filter(function(p, i, arr) {
return arr.findIndex(function(q) { return q.countryCode === p.countryCode; }) === i;
})
: smsProgramData;

return programs.map(program => {
const flag = getCountryUnicodeFlag(program.countryCode);
const countryName = getCountryName(program.countryCode);
const callingCode = program.countryCallingCode || ”;
// Sanitize all values to prevent XSS
const sanitizedCountryCode = sanitizeHtml(program.countryCode || ”);
const sanitizedCountryName = sanitizeHtml(countryName || ”);
const sanitizedCallingCode = sanitizeHtml(callingCode || ”);
return ” + sanitizedCountryName + ‘ ‘ + sanitizedCallingCode + ”;
}).join(”);
}

function getDefaultPlaceholder(countryCode) {
if (!countryCode || typeof countryCode !== 'string') {
return '+1 000 000 0000'; // Default US placeholder
}

var mockPlaceholders = [
{
countryCode: 'US',
placeholder: '+1 000 000 0000',
helpText: 'Include the US country code +1 before the phone number',
},
{
countryCode: 'GB',
placeholder: '+44 0000 000000',
helpText: 'Include the GB country code +44 before the phone number',
},
{
countryCode: 'CA',
placeholder: '+1 000 000 0000',
helpText: 'Include the CA country code +1 before the phone number',
},
{
countryCode: 'AU',
placeholder: '+61 000 000 000',
helpText: 'Include the AU country code +61 before the phone number',
},
{
countryCode: 'DE',
placeholder: '+49 000 0000000',
helpText: 'Fügen Sie vor der Telefonnummer die DE-Ländervorwahl +49 ein',
},
{
countryCode: 'FR',
placeholder: '+33 0 00 00 00 00',
helpText: 'Incluez le code pays FR +33 avant le numéro de téléphone',
},
{
countryCode: 'ES',
placeholder: '+34 000 000 000',
helpText: 'Incluya el código de país ES +34 antes del número de teléfono',
},
{
countryCode: 'NL',
placeholder: '+31 0 00000000',
helpText: 'Voeg de NL-landcode +31 toe vóór het telefoonnummer',
},
{
countryCode: 'BE',
placeholder: '+32 000 00 00 00',
helpText: 'Incluez le code pays BE +32 avant le numéro de téléphone',
},
{
countryCode: 'CH',
placeholder: '+41 00 000 00 00',
helpText: 'Fügen Sie vor der Telefonnummer die CH-Ländervorwahl +41 ein',
},
{
countryCode: 'AT',
placeholder: '+43 000 000 0000',
helpText: 'Fügen Sie vor der Telefonnummer die AT-Ländervorwahl +43 ein',
},
{
countryCode: 'IE',
placeholder: '+353 00 000 0000',
helpText: 'Include the IE country code +353 before the phone number',
},
{
countryCode: 'IT',
placeholder: '+39 000 000 0000',
helpText: 'Includere il prefisso internazionale IT +39 prima del numero di telefono',
},
];

const selectedPlaceholder = mockPlaceholders.find(function(item) {
return item && item.countryCode === countryCode;
});

return selectedPlaceholder ? selectedPlaceholder.placeholder : mockPlaceholders[0].placeholder;
}

function updatePlaceholder(countryCode, fieldName) {
if (!countryCode || !fieldName) {
return;
}

const phoneInput = document.querySelector('#mce-' + fieldName);
if (!phoneInput) {
return;
}

const placeholder = getDefaultPlaceholder(countryCode);
if (placeholder) {
phoneInput.placeholder = placeholder;
}
}

function updateCountryCodeInstruction(countryCode, fieldName) {
updatePlaceholder(countryCode, fieldName);

}

function getDefaultHelpText(countryCode) {
var mockPlaceholders = [
{
countryCode: 'US',
placeholder: '+1 000 000 0000',
helpText: 'Include the US country code +1 before the phone number',
},
{
countryCode: 'GB',
placeholder: '+44 0000 000000',
helpText: 'Include the GB country code +44 before the phone number',
},
{
countryCode: 'CA',
placeholder: '+1 000 000 0000',
helpText: 'Include the CA country code +1 before the phone number',
},
{
countryCode: 'AU',
placeholder: '+61 000 000 000',
helpText: 'Include the AU country code +61 before the phone number',
},
{
countryCode: 'DE',
placeholder: '+49 000 0000000',
helpText: 'Fügen Sie vor der Telefonnummer die DE-Ländervorwahl +49 ein',
},
{
countryCode: 'FR',
placeholder: '+33 0 00 00 00 00',
helpText: 'Incluez le code pays FR +33 avant le numéro de téléphone',
},
{
countryCode: 'ES',
placeholder: '+34 000 000 000',
helpText: 'Incluya el código de país ES +34 antes del número de teléfono',
},
{
countryCode: 'NL',
placeholder: '+31 0 00000000',
helpText: 'Voeg de NL-landcode +31 toe vóór het telefoonnummer',
},
{
countryCode: 'BE',
placeholder: '+32 000 00 00 00',
helpText: 'Incluez le code pays BE +32 avant le numéro de téléphone',
},
{
countryCode: 'CH',
placeholder: '+41 00 000 00 00',
helpText: 'Fügen Sie vor der Telefonnummer die CH-Ländervorwahl +41 ein',
},
{
countryCode: 'AT',
placeholder: '+43 000 000 0000',
helpText: 'Fügen Sie vor der Telefonnummer die AT-Ländervorwahl +43 ein',
},
{
countryCode: 'IE',
placeholder: '+353 00 000 0000',
helpText: 'Include the IE country code +353 before the phone number',
},
{
countryCode: 'IT',
placeholder: '+39 000 000 0000',
helpText: 'Includere il prefisso internazionale IT +39 prima del numero di telefono',
},
];

if (!countryCode || typeof countryCode !== 'string') {
return mockPlaceholders[0].helpText;
}

const selectedHelpText = mockPlaceholders.find(function(item) {
return item && item.countryCode === countryCode;
});

return selectedHelpText ? selectedHelpText.helpText : mockPlaceholders[0].helpText;
}

function setDefaultHelpText(countryCode) {
const helpTextSpan = document.querySelector('#help-text');
if (!helpTextSpan) {
return;
}

}

function updateHelpTextCountryCode(countryCode, fieldName) {
if (!countryCode || !fieldName) {
return;
}

setDefaultHelpText(countryCode);
}

function initializeSmsPhoneDropdown(fieldName) {
if (!fieldName || typeof fieldName !== 'string') {
return;
}

const dropdown = document.querySelector('#country-select-' + fieldName);
const displayFlag = document.querySelector('#flag-display-' + fieldName);

if (!dropdown || !displayFlag) {
return;
}

const smsPhoneData = window.MC?.smsPhoneData;
if (smsPhoneData && smsPhoneData.programs && Array.isArray(smsPhoneData.programs)) {
dropdown.innerHTML = generateDropdownOptions(smsPhoneData.programs);
}

const defaultProgram = getDefaultCountryProgram(smsPhoneData?.defaultCountryCode, smsPhoneData?.programs);
if (defaultProgram && defaultProgram.countryCode) {
dropdown.value = defaultProgram.countryCode;

const flagSpan = displayFlag?.querySelector('#flag-emoji-' + fieldName);
if (flagSpan) {
flagSpan.textContent = getCountryUnicodeFlag(defaultProgram.countryCode);
flagSpan.setAttribute('aria-label', sanitizeHtml(defaultProgram.countryCode) + ' flag');
}

updateSmsLegalText(defaultProgram.countryCode, fieldName);
updatePlaceholder(defaultProgram.countryCode, fieldName);
updateCountryCodeInstruction(defaultProgram.countryCode, fieldName);
}

var phoneInput = document.querySelector('#mce-' + fieldName);
if (phoneInput && defaultProgram.countryCallingCode && shouldAppendCountryCode) {
phoneInput.value = defaultProgram.countryCallingCode;
}

displayFlag?.addEventListener('click', function(e) {
dropdown.focus();
});

dropdown?.addEventListener('change', function() {
const selectedCountry = this.value;

if (!selectedCountry || typeof selectedCountry !== 'string') {
return;
}

const flagSpan = displayFlag?.querySelector('#flag-emoji-' + fieldName);
if (flagSpan) {
flagSpan.textContent = getCountryUnicodeFlag(selectedCountry);
flagSpan.setAttribute('aria-label', sanitizeHtml(selectedCountry) + ' flag');
}

const selectedProgram = window.MC?.smsPhoneData?.programs.find(function(program) {
return program && program.countryCode === selectedCountry;
});

var phoneInput = document.querySelector('#mce-' + fieldName);
if (phoneInput && selectedProgram.countryCallingCode && shouldAppendCountryCode) {
phoneInput.value = selectedProgram.countryCallingCode;
}

updateSmsLegalText(selectedCountry, fieldName);
updatePlaceholder(selectedCountry, fieldName);
updateCountryCodeInstruction(selectedCountry, fieldName);
});
}

document.addEventListener('DOMContentLoaded', function() {
const smsPhoneFields = document.querySelectorAll('[id^="country-select-"]');

smsPhoneFields.forEach(function(dropdown) {
const fieldName = dropdown?.id.replace('country-select-', '');
initializeSmsPhoneDropdown(fieldName);
});
});

Put accessibility into the bid-to-delivery workflow

The best time to fix a PDF is before it becomes a PDF.

Ask about accessibility during the bid or discovery process. Which standard does the buyer expect? What file types will your company provide? Does the buyer require test results, an accessibility statement or a particular review process? Who decides whether a deliverable is accepted?

Once production begins, use an accessible source template. Set up real heading styles, simple tables, clear link text and image descriptions while the content is being written. Exporting first and repairing everything afterward usually creates more work.

If several teams create or update files, a shared document accessibility workflow for public-sector deliverables can keep the source, checking, remediation and approval steps from falling to different owners.

The process itself can stay small:

Scope the files. Agree on which documents are included and what the buyer expects.
Create from an accessible source. Give writers and designers templates that already contain the right structure.
Test before delivery. Combine automated checks with manual review, then save the results the contract calls for.
Maintain the work. Keep the source file, name the person responsible for fixes and retest after meaningful changes.

Recurring reports need extra care. Testing the template once is a reasonable start, but generated data can alter page breaks, table structures and reading order. Sample the finished output as well.

The same rule applies when subcontractors produce part of the content. Tell them which requirements apply, who reviews their files and what happens when a document needs to be corrected. Otherwise, the accessibility gap may sit inside a handoff that everyone assumed somebody else owned.

When existing files need remediation

Some documents can be fixed at the source and exported again. That’s usually the cleanest route because it leaves the company with an editable file that can support future revisions.

Others need direct PDF remediation. This may involve adding or correcting tags, headings, table structure, reading order, alternative text, form labels, bookmarks and document properties.

Don’t assume that publishing an accessible alternative beside a broken file solves the problem. DOJ guidance limits when conforming alternate versions can be used instead of making the primary content accessible.

For a large archive, start with the documents people currently depend on. A benefits application used every day deserves attention before an old event flyer that nobody opens. Keep a queue for the rest, record what has been tested and check repaired files again after later edits.

Use the extra time before the RFP forces the issue

Pick one public-sector customer or target account. List the five files most likely to reach the public, ask what the buyer expects and manually test one of them this week.

You may find that the files are in good shape. You may find a form that nobody can complete without a mouse or a report that sounds like word salad through a screen reader. Either result is useful now.

It’s much less useful when the contract is waiting for a signature.

Image by pressfoto on Magnific

The post Selling to Government? Your PDFs May Be Part of the Accessibility Test appeared first on StartupNation.

Selling to Government? Your PDFs May Be Part of the Accessibility Test

Build Your Business. Get Grant Ready.

Take free expert-led courses and unlock access to tools, mentorship, networking, and Verizon grant opportunities for small businesses.

Get Grant Ready

We earn a commission if you make a purchase, at no additional cost to you.

Why a vendor’s documents can enter the accessibility review

Find the PDFs attached to the service

A PDF can look fine and still fail a real user

Sign Up for The Start Newsletter

Put accessibility into the bid-to-delivery workflow

When existing files need remediation

Use the extra time before the RFP forces the issue

7 Best Places to Buy Bulk Craft Supplies Online

5 Essential Retail Content Marketing Strategies

How to Build a Billion-Dollar Office Culture in a Ten-Dollar Office Space

Key Strategies for Successful B to B Selling

7 Retail Analytics Platforms to Boost Business Insights

Leading Automated Demo Solutions for SaaS Companies

Leave a Reply Cancel reply

Pages

Build Your Business. Get Grant Ready. Take free expert-led courses and unlock access to tools, mentorship, networking, and Verizon grant opportunities for small businesses. Get Grant Ready We earn a commission if you make a purchase, at no additional cost to you.

Why a vendor’s documents can enter the accessibility review

Find the PDFs attached to the service

A PDF can look fine and still fail a real user

Sign Up for The Start Newsletter

Put accessibility into the bid-to-delivery workflow

When existing files need remediation

Use the extra time before the RFP forces the issue

Similar Posts

Leave a Reply Cancel reply

Pages

Build Your Business. Get Grant Ready.

Take free expert-led courses and unlock access to tools, mentorship, networking, and Verizon grant opportunities for small businesses.

Get Grant Ready

We earn a commission if you make a purchase, at no additional cost to you.