Article

Required access

unauthenticated_read_content access scope

Show definition
type Article implements Node {
  # Globally unique identifier.
  id: ID!

  # The article's author.
  author: ArticleAuthor!

  # The blog that the article belongs to.
  blog: Blog!

  # List of comments posted on the article.
  comments(
    # Returns up to the first `n` elements from the list.
    first: Int

    # Returns the elements that come after the specified cursor.
    after: String

    # Returns up to the last `n` elements from the list.
    last: Int

    # Returns the elements that come before the specified cursor.
    before: String

    # Reverse the order of the underlying list.
    reverse: Boolean = false
  ): CommentConnection!

  # Stripped content of the article, single line with HTML tags removed.
  content(
    # Truncates string after the given length.
    truncateAt: Int
  ): String!

  # The content of the article, complete with HTML formatting.
  contentHtml: HTML!

  # Stripped excerpt of the article, single line with HTML tags removed.
  excerpt(
    # Truncates string after the given length.
    truncateAt: Int
  ): String

  # The excerpt of the article, complete with HTML formatting.
  excerptHtml: HTML

  # A human-friendly unique string for the Article automatically generated from its title.
  handle: String!

  # The image associated with the article.
  image(
    # Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead.
    maxWidth: Int

    # Image height in pixels between 1 and 2048. This argument is deprecated: Use
    # `maxHeight` on `Image.transformedSrc` instead.
    maxHeight: Int

    # Crops the image according to the specified region. This argument is
    # deprecated: Use `crop` on `Image.transformedSrc` instead.
    crop: CropRegion

    # Image size multiplier for high-resolution retina displays. Must be between 1
    # and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead.
    scale: Int = 1
  ): Image

  # The date and time when the article was published.
  publishedAt: DateTime!

  # A categorization that a article can be tagged with.
  tags: [String!]!

  # The article’s name.
  title: String!

  # The url pointing to the article accessible from the web.
  url: URL!
}

Implements

Connections

comments   (CommentConnection!)

List of comments posted on the article.

Argument Type Default Description
after

String

Returns the elements that come after the specified cursor.

before

String

Returns the elements that come before the specified cursor.

first

Int

Returns up to the first n elements from the list.

last

Int

Returns up to the last n elements from the list.

reverse

Boolean

false

Reverse the order of the underlying list.

Fields

author   (ArticleAuthor!)

The article's author.

blog   (Blog!)

The blog that the article belongs to.

content   (String!)

Stripped content of the article, single line with HTML tags removed.

Argument Type Default Description
truncateAt

Int

Truncates string after the given length.

contentHtml   (HTML!)

The content of the article, complete with HTML formatting.

excerpt   (String)

Stripped excerpt of the article, single line with HTML tags removed.

Argument Type Default Description
truncateAt

Int

Truncates string after the given length.

excerptHtml   (HTML)

The excerpt of the article, complete with HTML formatting.

handle   (String!)

A human-friendly unique string for the Article automatically generated from its title.

id   (ID!)

Globally unique identifier.

image   (Image)

The image associated with the article.

Argument Type Default Description
crop

CropRegion

Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.

maxHeight

Int

Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.

maxWidth

Int

Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.

scale

Int

1

Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.

publishedAt   (DateTime!)

The date and time when the article was published.

tags   ([String!]!)

A categorization that a article can be tagged with.

title   (String!)

The article’s name.

url   (URL!)

The url pointing to the article accessible from the web.

Sign up for a Partner account to get started.

Sign up