> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dev.to Settings

> Provider settings for Dev.to articles

Creating the OAuth app and connecting a channel: [Dev.to setup guide](/providers/devto).

## Overview

Dev.to is a community platform for developers. When posting articles, you can set the title, the cover image and tags, plus the organization you publish under.

## Settings Schema

```json theme={"system"}
{
  "__type": "devto",
  "title": "Article Title",
  "main_image": {
    "id": "image-id",
    "path": "https://uploads.postqueen.ai/cover.jpg"
  },
  "canonical": "https://original-url.com/article",
  "organization": "org-id",
  "tags": [
    { "value": 6, "label": "javascript" }
  ]
}
```

## Properties

| Property          | Type   | Required | Description                                                                             |
| ----------------- | ------ | -------- | --------------------------------------------------------------------------------------- |
| `__type`          | string | ✅        | Must be `"devto"`                                                                       |
| `title`           | string | ✅        | Article title (min 2 chars)                                                             |
| `main_image`      | object | ❌        | Cover image                                                                             |
| `main_image.id`   | string | ✅        | Image ID                                                                                |
| `main_image.path` | string | ✅        | Image URL                                                                               |
| `canonical`       | string | ❌        | Original URL for SEO                                                                    |
| `organization`    | string | ❌        | Organization ID                                                                         |
| `tags`            | array  | ❌        | Up to 4 tags                                                                            |
| `tags[].value`    | number | ✅        | Numeric Dev.to tag id. Get it from the `tags` provider tool; a tag name here is refused |
| `tags[].label`    | string | ✅        | Tag display name                                                                        |

## Example

````json theme={"system"}
{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-devto-integration-id"
      },
      "value": [
        {
          "content": "# Getting Started\n\nIn this tutorial, we'll explore...\n\n```javascript\nconst hello = 'world';\nconsole.log(hello);\n```\n\n## Conclusion\n\nThanks for reading!",
          "image": []
        }
      ],
      "settings": {
        "__type": "devto",
        "title": "10 JavaScript Tips for Better Code",
        "tags": [
          { "value": 6, "label": "javascript" },
          { "value": 24, "label": "webdev" },
          { "value": 122, "label": "tutorial" },
          { "value": 73, "label": "beginners" }
        ]
      }
    }
  ]
}
````

## Notes

* Article content supports Markdown with code blocks
* Maximum of 4 tags allowed
* Tags should be lowercase and match Dev.to's existing tags
* If posting under an organization, give the `organization` ID