> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> These docs contain multiple Speckle product experiences. For Speckle 2026.9, prefer /next/ pages for the topics and changes they cover. The navigation label Current does not override this version-specific precedence.
> Coverage under /next/ is incremental. Use Current documentation for unchanged topics and when a /next/ page says coverage is unavailable or explicitly refers you to Current. Do not infer a feature was removed from a missing page.
> Read the page-specific documentation status, applicability, affected guidance and replacement links in agent-only content. Impacted, changed and superseded apply only to the stated scope; they do not mean the entire feature is deprecated. Historical connector guides apply only to the legacy connector described.
> Match guidance to the customer's deployment version, model data format and connector. Respect plan, permission and compatibility restrictions. If an unknown version or data format changes the answer, ask a focused clarification; do not infer deployment version from the date alone.
# How to use Speckle for Civil 3D
> Step-by-step guide for using the Civil 3D connector
export const app_4 = "Civil 3D"
export const app_3 = "Civil 3D"
export const app_2 = "Civil 3D"
export const app_1 = "Civil 3D"
export const app_0 = "Civil 3D"
export const versions_0 = "2023, 2024, 2025, 2026, & 2027"
export const os_0 = "Windows"
Speckle currently supports {app_0} versions: **{versions_0}**. The {app_0} connector works on **{os_0}**
only.
**2022 support has ended.** If you use Civil 3D 2022, use connector version 3.21.0 or upgrade
Civil 3D to a supported version. For more context, see [this forum
post](https://speckle.community/t/adsk-2022-support-ending-with-the-release-of-2027-connectors/22094).
## Setup
Install your [{app_1} connector](/connectors/installation)
1. In Civil 3D, select the **Speckle** tab in the ribbon.
2. Select **Speckle** to open the Civil 3D connector.
3) Select **Sign in** if you haven't linked your Speckle account.
1. Make sure your version of {app_2} is one of the supported versions.
2. Uninstall and [reinstall your connector](/connectors/installation).
Don't select **Run as administrator** when installing: that installs the connector for the
administrator account, not yours. Double-click the `.exe`, or right-click it and select **Open**.
Installation issues can also be caused by conflicting plugins.
If you're still experiencing problems, report it in our [Community Forum](https://speckle.community/c/help) and include:
* Your application version
* Your Speckle connector version
If your connector window is floating, **try docking it to your application** to fix blank UI
issues. For major issues, you can sometimes find a `log` file in your directory at
`AppData\Roaming\Speckle\Logs`. Report your problem in our [Community
Forum](https://speckle.community/c/help) and include your application version, your Speckle
connector version, and a copy of the log.
Signing in opens a browser page for your Speckle server. If it doesn't open, or it never returns
you to the connector, check that you can reach your server in your browser, update the connector
to the latest version, and try again.
Older connector versions sign in through Speckle Desktop Services, which is deprecated. Update the
connector to the latest version. If you must stay on the older version, search for **Speckle
Desktop Services** in Windows search and run it before signing in.
All Speckle connectors are installed like any other program. You can uninstall them directly from
your system's `Applications`. For a full uninstall, also remove **Speckle Desktop Services** if it
is installed.
You can always download the latest version of the connector [in the web
app](https://app.speckle.systems/connectors). If a new version of the connector is available, you
will also see a notification in your connector UI.
## Publishing a Model
* Select an existing project - or select **New Project** to create one
* Select an existing model - or select **New Model** to create one
1. In your application viewport, select the elements you want to publish.
2. Select **Publish**.
3. Your model is now published to Speckle and is available to the rest of your team.
All visible types of objects supported by AutoCAD can be published from Civil 3D: `Geometry` , `Hatch`, `Text`, and `Blocks`. In addition to AutoCAD elements, any civil entity can be published as a `CivilObject` as well, and will contain:
* type
* base curve (if any)
* children elements (e.g. corridor baselines)
* custom properties
* color
* render material
Solids will only be published as `Mesh` geometry.
All custom properties can be found under the `properties` field when you select and view a Civil 3D object in your browser.Custom properties vary depending on the type of civil element, and can include:
* extension dictionary
* property set
* Network part: part data
* Catchment: hydrological and hydraulic props
* Surface: statistics
* Corridor: featurelines and codes
* and more
Use the reference point options in your connected workflow (including cloud sync flows that support reference point
input) to align placement with other models. Confirm your project coordinate strategy before publishing to avoid
repeated offset corrections.
New model creation defaults to the current file name so you can publish faster without cleaning up a full file path.
You can still edit the model name before publishing.
In the viewer, select the **View Modes** button in the side bar, and switch the view mode to
**Shaded**. If you still don't see your object colors, let us know in our [Community
Forum](https://speckle.community/c/help)
**Image texture files are not supported.** Speckle does **not** transfer bitmaps or other image maps (such as JPG or PNG files) embedded in materials from the source application.
Speckle **does** carry [PBR-style material data](/developers/sdks/python/guides/understanding-speckle-mesh#render-materials) in general—where a connector maps to it, materials can include properties such as base colour, opacity, metalness, roughness, and emissive colour. That is not the same as shipping texture images: you get numeric material parameters, not image assets used for wood grain, brick patterns, and similar in the authoring tool.
Different materials can still appear separately in the destination with distinct colours and PBR fields. What you see may look closer to a consistent shaded or PBR preview than to the full render-appearance with image maps in tools such as Revit or SketchUp. To use image textures in your target application, apply or remap them locally after you publish or load.
After you publish a Speckle model, click on the **Report** button to see any errors that may have
occurred. Click on any item in the report to highlight that item in your application. Some objects
may not be supported for publishing.
## Loading a Model
* Latest version is always first.
* To load a specific version, select it from the UI.
Your selected model is now loaded in {app_3}.
All objects in Speckle models are loaded as `geometry`, `text`, or `blocks` in Civil 3D. They will be created in a flattened layer structure as what you see when viewing your model in your browser. Each object will be loaded with:
* render material (if any)
* color (if any)
Speckle models are loaded into their own `Selection Set`. You can use this to easily select all layers created by your loaded model.
After you load a Speckle model, click on the **Report** button to see any errors that may have
occurred. Click on any item in the report to highlight that item in your application. Some objects
may not be supported for loading in {app_4}.
**Image texture files are not supported.** Speckle does **not** transfer bitmaps or other image maps (such as JPG or PNG files) embedded in materials from the source application.
Speckle **does** carry [PBR-style material data](/developers/sdks/python/guides/understanding-speckle-mesh#render-materials) in general—where a connector maps to it, materials can include properties such as base colour, opacity, metalness, roughness, and emissive colour. That is not the same as shipping texture images: you get numeric material parameters, not image assets used for wood grain, brick patterns, and similar in the authoring tool.
Different materials can still appear separately in the destination with distinct colours and PBR fields. What you see may look closer to a consistent shaded or PBR preview than to the full render-appearance with image maps in tools such as Revit or SketchUp. To use image textures in your target application, apply or remap them locally after you publish or load.
This happens when you don't have permissions to load a project. Contact the project owner to
change your role.
Yes. Next to the search box in the project selection dialog, there's an **Add model by URL**
option. Paste the model URL there.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.