djangocms-form-builder-countries is a plugin extension for djangocms-form-builder that adds a country selector field to the form builder.
It integrates django-countries with the Django CMS Form Builder, providing a dropdown field with all ISO 3166-1 countries and localized country names.
Key Features
Country dropdown field for djangocms-form-builder forms
All ISO 3166-1 countries with localized names
Configurable “countries first” option to prioritize specific countries (e.g., DACH region: Germany, Austria, Switzerland)
Full integration with form builder validation and submission system
Bootstrap 5 compatible styling
Works with djangocms-form-builder’s XHR-based form submission
Installation
Install the package via pip:
pip install djangocms-form-builder-countries
Or with your preferred package manager.
Configuration
Add the package to your INSTALLED_APPS:
INSTALLED_APPS = [
...
'django_countries',
'djangocms_form_builder_countries',
...
]
No migrations are required as the plugin uses a proxy model.
Usage
After installation, a new “Country” field type will be available in the Django CMS Form Builder structure board under the “Forms” module.
Adding a Country Field
Create or edit a form in the Django CMS structure board
Add a new plugin to the form
Select “Country” from the “Forms” module
Configure the field:
Field Label: The label shown to users
Field Name: The internal field name for form processing
Required: Whether the field is mandatory
Placeholder: Text shown when no country is selected
Optionally configure “Countries First” to show specific countries at the top of the dropdown
Countries First Feature
The “Countries First” option allows you to prioritize specific countries at the top of the dropdown list. This is useful for forms targeting specific regions.
For example, for a form targeting the DACH region, you can select:
Germany (DE)
Austria (AT)
Switzerland (CH)
These countries will appear at the top of the list, followed by a separator and all other countries in alphabetical order.
Requirements
Python 3.9+
Django 4.2+
django-cms 4.1+
djangocms-form-builder 2.0+
django-countries 7.0+
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
1 maintainer
Metadata
1 maintainer
Release files for djangocms-form-builder-countries 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| djangocms_form_builder_countries-0.1.0.tar.gz | 10.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| djangocms_form_builder_countries-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.7 kB
Release files / djangocms_form_builder_countries-0.1.0.tar.gz
| Download URL | djangocms_form_builder_countries-0.1.0.tar.gz |
|---|---|
| Size | 10.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4aaeccbf255b9bfb59c4f652ae4466d2a97a3c3ee0f3db83294a511ad2b04bf8
|
|
BLAKE2b-256 checksum How to use checksums |
e42527272e08ea311b913f0d1381d112f02445f3d097bc3496f06cb4f0f3c33a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 1, 2025.
Transparency logRelease files / djangocms_form_builder_countries-0.1.0-py3-none-any.whl
| Download URL | djangocms_form_builder_countries-0.1.0-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
196ec74b735eca964c3c5659bd7fe7e229955dc059b97cd4f3c83a91a2e48143
|
|
BLAKE2b-256 checksum How to use checksums |
520a3583a8460d422dc7e5ce50e9588c8a08d1642828e948ef97ddff2463d7ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 1, 2025.
Transparency log
